Apple Maps API endpoint
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.
/apple-maps/guides/nearbyQuery parameters:
latitude (required) — latitude of the area, e.g. 37.7749.longitude (required) — longitude of the area, e.g. -122.4194.span (optional) — viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5.lang (optional) — display language as a BCP 47 tag, e.g. en-US, fr-FR. Defaults to en-US.country (optional) — two-letter ISO 3166-1 code, e.g. US. Defaults to US.city.id is the value /apple-maps/guides and /apple-maps/guides/publishers take as city_id for the full city guides page. A coordinate outside any Apple Guides city returns an empty guides list and no city. Guide summaries here do not include the publisher; use /apple-maps/guides/guide for one guide's publisher and places.
Response includes city (id, name, country, latitude, longitude, photo_url) and guides[] (each with id, url, title, description, last_modified, item_total, photo_url, source_url).
| Field | Filled in, of 6 checked | Values in the sample |
|---|---|---|
| id | 6 | |
| url | 6 | maps.apple.com |
| title | 6 | “The best things to do in San Francisco” and 5 other values |
| description | 6 | median 106 characters |
| last_modified | 6 | 2023-07-20 to 2026-10-08 |
| item_total | 6 | 5 to 172, median 15 |
| photo_url | 6 | is1-ssl.mzstatic.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| latitude | number | Yes | Latitude of the area | 37.7749 | |
| longitude | number | Yes | Longitude of the area | -122.4194 | |
| span | number | No | 0 | Viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5. | 0.05 |
| lang | string | No | en-US | Display language as a BCP 47 tag. Defaults to en-US. | en-US |
| country | string | No | US | Two-letter ISO 3166-1 country code. Defaults to US. | US |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/apple-maps/guides/nearby?latitude=37.7749&longitude=-122.4194&lang=en&country=us" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"city": {
"id": "8077516530309122779",
"name": "San Francisco",
"country": "United States",
"latitude": 37.779379,
"longitude": -122.418433,
"photo_url": "https://is4-ssl.mzstatic.com/image/thumb/7puls6L6HZdsJplSyhrPJA/1200x800.jpg"
},
"guides": [
{
"id": "17954826775154719886",
"url": "https://maps.apple.com/guides?curated=17954826775154719886&_provider=9902",
"title": "The 25 Best Restaurants In San Francisco",
"description": "Meet our 25 highest-rated restaurants.",
"last_modified": "2026-06-02T18:12:31.000Z",
"item_total": 25,
"photo_url": "https://is1-ssl.mzstatic.com/image/thumb/NMYjKRo8qX4xPqUirv4Iew/1200x800.jpg",
"source_url": "https://www.theinfatuation.com/san-francisco/guides/best-restaurants-in-san-francisco"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/applemaps.guidesNearbyResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | applemaps.GuidesNearbyResponse | No | ||||
| data.city | applemaps.GuideCity | No | GuideCity record, 6 fields: country, id, latitude, longitude, name, photo_url. Described under Apple Maps Guides API. | |||
| data.guides | array | No | GuideSummary record, 15 fields: description, id, item_total, last_modified, photo_url, publisher, source_url, title, url. Described under Apple Maps Guides API. | |||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/apple-maps/guides/nearby?latitude=37.7749&longitude=-122.4194&lang=en&country=us" \
-H "x-api-key: $CRAWLORA_API_KEY"