Endpoint Playground

Try the Apple Maps Guides Publisher API

Test Crawlora's Apple Maps Guides Publisher API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /apple-maps/guides/publisher
Platform: Apple Maps
Auth: apiKey
Credits: 1 credit/request
Required params: publisher_id
Common optional params: city_id, lang, country

Apple Maps Guides Publisher API documentation Apple Maps platform page Crawlora API pricing Try Apple Maps Autocomplete API Try Apple Maps Categories API Try Apple Maps Category Search API Try Apple Maps Directions API Try Apple Maps ETA API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/apple-maps/guides/publisher?publisher_id=<publisher_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
publisher_id	string	Yes	Publisher id: from the guides home or publishers list, a guide's publisher.id, or the publisher= value in a maps.apple.com/guides URL
city_id	string	No	Restrict to one city: an id from this publisher's own cities list
lang	string	No	Display language as a BCP 47 tag, e.g. en-US, fr-FR. Defaults to en-US.
country	string	No	Two-letter ISO 3166-1 country code. Defaults to US.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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,
    "city_filter": {
      "id": "18366846785603624515",
      "name": "London",
      "latitude": 51.5033768,
      "longitude": -0.0795183
    },
    "cities": [
      {
        "id": "18366846785603624515",
        "name": "London",
        "latitude": 51.5033768,
        "longitude": -0.0795183
      },
      {
        "id": "8077516530309122779",
        "name": "San Francisco",
        "latitude": 37.779379,
        "longitude": -122.418433
      }
    ],
    "guides": [
      {
        "id": "9905139136312820741",
        "url": "https://maps.apple.com/guides?curated=9905139136312820741&_provider=9902",
        "title": "The East London Coffee Guide",
        "description": "Where to drink coffee east of the City.",
        "last_modified": "2024-01-19T16:29:14.000Z",
        "item_total": 12,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/ypVvG6F9jz7pUKN0Pt9c9w/1200x800.jpg",
        "publisher": {
          "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
        }
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestapplemaps.publisherResponseDocApple Maps

GET /apple-maps/guides/publisher

Get one Apple Guides publisher and its guides

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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

publisher_id

requiredstring

Publisher id: from the guides home or publishers list, a guide's publisher.id, or the publisher= value in a maps.apple.com/guides URL

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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,
    "city_filter": {
      "id": "18366846785603624515",
      "name": "London",
      "latitude": 51.5033768,
      "longitude": -0.0795183
    },
    "cities": [
      {
        "id": "18366846785603624515",
        "name": "London",
        "latitude": 51.5033768,
        "longitude": -0.0795183
      },
      {
        "id": "8077516530309122779",
        "name": "San Francisco",
        "latitude": 37.779379,
        "longitude": -122.418433
      }
    ],
    "guides": [
      {
        "id": "9905139136312820741",
        "url": "https://maps.apple.com/guides?curated=9905139136312820741&_provider=9902",
        "title": "The East London Coffee Guide",
        "description": "Where to drink coffee east of the City.",
        "last_modified": "2024-01-19T16:29:14.000Z",
        "item_total": 12,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/ypVvG6F9jz7pUKN0Pt9c9w/1200x800.jpg",
        "publisher": {
          "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
        }
      }
    ]
  }
}

Endpoint details

Method: GET
Path: /apple-maps/guides/publisher
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Apple Maps
Parameters: 5 documented fields

Request parameters

publisher_id:querycity_id:querylang:querycountry:queryx-api-key:header

Response schema fields

