Endpoint Playground

Try the Apple Maps Guides Lookup API

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.

What a live request returned

14 Oct 2026: 2 guides; 7 fields had a value in every checked item.

Observed request: GET /apple-maps/guides/lookup?guide_ids=13100041759208417726%2C17954826775154719886
Fields with a value in every checked item: id, url, title, description, last_modified, item_total, photo_url

Sample value profiles: 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.

Request: GET /apple-maps/guides/lookup
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.23 s
Monitored request: GET /apple-maps/guides/lookup?guide_ids=13100041759208417726

Apple Maps Guides Lookup API documentation Apple Maps platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/apple-maps/guides/lookup?guide_ids=13100041759208417726%2C17954826775154719886' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
guide_ids	string	Yes	13100041759208417726,17954826775154719886	Comma-separated Apple guide ids, 1 to 20
lang	string	No		Display language as a BCP 47 tag. 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": {
    "guides": [
      {
        "id": "13100041759208417726",
        "url": "https://maps.apple.com/guides?curated=13100041759208417726&_provider=9902",
        "title": "The San Francisco Coffee Guide",
        "description": "The Bay Area's legendary coffee scene needs no introduction.",
        "last_modified": "2023-02-08T19:42:59.000Z",
        "item_total": 14,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/w4_6Zdp2JR_l-mz7c9J94w/1200x800.jpg"
      }
    ],
    "not_found": [
      "1"
    ]
  }
}

More Apple Maps endpoints

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 Browse the Apple Guides home page worldwide or for one city List the regions and cities Apple Guides cover Get one Apple Guide with its places Get the Apple Guides curated for the area around a coordinate Get one Apple Guides publisher and its guides List Apple Guides publishers worldwide or for one city Get one Apple Maps place's full detail All 19 Apple Maps endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestapplemaps.guidesLookupResponseDocApple Maps

GET /apple-maps/guides/lookup

Resolve up to 20 Apple Guide ids to guide summaries

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

guide_ids

requiredstring

Comma-separated Apple guide ids, 1 to 20

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": {
    "guides": [
      {
        "id": "13100041759208417726",
        "url": "https://maps.apple.com/guides?curated=13100041759208417726&_provider=9902",
        "title": "The San Francisco Coffee Guide",
        "description": "The Bay Area's legendary coffee scene needs no introduction.",
        "last_modified": "2023-02-08T19:42:59.000Z",
        "item_total": 14,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/w4_6Zdp2JR_l-mz7c9J94w/1200x800.jpg"
      }
    ],
    "not_found": [
      "1"
    ]
  }
}

Endpoint Playground

Try the Apple Maps Guides Lookup API

What a live request returned

14 Oct 2026: 2 guides; 7 fields had a value in every checked item.

Observed request: GET /apple-maps/guides/lookup?guide_ids=13100041759208417726%2C17954826775154719886
Fields with a value in every checked item: id, url, title, description, last_modified, item_total, photo_url

Sample value profiles: 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.

Request: GET /apple-maps/guides/lookup
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.23 s
Monitored request: GET /apple-maps/guides/lookup?guide_ids=13100041759208417726

Apple Maps Guides Lookup API documentation Apple Maps platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/apple-maps/guides/lookup?guide_ids=13100041759208417726%2C17954826775154719886' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
guide_ids	string	Yes	13100041759208417726,17954826775154719886	Comma-separated Apple guide ids, 1 to 20
lang	string	No		Display language as a BCP 47 tag. 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": {
    "guides": [
      {
        "id": "13100041759208417726",
        "url": "https://maps.apple.com/guides?curated=13100041759208417726&_provider=9902",
        "title": "The San Francisco Coffee Guide",
        "description": "The Bay Area's legendary coffee scene needs no introduction.",
        "last_modified": "2023-02-08T19:42:59.000Z",
        "item_total": 14,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/w4_6Zdp2JR_l-mz7c9J94w/1200x800.jpg"
      }
    ],
    "not_found": [
      "1"
    ]
  }
}

More Apple Maps endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestapplemaps.guidesLookupResponseDocApple Maps

GET /apple-maps/guides/lookup

Resolve up to 20 Apple Guide ids to guide summaries

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

guide_ids

requiredstring

Comma-separated Apple guide ids, 1 to 20

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": {
    "guides": [
      {
        "id": "13100041759208417726",
        "url": "https://maps.apple.com/guides?curated=13100041759208417726&_provider=9902",
        "title": "The San Francisco Coffee Guide",
        "description": "The Bay Area's legendary coffee scene needs no introduction.",
        "last_modified": "2023-02-08T19:42:59.000Z",
        "item_total": 14,
        "photo_url": "https://is1-ssl.mzstatic.com/image/thumb/w4_6Zdp2JR_l-mz7c9J94w/1200x800.jpg"
      }
    ],
    "not_found": [
      "1"
    ]
  }
}