Apple Maps API endpoint
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.
/apple-maps/guides/publishersQuery parameters:
city_id (optional) — a city id from /apple-maps/guides/cities, e.g. 8077516530309122779. Omit for the Worldwide publisher list (over a hundred publishers); a city returns only the publishers with guides for that city. An id that is not in the city list returns a 404.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.Response includes scope (worldwide or city), city (city scope only), and publishers[], each with id, url, name, subtitle, website, and guide_count.
| Field | Filled in, of 91 checked | Values in the sample |
|---|---|---|
| id | 91 | |
| url | 91 | maps.apple.com |
| name | 91 | “5280 Magazine” and 90 other values |
| subtitle | 83 | “Denver's Mile High Magazine” and 82 other values |
| website | 87 | 5280.com and 86 other hosts |
| guide_count | 91 | 1 to 997, median 14 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| city_id | string | No | City id from /apple-maps/guides/cities. Omit for the Worldwide publisher list. | 8077516530309122779 | |
| lang | string | No | en-US | Display language as a BCP 47 tag, e.g. en-US, fr-FR. 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/publishers?lang=en&country=us" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"scope": "worldwide",
"publishers": [
{
"id": "17882075820533551969",
"url": "https://maps.apple.com/guides?publisher=17882075820533551969&_provider=9902",
"name": "365 Things Austin",
"subtitle": "Daily Things To Do In Austin",
"website": "https://365thingsaustin.com/",
"guide_count": 2
},
{
"id": "5295979391266658318",
"url": "https://maps.apple.com/guides?publisher=5295979391266658318&_provider=9902",
"name": "AllTrails",
"subtitle": "Find your outdoors",
"website": "https://www.alltrails.com",
"guide_count": 14
},
{
"id": "1706564968711360917",
"url": "https://maps.apple.com/guides?publisher=1706564968711360917&_provider=9902",
"name": "Sprudge",
"subtitle": "Coffee News & Culture",
"website": "https://sprudge.com",
"guide_count": 19
}
]
}
}Request schema
No body schema
Response schema
#/definitions/applemaps.guidesPublishersResponseDoc
| 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.GuidesPublishersResponse | No | ||||
| data.city | applemaps.GuideCity | No | GuideCity record, 6 fields: country, id, latitude, longitude, name, photo_url. Described under Apple Maps Guides API. | |||
| data.publishers | array | No | PublisherSummary record, 6 fields: guide_count, id, name, subtitle, url, website. Described under Apple Maps Guide API. | |||
| data.scope | string | No | ||||
| 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 |
| 404 | Not Found | #/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/publishers?lang=en&country=us" \
-H "x-api-key: $CRAWLORA_API_KEY"