Apple Maps Search API

Endpoint facts

Method

GET

API path

/apple-maps/search

Auth

apiKey

Credits

3 credits/request

Charged on

Successful 2xx responses only

Platform

Apple Maps

Response schema

#/definitions/applemaps.searchResponseDoc

How this endpoint behaves

Each result's place_id (or numeric id) is the value /apple-maps/place takes.

Query parameters:

• query (required) — keyword, business name, category, or street address, e.g. coffee, Sightglass Coffee, 1 Infinite Loop Cupertino.
• latitude (required) — search center latitude, e.g. 37.7749.
• longitude (required) — search center longitude, e.g. -122.4194.
• span (optional) — search viewport size in degrees of latitude/longitude around the center. Defaults to 0.05 (roughly a 5km box); minimum 0.001, maximum 5. Apple returns a bounded set per viewport (around 25 places at the default span, around 55 at 2), so a larger span returns more, but not proportionally more, places.
• limit (optional) — max places returned. Defaults to 25, maximum 100.
• lang (optional) — display language as a BCP 47 tag, e.g. en-US, ja-JP, de-DE. Defaults to en-US. Names, categories, and addresses follow it.
• country (optional) — two-letter ISO 3166-1 code selecting Apple's regional catalog, e.g. US, JP. Defaults to US.
• filters (optional) — comma-separated filter keys to apply, e.g. OPEN_NOW,modern_pizza_restaurant. Keys come from the filters block of an unfiltered search for the same query and area (Apple's chip bar: OPEN_NOW, TOP_RATED, FEATURED_IN_GUIDES, price bands such as PRICE_RANGE_INEXPENSIVE/PRICE_RANGE_MODERATE/PRICE_RANGE_EXPENSIVE/PRICE_RANGE_VERY_EXPENSIVE, cuisine keys such as modern_pizza_restaurant, amenity keys such as ACCEPTS_CREDIT_CARDS, accolade keys such as ACCOLADES_MICHELIN_ONE_STAR). The available set depends on the query and area. An unknown key returns a 400 that lists the keys available for that search. At most 20 keys. Applying filters costs a second upstream search.
• sort (optional) — result order: best_match (default), distance, or ratings. Costs a second upstream search.

There is no pagination: move the center or widen span to cover more area. total_found is the count Apple reports for the viewport; total_results is the number returned after limit.

When nothing matches near the center, Apple may relocate the search to a default region instead of returning an empty list. region is the bounding box the results actually came from and relocated is true when that box does not contain the requested center; treat such results as not local to the request.

A query Apple has no results for at all returns an empty places list, not an error.

type is the place kind: BUSINESS, AOI (area of interest, e.g. a neighborhood), ADDRESS, STREET, or another Apple entity type. hours_type is NORMAL, SPECIAL, TEMPORARY_CLOSURE, or PERMANENT_CLOSURE. hours[] lists one entry per weekday per opening interval, in the place's local time.

filters[] describes the refinement chips Apple offers for this search: each group has name, type (toggle, multi_select, or sort), match (any or all, multi-select groups only), and options[] with key (the value to pass in filters, or in sort for the sort group), name, and selected. Multi-select groups with match: any (cuisines, prices, accolades) return places matching any selected option; match: all groups (amenities) require every selected option.

When Apple Guides cover the query and area (e.g. a coffee guide alongside coffee shops), guides[] lists them with the same summary shape as /apple-maps/guides (id, url, title, description, photo_url, publisher); pass an id to /apple-maps/guides/guide.

Response includes query, total_found, total_results, region (south, west, north, east), relocated, filters[], places[], and guides[]. Each place has id, place_id, url, name, type, category, categories[] (id, name, level), latitude, longitude, address, address_info (street, neighborhood, city, county, state, state_code, postal_code, country, country_code), phone, alt_phones[], website, rating, rating_max, rating_count, price_level, price_max, price_symbol, hours_type, hours[] (day, open, close), and photo_url. Fields Apple has no value for are omitted.

Live monitoring

Monitored request

GET /apple-maps/search?latitude=37.7749&longitude=-122.4194&query=coffee

Checks passed, 7 days to 14 Oct 2026

99.9%

Median response time

4.18 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /apple-maps/search?latitude=37.7749&limit=25&longitude=-122.4194&query=coffee

Items in places

25

Fields filled in every checked item

14

Fields empty in some or all items

9

Shared guides

Related