codedatadata.citiesdata.cities[].countrydata.cities[].iddata.cities[].latitudedata.cities[].longitudedata.cities[].namedata.cities[].photo_urldata.city_filterdata.city_filter.countrydata.city_filter.id

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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,
    "city_filter": {
      "id": "18366846785603624515",
      "name": "London",
      "latitude": 51.5033768,
      "longitude": -0.0795183
    },
    "cities": [
      {
        "id": "18366846785603624515",
        "name": "London",
        "latitude": 51.5033768,
        "longitude": -0.0795183
      },
      {
        "id": "8077516530309122779",
        "name": "San Francisco",
        "latitude": 37.779379,
        "longitude": -122.418433
      }
    ],
    "guides": [
      {
        "id": "9905139136312820741",
        "url": "https://maps.apple.com/guides?curated=9905139136312820741&_provider=9902",
        "title": "The East London Coffee Guide",
        "description": "Where to drink coffee east of the City.",
        "last_modified": "2024-01-19T16:29:14.000Z",
        "item_total": 12,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/ypVvG6F9jz7pUKN0Pt9c9w/1200x800.jpg",
        "publisher": {
          "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
        }
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/apple-maps/guides/publisher?publisher_id=<publisher_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing 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 Get Apple Maps travel-time estimates between two points

Try the Apple Maps Guides Publisher API

Request parameters visible to crawlers

Parameter	Type	Required	Description
publisher_id	string	Yes	Publisher id: from the guides home or publishers list, a guide's publisher.id, or the publisher= value in a maps.apple.com/guides URL
city_id	string	No	Restrict to one city: an id from this publisher's own cities list
lang	string	No	Display language as a BCP 47 tag, e.g. en-US, fr-FR. Defaults to en-US.
country	string	No	Two-letter ISO 3166-1 country code. Defaults to US.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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,
    "city_filter": {
      "id": "18366846785603624515",
      "name": "London",
      "latitude": 51.5033768,
      "longitude": -0.0795183
    },
    "cities": [
      {
        "id": "18366846785603624515",
        "name": "London",
        "latitude": 51.5033768,
        "longitude": -0.0795183
      },
      {
        "id": "8077516530309122779",
        "name": "San Francisco",
        "latitude": 37.779379,
        "longitude": -122.418433
      }
    ],
    "guides": [
      {
        "id": "9905139136312820741",
        "url": "https://maps.apple.com/guides?curated=9905139136312820741&_provider=9902",
        "title": "The East London Coffee Guide",
        "description": "Where to drink coffee east of the City.",
        "last_modified": "2024-01-19T16:29:14.000Z",
        "item_total": 12,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/ypVvG6F9jz7pUKN0Pt9c9w/1200x800.jpg",
        "publisher": {
          "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
        }
      }
    ]
  }
}

Get one Apple Guides publisher and its guides

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "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, "city_filter": { "id": "18366846785603624515", "name": "London", "latitude": 51.5033768, "longitude": -0.0795183 }, "cities": [ { "id": "18366846785603624515", "name": "London", "latitude": 51.5033768, "longitude": -0.0795183 }, { "id": "8077516530309122779", "name": "San Francisco", "latitude": 37.779379, "longitude": -122.418433 } ], "guides": [ { "id": "9905139136312820741", "url": "https://maps.apple.com/guides?curated=9905139136312820741&_provider=9902", "title": "The East London Coffee Guide", "description": "Where to drink coffee east of the City.", "last_modified": "2024-01-19T16:29:14.000Z", "item_total": 12, "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/ypVvG6F9jz7pUKN0Pt9c9w/1200x800.jpg", "publisher": { "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 } } ] } }

Endpoint details

Method: GET
Path: /apple-maps/guides/publisher
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Apple Maps
Parameters: 5 documented fields

Request parameters

publisher_id:querycity_id:querylang:querycountry:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "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,
    "city_filter": {
      "id": "18366846785603624515",
      "name": "London",
      "latitude": 51.5033768,
      "longitude": -0.0795183
    },
    "cities": [
      {
        "id": "18366846785603624515",
        "name": "London",
        "latitude": 51.5033768,
        "longitude": -0.0795183
      },
      {
        "id": "8077516530309122779",
        "name": "San Francisco",
        "latitude": 37.779379,
        "longitude": -122.418433
      }
    ],
    "guides": [
      {
        "id": "9905139136312820741",
        "url": "https://maps.apple.com/guides?curated=9905139136312820741&_provider=9902",
        "title": "The East London Coffee Guide",
        "description": "Where to drink coffee east of the City.",
        "last_modified": "2024-01-19T16:29:14.000Z",
        "item_total": 12,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/ypVvG6F9jz7pUKN0Pt9c9w/1200x800.jpg",
        "publisher": {
          "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
        }
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/apple-maps/guides/publisher?publisher_id=<publisher_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"