Docs menu

Apple Maps API endpoint

Apple Maps Guides Cities API

Returns 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.

GETapiKey1 credit/requestApple Mapsapplemaps.guidesCitiesResponseDoc/apple-maps/guides/cities

Endpoint facts

Method: GET
API path: /apple-maps/guides/cities
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Apple Maps
Response schema: #/definitions/applemaps.guidesCitiesResponseDoc

Apple Maps API Try Apple Maps Guides Cities API in Playground Apple Maps API documentation

How this endpoint behaves

Each city's id is the value /apple-maps/guides, /apple-maps/guides/publishers, and /apple-maps/guides/publisher take as city_id. The Worldwide scope is not a region here; it is what those endpoints return when city_id is omitted.

Query parameters:

lang (optional) — display language as a BCP 47 tag, e.g. en-US, fr-FR. Region and city names follow it (fr-FR returns Amérique du Nord, Londres). Defaults to en-US.
country (optional) — two-letter ISO 3166-1 code, e.g. US. Defaults to US. The region and city set is the same for every country; only ordering may differ.

Response includes regions[], each with name and cities[]. Each city has id, name, country, latitude, longitude, and photo_url.

Live monitoring

Monitored request: GET /apple-maps/guides/cities
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.21 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /apple-maps/guides/cities
Items in regions: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked	Values in the sample
name	3	“North America” and 2 other values
cities	3	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
lang	string	No	en-US	Display language as a BCP 47 tag, e.g. en-US, fr-FR. Region and city names follow it. 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 example

curl -X GET "https://api.crawlora.net/api/v1/apple-maps/guides/cities?lang=en&country=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "regions": [
      {
        "name": "North America",
        "cities": [
          {
            "id": "5323833294395824021",
            "name": "Atlanta",
            "country": "United States",
            "latitude": 33.748188,
            "longitude": -84.390865,
            "photo_url": "https://is2-ssl.mzstatic.com/image/thumb/-cSWxNFFtkAygebPim-Ezg/1200x800.jpg"
          },
          {
            "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"
          }
        ]
      },
      {
        "name": "Europe",
        "cities": [
          {
            "id": "18366846785603624515",
            "name": "London",
            "country": "United Kingdom",
            "latitude": 51.5033768,
            "longitude": -0.0795183,
            "photo_url": "https://is5-ssl.mzstatic.com/image/thumb/RDVfnewE9nzSfqX2dAyJCA/1200x800.jpg"
          },
          {
            "id": "686784093234299453",
            "name": "Paris",
            "country": "France",
            "latitude": 48.8567879,
            "longitude": 2.3510768,
            "photo_url": "https://is3-ssl.mzstatic.com/image/thumb/91tDKd4YA6cIoLLVQzY1VA/1200x800.jpg"
          }
        ]
      },
      {
        "name": "Australia",
        "cities": [
          {
            "id": "17679939856455531905",
            "name": "Sydney",
            "country": "Australia",
            "latitude": -33.87271,
            "longitude": 151.2056942,
            "photo_url": "https://is2-ssl.mzstatic.com/image/thumb/r9UweGeBI1gCOfGQ2OPCpw/1200x800.jpg"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/applemaps.guidesCitiesResponseDoc

Field	Type	Required	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.GuidesCitiesResponse	No
data.regions	array	No
data.regions[].cities	array	No	GuideCity record, 6 fields: country, id, latitude, longitude, name, photo_url. Described under Apple Maps Guides API.
data.regions[].name	string	No
msg	unknown	No	Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/apple-maps/guides/cities?lang=en&country=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Apple Maps endpoint docs Apple Maps API Apple Maps Autocomplete API documentation Apple Maps Categories API documentation Apple Maps Category Search API documentation Apple Maps Directions API documentation Apple Maps ETA API documentation Apple Maps Guides API documentation

Open in Playground Back to group

Docs menu

Apple Maps API endpoint

Apple Maps Guides Cities API

GETapiKey1 credit/requestApple Mapsapplemaps.guidesCitiesResponseDoc/apple-maps/guides/cities

Endpoint facts

Method: GET
API path: /apple-maps/guides/cities
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Apple Maps
Response schema: #/definitions/applemaps.guidesCitiesResponseDoc

Apple Maps API Try Apple Maps Guides Cities API in Playground Apple Maps API documentation

How this endpoint behaves

Query parameters:

lang (optional) — display language as a BCP 47 tag, e.g. en-US, fr-FR. Region and city names follow it (fr-FR returns Amérique du Nord, Londres). Defaults to en-US.
country (optional) — two-letter ISO 3166-1 code, e.g. US. Defaults to US. The region and city set is the same for every country; only ordering may differ.

Response includes regions[], each with name and cities[]. Each city has id, name, country, latitude, longitude, and photo_url.

Live monitoring

Monitored request: GET /apple-maps/guides/cities
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.21 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /apple-maps/guides/cities
Items in regions: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked	Values in the sample
name	3	“North America” and 2 other values
cities	3	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
lang	string	No	en-US	Display language as a BCP 47 tag, e.g. en-US, fr-FR. Region and city names follow it. 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 example

curl -X GET "https://api.crawlora.net/api/v1/apple-maps/guides/cities?lang=en&country=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "regions": [
      {
        "name": "North America",
        "cities": [
          {
            "id": "5323833294395824021",
            "name": "Atlanta",
            "country": "United States",
            "latitude": 33.748188,
            "longitude": -84.390865,
            "photo_url": "https://is2-ssl.mzstatic.com/image/thumb/-cSWxNFFtkAygebPim-Ezg/1200x800.jpg"
          },
          {
            "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"
          }
        ]
      },
      {
        "name": "Europe",
        "cities": [
          {
            "id": "18366846785603624515",
            "name": "London",
            "country": "United Kingdom",
            "latitude": 51.5033768,
            "longitude": -0.0795183,
            "photo_url": "https://is5-ssl.mzstatic.com/image/thumb/RDVfnewE9nzSfqX2dAyJCA/1200x800.jpg"
          },
          {
            "id": "686784093234299453",
            "name": "Paris",
            "country": "France",
            "latitude": 48.8567879,
            "longitude": 2.3510768,
            "photo_url": "https://is3-ssl.mzstatic.com/image/thumb/91tDKd4YA6cIoLLVQzY1VA/1200x800.jpg"
          }
        ]
      },
      {
        "name": "Australia",
        "cities": [
          {
            "id": "17679939856455531905",
            "name": "Sydney",
            "country": "Australia",
            "latitude": -33.87271,
            "longitude": 151.2056942,
            "photo_url": "https://is2-ssl.mzstatic.com/image/thumb/r9UweGeBI1gCOfGQ2OPCpw/1200x800.jpg"
          }
        ]
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/applemaps.guidesCitiesResponseDoc

Field	Type	Required	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.GuidesCitiesResponse	No
data.regions	array	No
data.regions[].cities	array	No	GuideCity record, 6 fields: country, id, latitude, longitude, name, photo_url. Described under Apple Maps Guides API.
data.regions[].name	string	No
msg	unknown	No	Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/apple-maps/guides/cities?lang=en&country=us" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Apple Maps Guides Cities API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Apple Maps Guides Cities API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related