GET/apple-maps/autocompleteapiKey1 credit/request
Returns Apple Maps typeahead suggestions for a partial query near a coordinate: query completions, matching businesses (resolved to the same place summary the search endpoint returns, with the place ID the place endpoint takes), and addresses.
Required: query, latitude, longitude. Optional: span, lang, country.
Sampled 14 Oct 2026: 8 items. Filled in every item: type, text, detail. Not in every item: query (2), place_id (6), id (6), latitude (6), longitude (6), place (6). In the sample: type: business (6), query (2); detail: “Search Nearby” and 7 other values; query: “Blue Bottle Coffee”.
Open in Playground
GET/apple-maps/categoriesapiKey1 credit/request
Returns the "Find Nearby" browse categories Apple Maps offers for an area (for example Restaurants, Coffee Shops, Gas Stations, Hotels, Parking, Grocery Stores), each with the key and name the category-search endpoint takes. The set is location-aware.
Required: latitude, longitude. Optional: span, lang, country.
Sampled 14 Oct 2026: 8 items. Filled in every item: key, name. In the sample: name: “Restaurants” and 7 other values.
Open in Playground
GET/apple-maps/category-searchapiKey3 credits/request
Returns places in one browse category near a coordinate without a keyword, in the same shape as the search endpoint (place summaries, region, relocation flag, and the refinement filters block). The category is a name from the categories endpoint for the same area (case-insensitive) or its key; an unknown name returns 400 listing the categories available there. Filters and sort work exactly as on the search endpoint.
Required: category, latitude, longitude. Optional: span, limit, lang, country, filters, sort (3 allowed values: best_match, distance, ratings).
Sampled 14 Oct 2026: 25 items. Filled in every item: id, place_id, url, name, type, category, categories, latitude and 6 more. Not in every item: phone (24), alt_phones (9), website (24), rating (13), rating_max (13), rating_count (13), price_level (5), price_max (5) and 1 more. In the sample: category: Coffee Shop (19), Coffee Roastery (2), Cafe (1) and 3 more; rating: 3.3 to 4.63, median 4.3; name: “Sightglass Coffee” and 22 other values; url: maps.apple.com; categories: median 5 entries; alt_phones: median 1 entry; website: sightglasscoffee.com and 21 other hosts; hours: median 7 entries.
Open in Playground
GET/apple-maps/directionsapiKey2 credits/request
Returns Apple Maps routes between an origin and a destination, with optional intermediate stops, for driving, walking, or cycling. Each route carries its name, whether it is Apple's main or an alternate route, distance, live/historic/free-flow durations, toll and highway flags, Apple's route description and traffic note, and per-leg turn-by-turn steps (maneuver, road, shield, instruction text, distance, duration); detail=full adds each leg's path as coordinates. Departure time and avoid-tolls/highways/stairs preferences are supported. Transit routing is not available.
Required: origin_latitude, origin_longitude, destination_latitude, destination_longitude. Optional: via, mode (3 allowed values: driving, walking, cycling), avoid_tolls, avoid_highways, avoid_stairs, depart_at, detail (3 allowed values: summary, steps, full), lang, country.
Sampled 14 Oct 2026: 3 items. Filled in every item: name, type, transport, traffic, distance_meters, duration_seconds, duration_historic_seconds, duration_freeflow_seconds and 3 more. Not in every item: description (2). In the sample: distance_meters: 9,992 to 11,354, median 10,050; name: “Franklin St” and 2 other values; avoids_tolls: true in 3 of 3; legs: median 1 entry; type: “main” and 1 other value; transport: “driving”; description: “Fastest” and 1 other value; traffic: “Traffic is moderate.”.
Open in Playground
GET/apple-maps/etaapiKey1 credit/request
Returns Apple Maps travel-time estimates between an origin and a destination: for each transport type Apple reports (driving always; walking when requested), the live best estimate, the historic and free-flow durations, and the route distance. Cheaper than the directions endpoint when only the time and distance are needed. Apple has no cycling ETA; use the directions endpoint for cycling.
Required: origin_latitude, origin_longitude, destination_latitude, destination_longitude. Optional: mode (2 allowed values: driving, walking), country.
Sampled 14 Oct 2026: 1 item. Filled in every item: transport, duration_seconds, duration_historic_seconds, duration_static_seconds, distance_meters. In the sample: transport: “driving”.
Open in Playground
GET/apple-maps/guidesapiKey1 credit/request
Returns the Apple Guides home page for the Worldwide scope or one city: the featured guide, the guide carousels (expert recommendations, latest, and similar rows), the city shortcut list, and the browse-by-publisher list. Each guide carries its id (the value the guide endpoint takes), title, description, last-modified time, place count, cover photo, source link, and publisher; each publisher carries its id, name, subtitle, website, and guide count.
Optional: city_id, lang, country.
Sampled 14 Oct 2026: 1 item. Filled in every item: id, url, title, description, last_modified, item_total, photo_url, source_url and 1 more. In the sample: last_modified: 2023-07-20; title: “The best things to do in San Francisco”; url: maps.apple.com; description: median 106 characters; photo_url: is1-ssl.mzstatic.com; source_url: timeout.com.
Open in Playground
GET/apple-maps/guides/citiesapiKey1 credit/request
Returns the Apple Guides city picker: every region (North America, Europe, Australia, and any Apple adds) with the cities it publishes guides for, each with its id, country, coordinates, and cover photo. Pass a city id to the guides home, publishers, or publisher endpoints to scope them to that city; omit it for the Worldwide scope.
Optional: lang, country.
Sampled 14 Oct 2026: 3 items. Filled in every item: name, cities. In the sample: name: “North America” and 2 other values; cities: median 2 entries.
Open in Playground
GET/apple-maps/guides/guideapiKey1 credit/request
Returns one Apple Guide (curated collection) by id: title, description, last-modified time, cover photos, source link, publisher, and every place in the guide with the publisher's blurb for it plus the place's Apple place ID, name, category, coordinates, address, phone, website, rating, price level, hours, and photo.
Required: guide_id. Optional: lang, country.
Sampled 14 Oct 2026: 11 items. Filled in every item: place, description, photo_url. In the sample: photo_url: is1-ssl.mzstatic.com; description: median 268 characters.
Open in Playground
GET/apple-maps/guides/lookupapiKey1 credit/request
Returns guide summaries (id, title, description, last-modified time, place count, cover photo, source link) for up to 20 guide ids in one call, for example the guide_ids a place carries. Ids Apple does not return are listed in not_found. Publisher details are not part of this lookup; use the guide endpoint for a single guide's publisher and places.
Required: guide_ids. Optional: lang, country.
Sampled 14 Oct 2026: 2 items. Filled in every item: id, url, title, description, last_modified, item_total, photo_url. In the sample: last_modified: 2026-09-30 to 2026-10-08; item_total: 11 to 25, median 11; title: “The San Francisco Coffee Guide” and 1 other value; url: maps.apple.com; description: “The Bay Area's legendary coffee scene needs no introduction…” and 1 other value; photo_url: is1-ssl.mzstatic.com.
Open in Playground
GET/apple-maps/guides/nearbyapiKey2 credits/request
Returns the guides Apple suggests for the area around a coordinate ("Guides We Love" for that location) as guide summaries, plus the Apple Guides city the area belongs to (with the city id the guides home endpoint takes). A coordinate outside any guides city returns an empty list.
Required: latitude, longitude. Optional: span, lang, country.
Sampled 14 Oct 2026: 6 items. Filled in every item: id, url, title, description, last_modified, item_total, photo_url. In the sample: last_modified: 2023-07-20 to 2026-10-08; item_total: 5 to 172, median 15; title: “The best things to do in San Francisco” and 5 other values; url: maps.apple.com; description: median 106 characters; photo_url: is1-ssl.mzstatic.com.
Open in Playground
GET/apple-maps/guides/publisherapiKey1 credit/request
Returns one Apple Guides publisher by id: name, subtitle, website, guide count, the cities the publisher offers as filters, and its guides (each with id, title, description, last-modified time, place count, cover photo, and source link). Pass one of the publisher's own city ids as city_id to return only the guides for that city.
Required: publisher_id. Optional: city_id, lang, country.
Sampled 14 Oct 2026: 19 items. Filled in every item: id, url, item_total, publisher. Not in every item: title (10), description (10), last_modified (10), photo_url (10). In the sample: last_modified: 2021-07-28 to 2026-09-30; item_total: 0 to 18, median 4; title: “The Milwaukee Coffee Guide” and 9 other values; url: maps.apple.com; description: median 239 characters; photo_url: is1-ssl.mzstatic.com.
Open in Playground
GET/apple-maps/guides/publishersapiKey1 credit/request
Returns the Apple Guides "Browse by Publisher" list for the Worldwide scope or one city, sorted by name: each publisher's id (the value the publisher endpoint takes), name, subtitle, website, and number of guides. With no city_id this is the complete enumeration of every publisher Apple lists, usable as the id lookup table for the publisher endpoint.
Optional: city_id, lang, country.
Sampled 14 Oct 2026: 91 items. Filled in every item: id, url, name, guide_count. Not in every item: subtitle (83), website (87). In the sample: guide_count: 1 to 997, median 14; name: “5280 Magazine” and 90 other values; url: maps.apple.com; subtitle: “Denver's Mile High Magazine” and 82 other values; website: 5280.com and 86 other hosts.
Open in Playground
GET/apple-maps/placeapiKey1 credit/request
Returns one Apple Maps place by its place ID: name, type, category taxonomy, coordinates, formatted and structured address, phone numbers, website, rating and review count, price level, weekly opening hours, amenities (payment, accessibility, parking, and similar yes/no attributes), photos, review snippets (text, rating, time, and source link, without reviewer identity), the business-claim link, and the IDs of Apple Guides that include the place. Accepts either the external place ID (starts with I, the place-id= value in a maps.apple.com/place URL) or the numeric ID from a search result.
Required: place_id. Optional: lang, country.
Sampled 14 Oct 2026: 19 items. Filled in every item: id, url, width, height, category. In the sample: category: Food & Drink (10), Atmosphere (9); url: ir.4sqi.net and 2 other hosts.
Open in Playground
GET/apple-maps/place/photosapiKey1 credit/request
Returns all of a place's photos (the place endpoint caps at 20): the business cover photo first when present, then the hero photo, then every categorized photo with its category (Food & Drink, Interior, Exterior, ...), width and height.
Required: place_id. Optional: lang, country.
Sampled 14 Oct 2026: 19 items. Filled in every item: id, url, width, height, category. In the sample: category: Food & Drink (10), Atmosphere (9); url: ir.4sqi.net and 2 other hosts.
Open in Playground
GET/apple-maps/placesapiKey2 credits/request
Returns the same full detail as the place endpoint for up to 20 place IDs in a single upstream call, plus the list of requested IDs Apple did not return. Accepts the external I... form and the numeric id interchangeably.
Required: place_ids. Optional: lang, country.
Sampled 14 Oct 2026: 2 items. Filled in every item: id, place_id, url, name, type, category, categories, latitude and 16 more. Not in every item: guide_ids (1), rating (1), rating_max (1), rating_count (1), about (1), cover_photo_url (1). In the sample: name: “Sightglass Coffee” and 1 other value; url: maps.apple.com; about: median 319 characters; categories: median 5 entries; type: “BUSINESS”; category: “Coffee Roastery” and 1 other value; alt_phones: median 1 entry; website: sightglasscoffee.com and 1 other host.
Open in Playground
GET/apple-maps/reverse-geocodeapiKey1 credit/request
Returns Apple Maps' address record for a coordinate: the matched place name and type (an address, street, or area of interest such as a neighborhood), the formatted and structured address, the matched center, the IANA timezone, and the display region.
Required: latitude, longitude. Optional: lang, country.
Sampled 14 Oct 2026: 20 fields returned with a value. In the sample: region.south: 37.77; name: “Van Ness”; type: “AOI”; timezone: “America/Los_Angeles”; region.west: -122.42; region.north: 37.78; region.east: -122.41.
Open in Playground
GET/apple-maps/searchapiKey3 credits/request
Returns Apple Maps places matching a keyword, business name, category, or street address near a coordinate. Each place carries its Apple place ID (the value the place endpoint takes), name, category, coordinates, formatted and structured address, phone, website, rating and review count, price level, weekly opening hours, and a hero photo. Apple returns a bounded set per viewport (around 25 places for the default span) with no pagination; widen the span or move the center to cover more area. When nothing matches near the center Apple may relocate the search to a default region, reported by relocated=true and the region bounds. The response's filters block lists the refinement chips Apple offers for this query and area (open now, top rated, in guides, cuisines, price bands, amenities, accolades, sort); pass their keys back as filters and sort to refine the same search.
Required: query, latitude, longitude. Optional: span, limit, lang, country, filters, sort (3 allowed values: best_match, distance, ratings).
Sampled 14 Oct 2026: 25 items. Filled in every item: id, place_id, url, name, type, category, categories, latitude and 6 more. Not in every item: phone (24), alt_phones (10), website (24), rating (12), rating_max (12), rating_count (12), price_level (4), price_max (4) and 1 more. In the sample: category: Coffee Shop (15), Coffee Roastery (3), Bakery (3) and 4 more; rating: 3.3 to 4.63, median 4.1; name: “Sightglass Coffee” and 22 other values; url: maps.apple.com; categories: median 5 entries; alt_phones: median 1 entry; website: sightglasscoffee.com and 20 other hosts; hours: median 7 entries.
Open in Playground
GET/apple-maps/transit-departuresapiKey1 credit/request
Returns a transit stop or station's systems (e.g. BART, Muni Metro), lines (name, shield, color), and the upcoming departures Apple Maps shows, each with the line, headsign, direction, scheduled and live times, and real-time status. Takes the stop's Apple place ID (find stops with the search endpoint, e.g. a station name). A place that is not a transit stop returns 404.
Required: place_id. Optional: lang, country.
Sampled 14 Oct 2026: 131 items. Filled in every item: line_id, line, headsign, origin, stop_id, scheduled. Not in every item: direction (72), live (71), status (130). In the sample: scheduled: 2026-10-13 to 2026-10-17; direction: Eastbound (39), Westbound (33); line: “J Church” and 13 other values; headsign: “Embarcadero Station” and 15 other values; live: 2026-10-13; status: on_time (61), scheduled (58), delays (11).
Open in Playground
GET/apple-maps/venue/browseapiKey3 credits/request
Returns an indoor venue's directory (mall, airport, stadium: categories such as Clothes, Shoes, Food, All Shops with their subcategories and levels) and, when a category is given, the places inside the venue for that category with the same summary shape as search. Find venues with the search endpoint; a place without a directory returns 404, an unknown category returns 400 listing the available ones.
Required: place_id. Optional: category, limit, lang, country.
Sampled 14 Oct 2026: 25 items. Filled in every item: id, place_id, url, name, type, category, categories, latitude and 7 more. Not in every item: phone (24), alt_phones (12), rating (17), rating_max (17), rating_count (17), price_level (15), price_max (15), price_symbol (15). In the sample: category: Clothing Store (12), Department Store (4), Women's Clothing Store (3) and 5 more; rating: 2.9 to 5, median 3.8; name: “Zara” and 23 other values; url: maps.apple.com; categories: median 9 entries; alt_phones: median 1 entry; website: zara.com and 23 other hosts; rating_count: 1 to 2,258, median 134.
Open in Playground