Docs menu

Datasets API endpoint

Stored Apple Maps place API

Returns one stored Apple Maps place by Apple place id from dataset id `apple-maps-places`. Accepts either the numeric place id (the `id` field) or the external place id that appears in maps.apple.com URLs (the `place_id` field, starting with `I`). A `rating` of `null` means Apple shows no rating for the place. `catalog_country` is the Apple storefront the place was found under, not its country; `country_code` is the place's own country. `first_seen_at` is when the directory first observed the place and `last_seen_at` the latest observation. Does not trigger live scraping; for a live Apple Maps lookup use the apple-maps-place endpoint.

GETapiKey1 credit/requestDatasetsdatasets.applePlaceResponseDoc/datasets/apple-maps-places/items/{place_id}

Endpoint facts

Method: GET
API path: /datasets/apple-maps-places/items/{place_id}
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.applePlaceResponseDoc

Stored structured dataset search API Try Stored Apple Maps place API in Playground Datasets API documentation

How this endpoint behaves

Dataset id enum:

apple-maps-places

Path parameters:

place_id: required Apple place id, max 256 characters. Either the numeric id (the id field, e.g. 6435622567484707146) or the external id used in maps.apple.com URLs (the place_id field, starting with I).

Response behavior:

A null rating means Apple shows no rating for the place (never a zero-star score). Ratings come from third-party review partners that Apple shows (for example Yelp and Foursquare), so rating scales and review counts are not comparable across places, and a few places carry a rating with no count.
catalog_country is the Apple storefront the place was found under; country_code is the place's own country.
first_seen_at is when the directory first observed the place and last_seen_at the latest observation.
Returns 404 when the place id is not present in the stored dataset. The directory is observed, not complete, so a 404 does not mean the place does not exist.
Does not trigger live scraping. For a live lookup use the apple-maps-place endpoint.

Request parameters

Parameter	Type	Required	Default	Description	Example
place_id (path)	string	Yes		Apple place id: the numeric id or the external id starting with I	6435622567484707146
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/apple-maps-places/items/6435622567484707146" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "6435622567484707146",
    "place_id": "I594FECA0B369D14A",
    "name": "Sightglass Coffee",
    "category": "Coffee Shop",
    "city": "San Francisco",
    "country_code": "US"
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.applePlaceResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	es.ApplePlaceRecord	No
data.address	string	No
data.alt_phones	array	No
data.catalog_country	string	No
data.categories	array	No
data.category	string	No		Category is the deepest named Apple category; Categories is the whole taxonomy path (names) and CategoryIDs the matching Apple category ids.
data.category_ids	array	No
data.city	string	No
data.country	string	No
data.country_code	string	No
data.county	string	No
data.crawled_at	string	No
data.discovery_keyword	string	No
data.first_seen_at	string	No
data.hours	array	No
data.hours[].close	string	No
data.hours[].day	string	No
data.hours[].open	string	No
data.hours_type	string	No
data.id	string	No
data.last_seen_at	string	No
data.latitude	number	No
data.location	object	No		Location is a geo_point for radius search and distance sort.
data.location.lat	number	No		Latitude in decimal degrees.
data.location.lon	number	No		Longitude in decimal degrees.
data.longitude	number	No
data.name	string	No
data.neighborhood	string	No
data.phone	string	No
data.photo_url	string	No
data.place_id	string	No
data.postal_code	string	No
data.price_level	integer	No
data.price_symbol	string	No
data.rating	number	No
data.rating_count	integer	No
data.rating_max	integer	No
data.schema_version	integer	No
data.state	string	No
data.state_code	string	No
data.street	string	No
data.type	string	No
data.url	string	No
data.website	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/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/datasets/apple-maps-places/items/6435622567484707146" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Datasets endpoint docs Stored structured dataset search API Stored Datasets List API documentation Airbnb Markets Dataset Facets API documentation Airbnb Markets Dataset Country API documentation Nearby Airbnb Markets Dataset API documentation Airbnb Markets Dataset Search API documentation Facet the Apple Books dataset API documentation

Open in Playground Back to group

Docs menu

Datasets API endpoint

Stored Apple Maps place API

GETapiKey1 credit/requestDatasetsdatasets.applePlaceResponseDoc/datasets/apple-maps-places/items/{place_id}

Endpoint facts

Method: GET
API path: /datasets/apple-maps-places/items/{place_id}
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: Datasets
Execution: Stored dataset records. No live scraping, browser session or proxy routing.
Response schema: #/definitions/datasets.applePlaceResponseDoc

Stored structured dataset search API Try Stored Apple Maps place API in Playground Datasets API documentation

How this endpoint behaves

Dataset id enum:

apple-maps-places

Path parameters:

place_id: required Apple place id, max 256 characters. Either the numeric id (the id field, e.g. 6435622567484707146) or the external id used in maps.apple.com URLs (the place_id field, starting with I).

Response behavior:

A null rating means Apple shows no rating for the place (never a zero-star score). Ratings come from third-party review partners that Apple shows (for example Yelp and Foursquare), so rating scales and review counts are not comparable across places, and a few places carry a rating with no count.
catalog_country is the Apple storefront the place was found under; country_code is the place's own country.
first_seen_at is when the directory first observed the place and last_seen_at the latest observation.
Returns 404 when the place id is not present in the stored dataset. The directory is observed, not complete, so a 404 does not mean the place does not exist.
Does not trigger live scraping. For a live lookup use the apple-maps-place endpoint.

Request parameters

Parameter	Type	Required	Default	Description	Example
place_id (path)	string	Yes		Apple place id: the numeric id or the external id starting with I	6435622567484707146
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/datasets/apple-maps-places/items/6435622567484707146" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "id": "6435622567484707146",
    "place_id": "I594FECA0B369D14A",
    "name": "Sightglass Coffee",
    "category": "Coffee Shop",
    "city": "San Francisco",
    "country_code": "US"
  }
}

Request schema

No body schema

Response schema

#/definitions/datasets.applePlaceResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	es.ApplePlaceRecord	No
data.address	string	No
data.alt_phones	array	No
data.catalog_country	string	No
data.categories	array	No
data.category	string	No		Category is the deepest named Apple category; Categories is the whole taxonomy path (names) and CategoryIDs the matching Apple category ids.
data.category_ids	array	No
data.city	string	No
data.country	string	No
data.country_code	string	No
data.county	string	No
data.crawled_at	string	No
data.discovery_keyword	string	No
data.first_seen_at	string	No
data.hours	array	No
data.hours[].close	string	No
data.hours[].day	string	No
data.hours[].open	string	No
data.hours_type	string	No
data.id	string	No
data.last_seen_at	string	No
data.latitude	number	No
data.location	object	No		Location is a geo_point for radius search and distance sort.
data.location.lat	number	No		Latitude in decimal degrees.
data.location.lon	number	No		Longitude in decimal degrees.
data.longitude	number	No
data.name	string	No
data.neighborhood	string	No
data.phone	string	No
data.photo_url	string	No
data.place_id	string	No
data.postal_code	string	No
data.price_level	integer	No
data.price_symbol	string	No
data.rating	number	No
data.rating_count	integer	No
data.rating_max	integer	No
data.schema_version	integer	No
data.state	string	No
data.state_code	string	No
data.street	string	No
data.type	string	No
data.url	string	No
data.website	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
500	Internal Server Error	#/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/datasets/apple-maps-places/items/6435622567484707146" \
  -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

Stored Apple Maps place API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Stored Apple Maps place API

Endpoint facts

How this endpoint behaves

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related