API Reference
Use Crawlora's Apple Maps API endpoints to extract supported public Apple Maps data as structured JSON. This documentation covers 19 active endpoints including Get Apple Maps search suggestions for a partial query, List Apple Maps browse categories for an area, Browse one Apple Maps category near a coordinate, Get Apple Maps driving, walking, or cycling directions, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as query, latitude, longitude, category, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/apple-maps/search?query=coffee&limit=10&lang=en&country=us&sort=best_match" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/apple-maps/autocompleteapiKey1 credit/requestReturns 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 params: query:query, latitude:query, longitude:query
/apple-maps/categoriesapiKey1 credit/requestReturns 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 params: latitude:query, longitude:query
/apple-maps/category-searchapiKey3 credits/requestReturns 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 params: category:query, latitude:query, longitude:query
/apple-maps/directionsapiKey2 credits/requestReturns 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 params: origin_latitude:query, origin_longitude:query, destination_latitude:query, destination_longitude:query
/apple-maps/etaapiKey1 credit/requestReturns 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 params: origin_latitude:query, origin_longitude:query, destination_latitude:query, destination_longitude:query
/apple-maps/guidesapiKey1 credit/requestReturns 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.
Required params: None
/apple-maps/guides/citiesapiKey1 credit/requestReturns 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.
Required params: None
/apple-maps/guides/guideapiKey1 credit/requestReturns 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 params: guide_id:query
/apple-maps/guides/lookupapiKey1 credit/requestReturns 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 params: guide_ids:query
/apple-maps/guides/nearbyapiKey2 credits/requestReturns 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 params: latitude:query, longitude:query
/apple-maps/guides/publisherapiKey1 credit/requestReturns 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 params: publisher_id:query
/apple-maps/guides/publishersapiKey1 credit/requestReturns 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.
Required params: None
/apple-maps/placeapiKey1 credit/requestReturns 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 params: place_id:query
/apple-maps/place/photosapiKey1 credit/requestReturns 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 params: place_id:query
/apple-maps/placesapiKey2 credits/requestReturns 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 params: place_ids:query
/apple-maps/reverse-geocodeapiKey1 credit/requestReturns 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 params: latitude:query, longitude:query
/apple-maps/searchapiKey3 credits/requestReturns 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 params: query:query, latitude:query, longitude:query
/apple-maps/transit-departuresapiKey1 credit/requestReturns 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 params: place_id:query
/apple-maps/venue/browseapiKey3 credits/requestReturns 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 params: place_id:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get Apple Maps search suggestions for a partial query | /apple-maps/autocomplete | GET | 1 credit/request | query:query, latitude:query, longitude:query | View docs | Try endpoint |
| List Apple Maps browse categories for an area | /apple-maps/categories | GET | 1 credit/request | latitude:query, longitude:query | View docs | Try endpoint |
| Browse one Apple Maps category near a coordinate | /apple-maps/category-search | GET | 3 credits/request | category:query, latitude:query, longitude:query | View docs | Try endpoint |
| Get Apple Maps driving, walking, or cycling directions | /apple-maps/directions | GET | 2 credits/request | origin_latitude:query, origin_longitude:query, destination_latitude:query, destination_longitude:query | View docs | Try endpoint |
| Get Apple Maps travel-time estimates between two points | /apple-maps/eta | GET | 1 credit/request | origin_latitude:query, origin_longitude:query, destination_latitude:query, destination_longitude:query | View docs | Try endpoint |
| Browse the Apple Guides home page worldwide or for one city | /apple-maps/guides | GET | 1 credit/request | None | View docs | Try endpoint |
| List the regions and cities Apple Guides cover | /apple-maps/guides/cities | GET | 1 credit/request | None | View docs | Try endpoint |
| Get one Apple Guide with its places | /apple-maps/guides/guide | GET | 1 credit/request | guide_id:query | View docs | Try endpoint |
| Resolve up to 20 Apple Guide ids to guide summaries | /apple-maps/guides/lookup | GET | 1 credit/request | guide_ids:query | View docs | Try endpoint |
| Get the Apple Guides curated for the area around a coordinate | /apple-maps/guides/nearby | GET | 2 credits/request | latitude:query, longitude:query | View docs | Try endpoint |
| Get one Apple Guides publisher and its guides | /apple-maps/guides/publisher | GET | 1 credit/request | publisher_id:query | View docs | Try endpoint |
| List Apple Guides publishers worldwide or for one city | /apple-maps/guides/publishers | GET | 1 credit/request | None | View docs | Try endpoint |
| Get one Apple Maps place's full detail | /apple-maps/place | GET | 1 credit/request | place_id:query | View docs | Try endpoint |
| List every photo Apple Maps carries for a place | /apple-maps/place/photos | GET | 1 credit/request | place_id:query | View docs | Try endpoint |
| Get full detail for up to 20 Apple Maps places in one call | /apple-maps/places | GET | 2 credits/request | place_ids:query | View docs | Try endpoint |
| Reverse-geocode a coordinate with Apple Maps | /apple-maps/reverse-geocode | GET | 1 credit/request | latitude:query, longitude:query | View docs | Try endpoint |
| Search Apple Maps places near a coordinate | /apple-maps/search | GET | 3 credits/request | query:query, latitude:query, longitude:query | View docs | Try endpoint |
| Get a transit stop's lines and live departures from Apple Maps | /apple-maps/transit-departures | GET | 1 credit/request | place_id:query | View docs | Try endpoint |
| Browse the stores and places inside a venue on Apple Maps | /apple-maps/venue/browse | GET | 3 credits/request | place_id:query | View docs | Try endpoint |