Apple Maps Place API Documentation Get the full details of one Apple Maps place by its muid (the id of a search result), its place_id or its auid. The answer has name, categories, full and structured address, coordinates, time zone, phone numbers, website, weekly opening hours as HH:MM times, Apple and Yelp ratings as separate entries with their own scale, price level, photos with source, amenities, order links, guides, the containing place and up to 3 review snippets. A field Apple does not publish for the place is left out. Cost: 1 credit per request. 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
This endpoint has no required query parameters.
4 optional filters available.
string
Optional
The 19 or 20 digit id of an Apple Maps place, e.g. 11249742488957856201. Send one of muid, place_id or auid.
example
string
Optional
Apple place id, e.g. I9C1F1D30A4F3A9C9. It starts with I followed by 16 capital hex characters.
1234567890
string
Optional
The number from an Apple Maps place link (auid).
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
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",
"hours": {
"type": "normal",
"weekly": [
{
"days": [
"sunday",
"monday",
"tuesday",
"wednesday",
"thursday",
"friday",
"saturday"
],
"open": "07:00",
"close": "23:00"
}
]
},
"links": [
{
"url": "https://www.grubhub.com/restaurant/8594856?utm_source=applemap&utm_medium=appclip&utm_campaign=appcliptraffic",
"type": "quicklinks.restaurant_order_food",
"title": "Order",
"provider": "grubhub.com"
},
{
"url": "https://www.ubereats.com/wrapper/apple-maps/haraz-coffee-house-sf/2LDxr9IZV6azZ_-qEhL8lg",
"type": "quicklinks.restaurant_order_food",
"title": "Order",
"provider": "ubereats.com"
},
{
"url": "https://doordash.com/store/25845678?src=ac",
"type": "quicklinks.restaurant_order_food",
"title": "Order",
"provider": "doordash.com"
}
],
"phone": "+1 (415) 494-7239",
"photos": [
{
"url": "https://is1-ssl.mzstatic.com/image/thumb/OdZ13PnN7rmKlXFY8y9Sug/750x1000bb.jpg",
"width": 750,
"height": 1000,
"source": "Yelp"
},
{
"url": "https://is1-ssl.mzstatic.com/image/thumb/soojK98mcc6W6ybv2qVr5A/1114x1980bb.jpg",
"width": 1114,
"height": 1980,
"source": "Yelp"
}
],
"address": "1452 Franklin St, San Francisco, CA 94109, United States",
"ratings": [
{
"count": 285,
"score": 4.1,
"source": "Yelp",
"max_score": 5
}
],
"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."
}
}
],
"website": "https://harazcoffeehouse.com",
"category": "Coffee Shop",
"place_id": "I9C1F1D30A4F3A9C9",
"timezone": "America/Los_Angeles",
"amenities": [
{
"id": "crossbusiness.payments.applepay",
"name": "Accepts Apple Pay"
},
{
"id": "crossbusiness.payments.contactless_pay",
"name": "Accepts Contactless Payments"
},
{
"id": "crossbusiness.parking.parking_validated",
"name": "Parking Validated"
}
],
"editorial": {
"url": "https://www.theinfatuation.com/san-francisco/reviews/haraz-coffee-house?utm_source=applemaps&utm_medium=affiliate&utm_campaign=applemaps&utm_content=review",
"text": "SF is a city with an early bedtime\u2014there are bike rides and yoga classes to get to in the morning, after all. So it\u2019s hard to find a place open past 9pm, especi...",
"source": "The Infatuation"
},
"categories": [
{
"id": "coffee_shop",
"name": "Coffee Shop",
"level": 99
},
{
"id": "cafe",
"name": "Cafe",
"level": 2
}
],
"phone_e164": "+14154947239",
"containment": {
"text": "Coffee Shop \u00b7 Van Ness-Civic Center, San Francisco",
"container_id": "7807061029195101378"
},
"coordinates": {
"latitude": 37.7881599,
"longitude": -122.4233646
},
"price_level": {
"level": 2,
"source": "Yelp",
"symbol": "$",
"max_level": 4
},
"short_address": "1452 Franklin St, San Francisco",
"address_details": {
"city": "San Francisco",
"state": "California",
"county": "San Francisco County",
"street": "1452 Franklin St",
"country": "United States",
"state_code": "CA",
"postal_code": "94109",
"country_code": "US",
"house_number": "1452",
"neighborhood": "Van Ness-Civic Center"
}
},
"meta": {
"credits": 1,
"billable": true,
"duration_ms": 480,
"endpoint_family": "place"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required query parameter is missing or invalid. This response is not billable.
{
"errors": {
"muid": [
"The muid is the 19 or 20 digit id of an Apple Maps place, e.g. 11249742488957856201."
]
},
"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": "place"
},
"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": "place"
},
"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.