Apple Maps Search API
Our Apple Maps API allows you to scrape results from the Apple Maps search page.
The API endpoint is https://serpapi.com/search?engine=apple_maps
Head to the playground for a live and interactive demo.
API Parameters
Geographic Location
center
Optional
Parameter defines coordinates of the center point of the region you want to search within. You can pass the coordinates as latitude,longitude. (e.g. 30.324639,-97.7304611 for Austin, TX).
Either a center or a location parameter is required. These parameters can't be used together.
Refinement
sort
Optional
Parameter defines the sorting refinement for the search. Can be one of the following:distance - Sort by distance from the center/location.ratings - Sort by result ratings.default - Sort by best match for your query. This is the default.
toggles
Optional
Parameter defines the toggle options for the search. A comma separated list of toggle key values can be passed to this parameter. See the refinements.toggles object of the response to see available toggles for a search.
multi_select_options
Optional
Parameter defines the options you want to filter by for multi select refinements. A comma separated list of toggle key values can be passed to this parameter. See the refinement.multi_select.<type>.options object of the response to see available multi select refinements for the search.
Localization
locale
Optional
Parameter defines the locale the results should be localized for. Locales for Apple Maps are represented as <LANGUAGE>-<REGION>. (defaults to en-US, the locale for U.S. English). Head to Apple Maps Locales for the list of available locales.
Serpapi Parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Apple Maps results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
API Results
JSON Results
JSON output includes structured data for maps local results, maps guide results, and maps place results.
A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.
HTML Results
This API does not have the HTML response, just a text response. search_metadata.prettify_html_file contains prettified version of the result. It is displayed in the playground.
API Examples
Example local results with q: Coffee, and Austin, TX, US as a location
{
"search_metadata": {
"id": "6994841d1ef78208d5c7ec54",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/yp2QPlzf4lddiXbOaG8lvA/6994841d1ef78208d5c7ec54.json",
"created_at": "2026-02-17 15:07:09 UTC",
"processed_at": "2026-02-17 15:07:09 UTC",
"apple_maps_url": "https://maps.apple.com/search?center=30.324639,-97.7304611&span=0.05,0.05&query=Coffee",
"raw_html_file": "https://serpapi.com/searches/yp2QPlzf4lddiXbOaG8lvA/6994841d1ef78208d5c7ec54.html",
"total_time_taken": 0.86
},
"search_parameters": {
"engine": "apple_maps",
"query": "Coffee",
"center": "30.324639,-97.7304611",
"span": "0.05,0.05"
},
"local_results": [
{
"position": 1,
"position_in_page": 1,
"place_id": "I33EF56C142F4E37A",
"muid": "3742305203420193658",
"provider_id": "9902",
"link": "https://maps.apple.com/place?place-id=I33EF56C142F4E37A&_provider=9902",
"title": "Epoch Coffee",
"gps_coordinates": {
"latitude": 30.3185578,
"longitude": -97.7245635
},
"rating": 89,
"max_rating": 100,
"reviews": 88,
"ratings": {
"attribution": {
"vendor_id": "com.apple",
"name": "Apple",
"external_item_id": "130349166"
},
"values": [
{
"type": "APPLE_RATING",
"rating": 89,
"max_rating": 100,
"reviews": 88
},
{
"type": "APPLE_RATING",
"rating": 96,
"max_rating": 100,
"reviews": 70,
"category": "Food & Drink"
},
...
]
},
"address": "221 W North Loop Blvd, Austin, TX 78751, United States",
"phone": "+1 (512) 454-3762",
"website": "http://www.epochcoffee.com",
"amenities": [
{
"name": "Parking Lot",
"id": "crossbusiness.parking.parking_lot"
},
{
"name": "Free Wi-Fi",
"id": "crossbusiness.techfeatures.wifi.freewifi"
},
...
],
"timezone": "America/Chicago",
"open_state": "Open 24 hrs",
"weekly_hours": {
"sunday": [
"Open 24 hrs"
],
"monday": [
"Open 24 hrs"
],
"tuesday": [
"Open 24 hrs"
],
...
},
"types": [
"Dining",
"Coffee Shop",
"Cafe",
"Coffee Shop"
],
"type_ids": [
"dining",
"coffee_shop",
"cafe",
"coffee_shop"
] ,
"type": "Coffee Shop",
"type_id": "coffee_shop",
"actions":[
{
"title": "Menu",
"link": "https://www.yelp.com/menu/epoch-coffee-austin-2?utm_campaign=action_link_view_menu&utm_medium=feed_v2&utm_source=apple"
}
],
"images":[
{
"thumbnail": "https://ir.4sqi.net/img/general/450x450/8863421_dR0G5K9HoXGPWv1KDJBOs5uWyEwPb7UQJv9vFVuKHYg.jpg",
"attribution": {
"name": "Foursquare",
"link": "https://foursquare.com/mapaction?id=45543fccf964a520ff3c1fe3&component=photo&cid=54f7940e498e343515657f34&action=view&language=en-US"
}
}
...
],
"collection": [
{
"position": 1,
"muid": "2460073272399086121",
"provider_id": 9902,
"title": "13 Neighborhood Coffee Shops in Austin",
"long_title": "13 Neighborhood Coffee Shops in Austin",
"description": "Below you’ll find 13 of our go-to coffee shops that are scattered throughout the city, but, they’re not just places to get your caffeine fix. They’re also great WFH options, community centers, live music venues and Instagrammable hotspots.",
"item_description": "Although Epoch Coffee has three locations, we’re partial to the North Loop Boulevard spot, which is one of the best places for working remotely. Plenty of tables and plugs abound in this coffee shop, which has been open since 2006. Not to mention, the shop is open 24/7 for all your WFH needs. Don’t skip the Iced Mojo, a creamy, slightly sweetened drink that’s easy to love.",
"link": "https://tribeza.com/austin-city-guides/drink/neighborhood-coffee-shops/",
"apple_maps_link": "https://maps.apple.com/guides?curated=2460073272399086121&_provider=9902",
"item_count": 12,
"publisher": {
"id": "6027967618599873457",
"name": "Tribeza",
"subtitle": "Austin Curated",
"link": "https://tribeza.com"
}
}
]
},
{
"position": 2,
"position_in_page": 2,
"place_id": "I996AE6D14B7AEA7",
"muid": "690931376370200231",
"provider_id": "9902",
"link": "https://maps.apple.com/place?place-id=I996AE6D14B7AEA7&_provider=9902",
"title": "Monkey Nest",
"gps_coordinates": {
"latitude": 30.327692,
"longitude": -97.7395811
},
"rating": 4,
"max_rating": 5,
"reviews": 751,
"ratings": {
"attribution": {
"vendor_id": "com.yelp",
"name": "Yelp",
"external_item_id": "szqma4QibwpVaA9fsE8soQ",
"link": "http://yelp.com/biz/szqma4QibwpVaA9fsE8soQ",
"logo_url": "https://gspe21-ssl.ls.apple.com/attributionsearch/button-yelp-logo-6.png",
"snippet_logo_url": "https://gspe21-ssl.ls.apple.com/attributionsearch/snippet-yelp-logo-6.png",
"serpapi_yelp_reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=szqma4QibwpVaA9fsE8soQ&start=0"
},
"values": [
{
"type": "USER_RATING",
"rating": 4,
"max_rating": 5,
"reviews": 751
},
{
"type": "PRICE_RANGE",
"rating": 2,
"max_rating": 4
}
]
},
"address": "5353 Burnet Rd, Austin, TX 78756, United States",
"phone": "+1 (512) 505-8033",
"website": "https://monkeynestcoffee.com/",
"amenities": [
{
"name": "Parking Lot",
"id": "crossbusiness.parking.parking_lot"
},
{
"name": "Free Wi-Fi",
"id": "crossbusiness.techfeatures.wifi.freewifi"
},
...
],
"price_score": 2,
"max_price_score": 4,
"price": "$$",
"timezone": "America/Chicago",
"open_state": "Open till 19:00",
"weekly_hours": {
"sunday": [
"08:00 - 19:00"
],
"monday": [
"07:00 - 19:00"
],
...
},
"types": [
"Dining",
"Coffee Shop",
"Cafe",
"Coffee Shop"
],
"type_ids": [
"dining",
"coffee_shop",
"cafe",
"coffee_shop"
],
"type": "Coffee Shop",
"type_id": "coffee_shop",
"actions": [
{
"title": "Order",
"link": "https://doordash.com/store/61419?src=ac"
},
{
"title": "Delivery",
"link": "https://direct.chownow.com/order/34679/locations/52414?cn_channel=cn_apple&utm_source=cn_apple&deliversToMe=1"
},
...
],
"order_online": "https://doordash.com/store/61419?src=ac",
"images": [
{
"title": "Ordering Counter",
"thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/Vt1qfuA8Oz3KZLtzIP8iWQ/320x320bb.jpg",
"attribution": {
"name": "Yelp",
"link": "http://yelp.com/apple_maps_action?id=szqma4QibwpVaA9fsE8soQ&component=photo&cid=VQIPWCoIjevXLntW_VckaQ&action=view&language=en-US"
}
},
{
"thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/yNIwSjFpcqBY4qHbKnnZsg/320x320bb.jpg",
"attribution": {
"name": "Yelp",
"link": "http://yelp.com/apple_maps_action?id=szqma4QibwpVaA9fsE8soQ&component=photo&cid=4ZyWhZJ6vDJ6gFGmFnOgRA&action=view&language=en-US"
}
},
...
],
"user_reviews": {
"attribution": {
"vendor_id": "com.yelp",
"name": "Yelp",
"external_item_id": "szqma4QibwpVaA9fsE8soQ",
"link": "http://yelp.com/biz/szqma4QibwpVaA9fsE8soQ",
"logo_url": "https://gspe21-ssl.ls.apple.com/attributionsearch/button-yelp-logo-6.png",
"snippet_logo_url": "https://gspe21-ssl.ls.apple.com/attributionsearch/snippet-yelp-logo-6.png",
"serpapi_yelp_reviews_link": "https://serpapi.com/search.json?engine=yelp_reviews&num=49&place_id=szqma4QibwpVaA9fsE8soQ&start=0"
},
"most_relevant": [
{
"username": "Karla D.",
"rating": 4,
"max_rating": 5,
"user_thumbnail": "https://is2-ssl.mzstatic.com/image/thumb/_y9fQOVM0XmGievmOJrrUg/250x250.jpeg",
"description": "My dentist is just down the street and I had been wanting to stop in for the longest time and finally had the opportunity to do so. I was not disappointed at all. You know the place is good when there",
"link": "http://yelp.com/apple_maps_action?id=szqma4QibwpVaA9fsE8soQ&component=review&cid=VfBygV56yFFbPtdsxmmKbA&action=view&language=en-US",
"id": "VfBygV56yFFbPtdsxmmKbA"
},
...
]
}
}
...
]
...
}
Example guide results with q: Coffee, and Austin, TX, US as a location
{
...
"guide_results": [
{
"position": 1,
"position_in_page": 6,
"muid": "16505394090301289830",
"provider_id": 9902,
"title": "The Best Coffee Shops In Austin",
"long_title": "The Best Coffee Shops In Austin",
"description": "It's not hard to find a cup of coffee in Austin, but these are the best in the city.",
"link": "https://www.theinfatuation.com/austin/guides/best-coffee-shops-austin?utm_campaign=applemaps&utm_medium=affiliate&utm_source=applemaps&utm_audience=austin&utm_campaigntype=organic",
"apple_maps_link": "https://maps.apple.com/guides?curated=16505394090301289830&_provider=9902",
"item_count": 15,
"publisher": {
"id": "3291963553709838958",
"name": "The Infatuation",
"subtitle": "Your restaurant decider.",
"link": "https://www.theinfatuation.com/?utm_campaign=applemaps&utm_medium=affiliate&utm_source=applemaps&utm_audience=all&utm_campaigntype=organic"
},
"photos": [
{
"link": "https://is1-ssl.mzstatic.com/image/thumb/_ZcsAHwIG7_W-SHgT0qQVA/1200x800.jpg",
"width": 1200,
"height": 800
}
],
"items": [
{
"muid": "994057644462772470",
"provider_id": 9902,
"link": "https://maps.apple.com/place?auid=994057644462772470&_provider=9902"
},
...
]
},
{
"position": 2,
"position_in_page": 11,
"muid": "2460073272399086121",
"provider_id": 9902,
"title": "13 Neighborhood Coffee Shops in Austin",
"long_title": "13 Neighborhood Coffee Shops in Austin",
"description": "Below you’ll find 13 of our go-to coffee shops that are scattered throughout the city, but, they’re not just places to get your caffeine fix. They’re also great WFH options, community centers, live music venues and Instagrammable hotspots.",
"link": "https://tribeza.com/austin-city-guides/drink/neighborhood-coffee-shops/",
"apple_maps_link": "https://maps.apple.com/guides?curated=2460073272399086121&_provider=9902",
"item_count": 12,
"publisher": {
"id": "6027967618599873457",
"name": "Tribeza",
"subtitle": "Austin Curated",
"link": "https://tribeza.com"
},
"photos": [
{
"link": "https://is1-ssl.mzstatic.com/image/thumb/2XZJrmz-UEq3kY0cRZ87hg/1200x800.jpg",
"width": 1200,
"height": 800,
"author": "Alison Marlborough"
}
],
"items": [
{
"muid": "8897797934494847835",
"provider_id": 9902,
"link": "https://maps.apple.com/place?auid=8897797934494847835&_provider=9902"
},
...
]
},
...
]
}
JSON structure overview
{
"local_results": [
{
"position": "Integer - Place position in local results",
"position_in_page": "Integer - Place position on the page",
"place_id": "String - Apple Maps place ID",
"muid": "String - Apple Maps unique identifier",
"provider_id": "String - Provider identifier",
"link": "String - URL to the Apple Maps place page",
"title": "String - Place name",
"gps_coordinates": {
"latitude": "Float - Place latitude",
"longitude": "Float - Place longitude"
},
"rating": "Numeric - Place rating",
"max_rating": "Numeric - Maximum possible rating",
"reviews": "Integer - Number of reviews",
"ratings": {
"attribution": {
"vendor_id": "String - Rating provider vendor ID (e.g., com.apple, com.yelp)",
"name": "String - Rating provider name",
"external_item_id": "String - External identifier at the provider",
"link": "String - URL to the provider page",
"logo_url": "String - URL to provider logo",
"snippet_logo_url": "String - URL to provider snippet logo",
"serpapi_yelp_place_link": "String - URL to SerpApi Yelp place search", // if vendor is Yelp
"serpapi_yelp_reviews_link": "String - URL to SerpApi Yelp reviews search", // if vendor is Yelp
"serpapi_tripadvisor_place_link": "String - URL to SerpApi TripAdvisor place search", // if vendor is TripAdvisor
"serpapi_tripadvisor_reviews_link": "String - URL to SerpApi TripAdvisor reviews search", // if vendor is TripAdvisor
},
"values": [
{
"type": "String - Rating type (e.g., APPLE_RATING, USER_RATING, PRICE_RANGE)",
"rating": "Numeric - Rating score",
"max_rating": "Numeric - Maximum rating score",
"reviews": "Integer - Number of reviews for this rating",
"category": "String - Rating category (e.g., Food & Drink, Atmosphere, Customer Service)"
},
...
]
},
"address": "String - Place full address",
"phone": "String - Place phone number",
"website": "String - Place website URL",
"about": "String - Place description",
"amenities": [
{
"name": "String - Amenity name (e.g., Free Wi-Fi, Accepts Credit Cards)",
"id": "String - Amenity ID (e.g., crossbusiness.techfeatures.wifi.freewifi, crossbusiness.payments.creditcard)"
},
...
],
"price_score": "Integer - Price level score",
"max_price_score": "Integer - Maximum price score",
"price": "String - Price indicator (e.g., $$)",
"timezone": "String - Place timezone (e.g., America/Chicago)",
"open_state": "String - Current open state (e.g., Open 24 hrs, Open till 19:00, Closed, Closing Soon)",
"weekly_hours": {
"monday": [
"String - Time range (e.g., 07:00 - 19:00, Open 24 hrs)",
...
],
"tuesday": [...],
"wednesday": [...],
"thursday": [...],
"friday": [...],
"saturday": [...],
"sunday": [...]
},
"type": "String - Primary place type",
"type_id": "String - Primary place type ID",
"types": [
"String - Place type (e.g., Dining, Coffee Shop, Cafe)",
...
],
"type_ids": [
"String - Place type ID",
...
],
"actions": [
{
"title": "String - Action title (e.g., Order, Menu, Delivery, Pickup)",
"link": [
"String - URL to perform the action",
...
]
},
...
],
"order_online": "String - URL to order online",
"images": [
{
"title": "String - Image caption",
"thumbnail": "String - URL to the image thumbnail",
"category_id": "String - Category ID of the image (e.g., foodanddrink)",
"category_name": "String - Category name of the image (e.g., Food & Drink)",
"attribution": {
"name": "String - Image source name (e.g., Foursquare, Yelp, Apple)",
"link": "String - URL to view the image at the source"
}
},
...
],
"user_reviews": {
"attribution": {
"vendor_id": "String - Review provider vendor ID",
"name": "String - Review provider name",
"external_item_id": "String - External identifier at the provider",
"link": "String - URL to the provider page",
"logo_url": "String - URL to provider logo",
"serpapi_yelp_place_link": "String - URL to SerpApi Yelp place search", // if vendor is Yelp
"serpapi_yelp_reviews_link": "String - URL to SerpApi Yelp reviews search", // if vendor is Yelp
"serpapi_tripadvisor_place_link": "String - URL to SerpApi TripAdvisor place search", // if vendor is TripAdvisor
"serpapi_tripadvisor_reviews_link": "String - URL to SerpApi TripAdvisor reviews search", // if vendor is TripAdvisor
},
"most_relevant": [
{
"username": "String - Reviewer username",
"rating": "Numeric - Review rating",
"max_rating": "Numeric - Maximum review rating",
"user_thumbnail": "String - URL to reviewer profile image",
"description": "String - Review text snippet",
"link": "String - URL to the full review",
"date": "String - Review timestamp",
"id": "String - Review ID"
},
...
]
},
"contained_place": {
"name": "String - Parent place name (e.g., mall, shopping center)",
"muid": "String - Parent place Apple Maps ID",
"provider_id": "Integer - Parent place provider ID",
"link": "String - URL to the parent place"
},
"located_in": "String - Name of the parent place",
"collection": [
{
"position": "Integer - Collection position",
"muid": "String - Collection Apple Maps ID",
"provider_id": "Integer - Collection provider ID",
"title": "String - Collection title",
"long_title": "String - Collection full title",
"description": "String - Collection description",
"item_description": "String - Description of the place within this collection",
"link": "String - URL to the collection source",
"apple_maps_link": "String - URL to the collection on Apple Maps",
"item_count": "Integer - Number of items in the collection",
"publisher": {
"id": "String - Publisher ID",
"provider_id": "String - Publisher provider ID",
"name": "String - Publisher name",
"subtitle": "String - Publisher subtitle",
"link": "String - URL to publisher website"
},
"photos": [
{
"link": "String - URL to the photo",
"width": "Integer - Photo width in pixels",
"height": "Integer - Photo height in pixels",
"author": "String - Photo author name"
},
...
],
"items": [
{
"muid": "String - Place Apple Maps ID",
"provider_id": "Integer - Place provider ID",
"link": "String - URL to the place on Apple Maps"
},
...
]
},
...
],
"facts": [
{
"title": "String - Fact title",
"number": "Numeric - Fact numeric value",
"unit": "String - Fact unit",
"place_muid": "String - Related place MUID",
"place_provider_id": "String - Related place provider ID",
"place_link": "String - URL to the related place on Apple Maps",
"place_name": "String - Related place name"
},
...
],
"text": {
"attribution": {
"vendor_id": "String - Data provider vendor ID",
"name": "String - Data provider name",
"external_item_id": "String - External identifier at the provider",
"link": "String - URL to the provider page",
"logo_url": "String - URL to provider logo",
"snippet_logo_url": "String - URL to provider snippet logo",
"serpapi_yelp_place_link": "String - URL to SerpApi Yelp place search", // if vendor is Yelp
"serpapi_tripadvisor_place_link": "String - URL to SerpApi TripAdvisor place search", // if vendor is TripAdvisor
},
"title": "String - Text block title",
"value": "String - Text block value",
"attribution_url": "String - Text block attribution URL"
},
"attribution": {
"vendor_id": "String - Data provider vendor ID",
"name": "String - Data provider name",
"external_item_id": "String - External identifier at the provider",
"link": "String - URL to the provider page",
"logo_url": "String - URL to provider logo",
"snippet_logo_url": "String - URL to provider snippet logo",
"serpapi_yelp_place_link": "String - URL to SerpApi Yelp place search", // if vendor is Yelp
"serpapi_tripadvisor_place_link": "String - URL to SerpApi TripAdvisor place search", // if vendor is TripAdvisor
}
},
...
],
"guide_results": [
{
"position": "Integer - Guide position",
"position_in_page": "Integer - Guide position on the page",
"muid": "String - Guide Apple Maps ID",
"provider_id": "Integer - Guide provider ID",
"title": "String - Guide title",
"long_title": "String - Guide full title",
"description": "String - Guide description",
"link": "String - URL to the guide source",
"apple_maps_link": "String - URL to the guide on Apple Maps",
"item_count": "Integer - Number of places in the guide",
"publisher": {
"id": "String - Publisher ID",
"provider_id": "String - Publisher provider ID",
"name": "String - Publisher name",
"subtitle": "String - Publisher subtitle",
"link": "String - URL to publisher website"
},
"photos": [
{
"link": "String - URL to the photo",
"width": "Integer - Photo width in pixels",
"height": "Integer - Photo height in pixels",
"author": "String - Photo author name"
},
...
],
"items": [
{
"muid": "String - Place Apple Maps ID",
"provider_id": "Integer - Place provider ID",
"link": "String - URL to the place on Apple Maps"
},
...
]
},
...
]
}