Apple Maps Reviews API Documentation Get the ratings and the review snippets of one Apple Maps place. Apple Maps has no review text of its own. It shows up to 3 review snippets that its partner Yelp shares, plus the rating sources: the Apple rating (score of 100, with Food and Drink, Atmosphere and Service scores) and the Yelp rating (score of 5). There is no paging, so only page=1 exists and page=2 returns a 422 error. A place can have no snippets: the answer then has an empty reviews list and the rating summary. Cost: 1 credit per request. A place without any rating or snippet, an unknown place and every error cost nothing.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
The 19 or 20 digit id of an Apple Maps place, e.g. 11249742488957856201.
example
string
Optional
Language and country of the answer. One of en-US, en-GB, de-DE, fr-FR, es-ES, it-IT, ja-JP. Default: en-US.
en-US
integer
Optional
Only 1 exists: Apple Maps shows one page of up to 3 snippets. Any other value returns a 422 error. Default: 1.
1
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": "11249742488957856201",
"name": "Haraz Coffee House",
"page": 1,
"reviews": [
{
"id": "4IoBXAozKebS6w9dspBM1g",
"url": "http://yelp.com/apple_maps_action?id=c6e66Cv0QEtj1tT_SZmMEQ&component=review&cid=4IoBXAozKebS6w9dspBM1g&action=view&language=en-US",
"rating": {
"score": 5,
"max_score": 5
},
"source": "Yelp",
"snippet": "The selection of pastries here is amazing. Huge variety . I got the baklava cheese cake. Delightful! Light fluffy creamy milky flavor. Not dense like a real cheese cake. With a fluffy crust from the b",
"reviewer": {
"name": "Michael K.",
"avatar": "https://is2-ssl.mzstatic.com/image/thumb/D_leChl_0Z5mnfIigHBORQ/250x250.jpeg"
}
},
{
"id": "9oTPU86bFsdBSUpc5f18mA",
"url": "http://yelp.com/apple_maps_action?id=c6e66Cv0QEtj1tT_SZmMEQ&component=review&cid=9oTPU86bFsdBSUpc5f18mA&action=view&language=en-US",
"rating": {
"score": 5,
"max_score": 5
},
"source": "Yelp",
"snippet": "Loved the drinks here! Everything we tried was delicious, but what really made the experience special was the staff. Everyone was incredibly welcoming, friendly, and attentive. A special shoutout to M",
"reviewer": {
"name": "swarnim s."
}
}
],
"place_id": "I9C1F1D30A4F3A9C9",
"reviews_url": "http://yelp.com/apple_maps_action?id=c6e66Cv0QEtj1tT_SZmMEQ&component=review&action=view&language=en-US",
"rating_summary": [
{
"count": 285,
"score": 4.1,
"source": "Yelp",
"max_score": 5
}
],
"reviews_source": "Yelp"
},
"meta": {
"credits": 1,
"billable": true,
"duration_ms": 470,
"endpoint_family": "reviews"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required query parameter is missing or invalid, or page is not 1. This response is not billable.
{
"errors": {
"page": [
"Apple Maps shows one page of review snippets (up to 3). Only page=1 exists."
]
},
"message": "The request validation failed"
}Place Not Found
Apple Maps has no place with this id. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "reviews"
},
"error": {
"code": "NOT_FOUND",
"message": "Apple Maps has no such place."
},
"success": false
}Service Unavailable
Apple Maps could not be reached. This response is not billable. Retry later.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "reviews"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Apple Maps is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.