Logo SearchApi

Apple Maps API

GET   /api/v1/search?engine=apple_maps
OpenAPI Initiative Download OpenAPI Spec

Apple Maps API returns real-time local search results from Apple Maps in a structured JSON format. For every place it provides details such as the title, category, address, phone number, website, rating, opening hours, and GPS coordinates.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    This parameter is used for the terms you want to search on Apple Maps. Queries can include terms like "restaurants near me" or "Starbucks New York".

Geographic Location

  • Name
    location
    Required
    Optional
    Description

    Defines the search origin by name. The location is resolved to GPS coordinates using the locations API (e.g. Manhattan, New York, United States). See the full list of supported locations. center and location can't be used together. When neither is provided, the search covers the whole world.

  • Name
    center
    Required
    Optional
    Description

    Defines the coordinates of the center point of the region to search within, in the latitude,longitude format (e.g. 40.712776,-74.005974 for New York, NY). center and location can't be used together. When neither is provided, the search covers the whole world.

  • Name
    zoom
    Required
    Optional
    Description

    Defines how zoomed in the search region is, as an integer from 1 (widest area) to 20 (street level). Higher values search a smaller, more local area. When omitted, the default span applies.

  • Name
    span
    Required
    Optional
    Description

    Defines the exact size of the search area as two values in degrees: its north-south size, then its east-west size (e.g. 0.1,0.15 searches an area 0.1° tall and 0.15° wide). Both values must be greater than 0, with the north-south size up to 180 and the east-west size up to 360. Use this instead of zoom when you need precise control or a non-square area. If both span and zoom are provided, span is used. Defaults to 0.35,0.35 (a local area) when a center or location is set, or 180,360 (the whole world) when there is no anchor.

Filtering

  • Name
    filters
    Required
    Optional
    Description

    Refines results using the filters available for a search. Pass a comma-separated list of values taken from the filters array of a previous response (e.g. OPEN_NOW,PRICE_RANGE_INEXPENSIVE). Treat the values as opaque tokens and pass them back exactly as returned.

  • Name
    sort_by
    Required
    Optional
    Description

    Defines the sort order. One of distance (nearest first), ratings (highest rated first), or best_match (Apple's default ranking). Defaults to best_match.

  • Name
    open_at
    Required
    Optional
    Description

    Limits results to places open at a specific time. Accepts a time of day for today (18:00), a datetime (2026-06-04T18:00:00), or a datetime with a UTC offset (2026-06-04T18:00:00-05:00 or 2026-06-04T18:00:00Z). A time of day or offset-less datetime is interpreted in the timezone of the searched area; an explicit offset takes precedence. The resolved time must be in the future and no more than 24 hours from now.

Localization

  • Name
    lang
    Required
    Optional
    Description

    Defines the interface language of the search. Check the full list of supported lang values. Defaults to en.

  • Name
    country
    Required
    Optional
    Description

    Parameter defines the country where the search is coming from. Apple uses it to localize region-specific content, such as rating providers and formats. Check the full list of supported country values. Defaults to us.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to apple_maps.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Search by Coordinates

Search by Coordinates
GET
https://www.searchapi.io/api/v1/search?center=40.712776%2C-74.005974&engine=apple_maps&q=McDonald%27s&zoom=12
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "apple_maps",
  "q": "McDonald's",
  "center": "40.712776,-74.005974",
  "zoom": 12
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_GCJeQpyuYRdn1CtTaMIP1Oq9",
    "status": "Success",
    "created_at": "2026-06-03T11:26:09Z",
    "request_time_taken": 2.78,
    "parsing_time_taken": 0.07,
    "total_time_taken": 2.85,
    "request_url": "https://maps.apple.com/search?center=40.712776%2C-74.005974&query=McDonald%27s&span=0.087890625%2C0....",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_fngf2GzSmGIWXXqOc8AK5MLk.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_1xpwWqPwOKNnzNBGJ5SpeCV3"
  },
  "search_parameters": {
    "engine": "apple_maps",
    "q": "McDonald's",
    "center": "40.712776,-74.005974",
    "center_used": "40.712776,-74.005974",
    "zoom": 12,
    "country": "us",
    "lang": "en"
  },
  "search_information": {
    "query_displayed": "McDonald's",
    "total_results": 18
  },
  "local_results": [
    {
      "position": 1,
      "place_id": "I65264D3B30CE06B3",
      "provider_id": "9902",
      "title": "McDonald's",
      "link": "https://maps.apple.com/place?place-id=I65264D3B30CE06B3&_provider=9902",
      "address": "160 Broadway, New York, NY 10038, United States",
      "structured_address": {
        "short": "160 Broadway, New York",
        "city_and_above": "New York, NY United States",
        "country": "United States",
        "country_code": "US",
        "administrative_area": "New York",
        "administrative_area_code": "NY",
        "sub_administrative_area": "New York County",
        "locality": "New York",
        "post_code": "10038",
        "sub_locality": "Manhattan",
        "sub_thoroughfare": "160",
        "thoroughfare": "Broadway",
        "full_thoroughfare": "160 Broadway",
        "dependent_locality": [
          "Manhattan",
          "Financial District",
          "Civic Center",
          "North Hudson"
        ],
        "formatted_lines": [
          "160 Broadway",
          "New York, NY 10038",
          "United States"
        ]
      },
      "neighborhood": "Financial District, Manhattan",
      "rating": 65,
      "max_rating": 100,
      "rating_type": "apple_rating",
      "rating_source": "Apple",
      "reviews": 111,
      "reviews_formatted": "111",
      "subratings": [
        {
          "category": "Customer Service",
          "rating": 59,
          "max_rating": 100,
          "reviews": 98
        },
        ...
      ],
      "phone": "+12123852066",
      "phone_formatted": "+1 (212) 385-2066",
      "website": "https://www.mcdonalds.com/us/en-us/location/ny/new-york/160-broadway/10528.html",
      "claim_listing_link": "https://business.apple.com/?claimId=7288597963562944179",
      "gps_coordinates": {
        "latitude": 40.7094789,
        "longitude": -74.0100364
      },
      "bounds": {
        "north_latitude": 40.7139755,
        "south_latitude": 40.7049822,
        "east_longitude": -74.0041044,
        "west_longitude": -74.0159683
      },
      "access_points": [
        {
          "gps_coordinates": {
            "latitude": 40.7094991,
            "longitude": -74.0102155
          },
          "driving_direction": "destination",
          "walking_direction": "entry_exit",
          "source": "access_point_service_curated"
        }
      ],
      "type": "Fast Food Restaurant",
      "type_id": "fast_food_restaurant",
      "type_path": "dining.restaurant.fast_food_restaurant",
      "types": [
        "Dining",
        ...
      ],
      "type_ids": [
        "dining",
       ...
      ],
      "open_state": "open_24_hours",
      "open_hours": {
        "monday": [
          "00:00–24:00"
        ],
        ...
      },
      "linked_services": [
        {
          "name": "Delivery Service",
          "open_hours": {
            "monday": [
              "00:00–04:00",
              "04:10–24:00"
            ],
            ...
          }
        },
        ...
      ],
      "timezone": "America/New_York",
      "actions": [
        {
          "text": "Order",
          "link": "https://m.yelp.com/opportunity/mcdonalds-new-york-386",
          "type": "app_clip_link"
        },
        ...
      ],
      "amenities": [
        {
          "amenity_id": "crossbusiness.payments.applepay",
          "title": "Accepts Apple Pay"
        },
        ...
      ],
      "external_ids": [
        {
          "vendor_id": "com.apple",
          "id": "125220359"
        },
        ...
      ],
      "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/rFcAhqX5D2kkzp-WP_8TPA/320x320bb.jpg",
      "cover_photo": "https://is2-ssl.mzstatic.com/image/thumb/k-QXHufydVmlBrwn04lsTw/1600x1040.png",
      "logo": "https://is2-ssl.mzstatic.com/image/thumb/mVYKT9VRPiBilo6ZK3AAFw/258x258.png",
      "images": [
        {
          "source": "Apple Business Register",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/rFcAhqX5D2kkzp-WP_8TPA/2998x2998bb.jpg",
            "width": 2998,
            "height": 2998
          },
          "category_id": "from_owner",
          "category_name": "From the Business",
          "date_added": "2023-12-08T15:58:59Z",
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/rFcAhqX5D2kkzp-WP_8TPA/320x320bb.jpg"
        },
        ...
      ]
    },
    ...
  ],
  "filters": [
    {
      "key": "drive_thru",
      "type": "Drive-Thru",
      "options": [
        {
          "text": "Drive-Thru",
          "value": "DRIVE_THRU"
        }
      ]
    },
    {
      "key": "wheelchair_accessible",
      "type": "Wheelchair Accessible",
      "options": [
        {
          "text": "Wheelchair Accessible",
          "value": "WHEELCHAIR_ACCESSIBLE"
        }
      ]
    },
    ...
  ]
}

Search by Location

Search by Location
GET
https://www.searchapi.io/api/v1/search?engine=apple_maps&location=Manhattan%2C+New+York%2C+United+States&q=bookstore
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "apple_maps",
  "q": "bookstore",
  "location": "Manhattan, New York, United States"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_4sBhdAOabCKmcC9yOWlZa9L9",
    "status": "Success",
    "created_at": "2026-06-03T11:26:47Z",
    "request_time_taken": 3.06,
    "parsing_time_taken": 0.05,
    "total_time_taken": 3.1,
    "request_url": "https://maps.apple.com/search?center=40.7830603%2C-73.9712488&query=bookstore&span=0.35%2C0.35",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_8PU7E5FDKz1CtqJlNEWCzmUb.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_FJflPzrViQeigQm4ozg8ZSAv"
  },
  "search_parameters": {
    "engine": "apple_maps",
    "q": "bookstore",
    "location": "Manhattan, New York, United States",
    "location_used": "Manhattan",
    "center_used": "40.7830603,-73.9712488",
    "span": "0.35,0.35",
    "country": "us",
    "lang": "en"
  },
  "search_information": {
    "query_displayed": "bookstore",
    "total_results": 25
  },
  "local_results": [
    {
      "position": 1,
      "place_id": "IAC03E55D0E3BA74F",
      "provider_id": "9902",
      "title": "Strand",
      "link": "https://maps.apple.com/place?place-id=IAC03E55D0E3BA74F&_provider=9902",
      "description": {
        "text": "The Strand Bookstore is an independent bookstore located at 828 Broadway, at the corner of East 12th Street in the East Village neighborhood of Manhattan, New York City, two blocks south of Union Square. In addition to the main location, the store's Central Park kiosk is open on fair weather days at the corner of Fifth Avenue and East 60th Street. The company's slogan is \"18 Miles Of Books\", as featured on its stickers, T-shirts, and other merchandise.",
        "source": {
          "name": "Wikipedia",
          "link": "https://en.wikipedia.org/wiki/Strand_Bookstore"
        }
      },
      "address": "828 Broadway, New York, NY  10003, United States",
      "structured_address": {
        "short": "828 Broadway, New York",
        "city_and_above": "New York, NY United States",
        "country": "United States",
        "country_code": "US",
        "administrative_area": "New York",
        "administrative_area_code": "NY",
        "sub_administrative_area": "New York County",
        "locality": "New York",
        "post_code": "10003",
        "sub_locality": "Manhattan",
        "sub_thoroughfare": "828",
        "thoroughfare": "Broadway",
        "full_thoroughfare": "828 Broadway",
        "dependent_locality": [
          "East Village",
          "Gramercy-Flatiron",
          "Manhattan",
          "North Hudson"
        ],
        "formatted_lines": [
          "828 Broadway",
          "New York, NY  10003",
          "United States"
        ]
      },
      "neighborhood": "East Village, Manhattan",
      "rating": 92,
      "max_rating": 100,
      "rating_type": "apple_rating",
      "rating_source": "Apple",
      "reviews": 318,
      "subratings": [
        {
          "category": "Products",
          "rating": 97,
          "max_rating": 100,
          "reviews": 271
        },
        ...
      ],
      "phone": "+12124731452",
      "phone_formatted": "+1 (212) 473-1452",
      "website": "https://www.strandbooks.com",
      "claim_listing_link": "https://business.apple.com/?claimId=12395002787287246671",
      "gps_coordinates": {
        "latitude": 40.7332548,
        "longitude": -73.9909244
      },
      "bounds": {
        "north_latitude": 40.7377514,
        "south_latitude": 40.7287581,
        "east_longitude": -73.9849902,
        "west_longitude": -73.9968585
      },
      "access_points": [
        {
          "gps_coordinates": {
            "latitude": 40.7332914,
            "longitude": -73.9910531
          },
          "walking_direction": "entry_exit",
          "source": "gemini_curated"
        },
        ...
      ],
      "type": "Bookstore",
      "type_id": "bookstore",
      "type_path": "shopping.store.bookstore",
      "types": [
        "Shopping",
        ...
      ],
      "type_ids": [
        "shopping",
        ...
      ],
      "open_state": "open",
      "open_hours": {
        "monday": [
          "10:00–21:00"
        ],
        "tuesday": [
          "10:00–21:00"
        ],
        "wednesday": [
          "10:00–21:00"
        ],
        "thursday": [
          "10:00–21:00"
        ],
        "friday": [
          "10:00–21:00"
        ],
        "saturday": [
          "10:00–21:00"
        ],
        "sunday": [
          "10:00–21:00"
        ]
      },
      "timezone": "America/New_York",
      "actions": [
        {
          "text": "Tickets",
          "link": "https://eventseeker.com/venue/19749-strand-book-store-new-york#events",
          "type": "quick_link"
        },
        {
          "text": "Order",
          "link": "https://www.yelp.com/menu/strand-bookstore-new-york?utm_campaign=action_link_view_menu&utm_medium=feed_v2&utm_source=apple",
          "type": "quick_link"
        }
      ],
      "amenities": [
        {
          "amenity_id": "crossbusiness.payments.applepay",
          "title": "Accepts Apple Pay",
          "vendor_id": "com.yelp"
        },
        ...
      ],
      "external_ids": [
        {
          "vendor_id": "com.apple",
          "id": "125203599"
        },
        ...
      ],
      "thumbnail": "https://ir.4sqi.net/img/general/450x600/32896998_H0fbFTSGTmScG1W6z625h30OMeCfI82a4IDPHLAOAj8.jpg",
      "images": [
        {
          "source": "Foursquare",
          "link": "https://foursquare.com/mapaction?id=4a8cc1d4f964a520130f20e3&component=photo&cid=61881f026d9bf31219b2cd3a&action=view&language=en-US",
          "thumbnail": "https://ir.4sqi.net/img/general/450x600/32896998_H0fbFTSGTmScG1W6z625h30OMeCfI82a4IDPHLAOAj8.jpg"
        },
        ...
      ],
      "guides": [
        {
          "guide_id": "11761143412680185416",
          "provider_id": "9902",
          "title": "Where To Go Shopping in New York City",
          "long_title": "Where To Go Shopping in New York City",
          "description": "New York City has it all, including some of the best shopping in the world. This NYC shopping guide will help you figure out where to find exactly what you’re looking for, whether it’s vintage cowboy boots, Barbies, designer labels, or otherwise.",
          "review_snippet": "Ask New Yorkers where they buy their books, and they’ll tell you The Strand, an independent bookstore that’s been in business for nearly a century. It has both new and used books, apparel, gifts, and even rare and collectible books. You can even sell any books you have lying around (on Thursdays, Fridays, and Saturdays from 10am to 4pm). Located on the Upper West Side, it’s easy to pop in here and browse after a visit to Central Park or the nearby American Museum of Natural History.",
          "date_modified": "2025-07-29T17:05:59Z",
          "link": "https://maps.apple.com/guides?curated=11761143412680185416&_provider=9902",
          "direct_link": "https://www.viator.com/blog/Top-Shopping-Spots-in-New-York-City/l50062?mcid=68067",
          "publisher": {
            "publisher_id": "13555729779554363226",
            "provider_id": "9902",
            "title": "Viator",
            "subtitle": "Tours & Experiences",
            "source": "com.viator",
            "link": "https://www.viator.com",
            "guides_count": 402
          },
          "images": [
            {
              "source": "Resul Muslu / Shutterstock",
              "original": {
                "link": "https://is1-ssl.mzstatic.com/image/thumb/Hp0ylJRtRHl7bx89lpfy1g/1242x930w.jpg",
                "width": 1242,
                "height": 930
              },
              "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/Hp0ylJRtRHl7bx89lpfy1g/1200x800.jpg"
            }
          ],
          "places_count": 9
        },
        ...
      ]
    }
  ],
  "guide_results": [
    {
      "position": 1,
      "guide_id": "1511830311679360722",
      "provider_id": "9902",
      "title": "New York City's top bookstores ",
      "long_title": "New York City's top bookstores ",
      "description": "From huge chain stores that extend city blocks to small mom and pop establishments, New York City is a bookstores' haven. Bookworms can peruse countless aisles or attend a panel from the top authors in the business.",
      "date_modified": "2021-11-29T22:41:15Z",
      "link": "https://maps.apple.com/guides?curated=1511830311679360722&_provider=9902",
      "direct_link": "https://www.lonelyplanet.com/usa/new-york-city",
      "publisher": {
        "publisher_id": "9347124461831285753",
        "provider_id": "9902",
        "title": "Lonely Planet",
        "subtitle": "Explore every day",
        "source": "com.lonelyplanet",
        "link": "https://www.lonelyplanet.com/",
        "guides_count": 53
      },
      "images": [
        {
          "source": "©Drop of Light/Shutterstock",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/GeMeNSC9YQawDFTR94JSpw/2000x1333w.jpg",
            "width": 2000,
            "height": 1333
          },
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/GeMeNSC9YQawDFTR94JSpw/1200x800.jpg"
        },
        "..."
      ],
      "places_count": 9,
      "places": [
        {
          "place_id": "I97BA64A70C2245FA",
          "provider_id": "9902",
          "link": "https://maps.apple.com/place?place-id=I97BA64A70C2245FA&_provider=9902"
        },
        "..."
      ]
    },
    "..."
  ],
  "filters": [
    {
      "key": "top_rated",
      "type": "Top Rated",
      "options": [
        {
          "text": "Top Rated",
          "value": "TOP_RATED"
        }
      ]
    },
    {
      "key": "price",
      "type": "All Prices",
      "options": [
        {
          "text": "$",
          "value": "PRICE_RANGE_INEXPENSIVE"
        },
        ...
      ]
    },
    ...
  ]
}

Place Result

Place Result

Every result carries a place_id. To pull the full detail set for one or more places in a single call (passing those ids directly), use the Apple Maps Places API (engine=apple_maps_places).

GET
https://www.searchapi.io/api/v1/search?engine=apple_maps&location=Manhattan%2C+New+York%2C+United+States&q=Eleven+Madison+Park
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "apple_maps",
  "q": "Eleven Madison Park",
  "location": "Manhattan, New York, United States"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "local_results": [
    {
      "position": 1,
      "place_id": "I4C5D0BEB8750BD1B",
      "provider_id": "9902",
      "title": "Eleven Madison Park",
      "link": "https://maps.apple.com/place?place-id=I4C5D0BEB8750BD1B&_provider=9902",
      "description": {
        "text": "Chef Daniel Humm presides over this temple of modern elegance with a zealous dedication to masterful precision. Nothing is out of place and everything is custom made, from the staff’s suits to the handblown water vases. The menu’s plant-based creations are a bold vision of luxury dining and elevates the concept to unparalleled heights. The freshly baked, delicately crisped vegan roll presented with faux butter is a magical creation. A quenelle of tonburi, mimicking caviar, plated with horseradish cream and accompanied by a radish tostada with a swipe of pumpkin seed butter is simply stunning. The ever-evolving Eleven Madison Park also offers diners the choice of supplementing their meal with a few animal protein courses.",
        "source": {
          "name": "Michelin",
          "link": "https://guide.michelin.com/r/68335"
        }
      },
      "address": "11 Madison Ave, New York, NY 10010, United States",
      "structured_address": {
        "short": "11 Madison Ave, New York",
        "city_and_above": "New York, NY United States",
        "country": "United States",
        "country_code": "US",
        "administrative_area": "New York",
        "administrative_area_code": "NY",
        "locality": "New York",
        "post_code": "10010",
        "sub_locality": "Manhattan",
        "sub_thoroughfare": "11",
        "thoroughfare": "Madison Ave",
        "full_thoroughfare": "11 Madison Ave",
        "formatted_lines": [
          "11 Madison Ave",
          "New York, NY 10010",
          "United States"
        ]
      },
      "neighborhood": "Flatiron, Manhattan",
      "rating": 4.4,
      "max_rating": 5,
      "rating_type": "user_rating",
      "rating_source": "Tripadvisor",
      "reviews": 2781,
      "reviews_formatted": "2.8K",
      "user_reviews": {
        "source": "Tripadvisor",
        "most_relevant": [
          {
            "username": "KennethPages",
            "rating": 4,
            "max_rating": 5,
            "user_thumbnail": "https://media-cdn.tripadvisor.com/media/photo-l/07/ad/be/81/kenneth-p.jpg",
            "description": "It's been many years since Ryne and I last went to EMP. I also believe we have only been there for lunch which was the case on our most recent visit. Though not the pure Vegan restaurant they had tran",
            "link": "http://www.tripadvisor.com/AppleMapsAction?id=479020&component=review&cid=1058050634&action=view&lan...",
            "iso_date": "2026-04-28T04:00:00Z",
            "id": "1058050634"
          },
          "..."
        ]
      },
      "phone": "+12128890905",
      "phone_formatted": "+1 (212) 889-0905",
      "website": "https://www.elevenmadisonpark.com",
      "is_unclaimed": true,
      "claim_listing_link": "https://business.apple.com/?claimId=5502567425932049691",
      "gps_coordinates": {
        "latitude": 40.7417296,
        "longitude": -73.9871156
      },
      "bounds": {
        "north_latitude": 40.7462262,
        "south_latitude": 40.7372329,
        "east_longitude": -73.9811807,
        "west_longitude": -73.9930504
      },
      "access_points": [
        {
          "gps_coordinates": {
            "latitude": 40.7418075,
            "longitude": -73.9873015
          },
          "driving_direction": "destination",
          "walking_direction": "entry_exit",
          "source": "access_point_service_curated"
        }
      ],
      "type": "Fine Dining Restaurant",
      "type_id": "fine_dining_restaurant",
      "type_path": "dining.restaurant.fine_dining_restaurant",
      "types": [
        "Dining",
        "Fine Dining Restaurant",
        "Restaurant",
        "American Cuisine",
        "Health Food Restaurant",
        "New American Cuisine",
        "Vegetarian Restaurant",
        "Vegan Restaurant"
      ],
      "type_ids": [
        "dining",
        "fine_dining_restaurant",
        "restaurant",
        "american_us_cuisine",
        "health_food_restaurant",
        "new_american_us_cuisine",
        "vegetarian_restaurant",
        "vegan_restaurant"
      ],
      "open_state": "closed",
      "open_hours": {
        "monday": [
          "17:00–22:30"
        ],
        "tuesday": [
          "17:00–22:30"
        ],
        "wednesday": [
          "17:00–22:30"
        ],
        "thursday": [
          "17:00–22:30"
        ],
        "friday": [
          "12:00–23:00"
        ],
        "saturday": [
          "12:00–23:00"
        ],
        "sunday": [
          "12:00–23:00"
        ]
      },
      "timezone": "America/New_York",
      "actions": [
        {
          "text": "Reserve",
          "link": "https://guide.michelin.com/r/68335",
          "type": "quick_link"
        },
        "..."
      ],
      "amenities": [
        {
          "amenity_id": "crossbusiness.payments.creditcard",
          "title": "Accepts Credit Cards",
          "vendor_id": "com.yelp"
        },
        "..."
      ],
      "awards": [
        {
          "name": "Three Stars",
          "source": "MICHELIN Guide",
          "vendor_id": "com.michelin"
        },
        "..."
      ],
      "external_ids": [
        {
          "vendor_id": "com.tripadvisor",
          "id": "479020"
        },
        {
          "vendor_id": "com.foursquare_v2",
          "id": "457ebeaaf964a5203f3f1fe3"
        },
        {
          "vendor_id": "com.foursquare",
          "id": "457ebeaaf964a5203f3f1fe3"
        },
        {
          "vendor_id": "com.apple",
          "id": "103416654"
        },
        {
          "vendor_id": "com.infatuation",
          "id": "002e38ff-c34a-46ff-a23d-27b5ae75b49e"
        },
        {
          "vendor_id": "com.michelin",
          "id": "restaurant-68335"
        }
      ],
      "thumbnail": "https://ir.4sqi.net/img/general/450x600/10937940_089uhD6lRjR97MCZcT-klgvjhPh_69Fkuh1ZDm0oW9o.jpg",
      "images": [
        {
          "source": "Foursquare",
          "link": "https://foursquare.com/mapaction?id=457ebeaaf964a5203f3f1fe3&component=photo&cid=4fca9b8de4b01dfc7f6a5acd&action=view&language=en-US",
          "category_id": "foodanddrink",
          "category_name": "Food & Drink",
          "thumbnail": "https://irs1.4sqi.net/img/general/600x600/jeLDGgtgd06kUhFB1RnDNINfDtqFLqTZ1o_XZiRD6M8.jpg"
        },
        "..."
      ],
      "guides": [
        {
          "guide_id": "18403638906619633184",
          "provider_id": "9902",
          "title": "All 3 Star Restaurants in New York City",
          "long_title": "All 3 Star MICHELIN Restaurants in New York City",
          "description": "New York. The city that never sleeps, the melting pot of America. Regardless of what you call it, one thing is true—New York is home to some of the most diverse restaurants in the world. Discover the 5 MICHELIN 3-Star restaurants in NYC.",
          "date_modified": "2026-03-13T09:48:37Z",
          "link": "https://maps.apple.com/guides?curated=18403638906619633184&_provider=9902",
          "direct_link": "https://guide.michelin.com/en/article/michelin-guide-ceremony/all-the-stars-in-the-michelin-guide-to...",
          "publisher": {
            "publisher_id": "4962323911681984986",
            "provider_id": "9902",
            "title": "MICHELIN Guide",
            "subtitle": "Curated restaurants & hotels",
            "source": "com.michelin",
            "link": "https://guide.michelin.com",
            "guides_count": 137
          },
          "images": [
            {
              "source": "Nigel Parry/Le Bernardin",
              "original": {
                "link": "https://is1-ssl.mzstatic.com/image/thumb/Zbre2_7K5l-fL2p_CVBCvg/3000x2250w.jpg",
                "width": 3000,
                "height": 2250
              },
              "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/Zbre2_7K5l-fL2p_CVBCvg/1200x800.jpg"
            },
            "..."
          ],
          "places_count": 5
        },
        "..."
      ]
    },
    "..."
  ]
}

Guide Result

Guide Result

Editorial guides appear under guide_results, each with a guide_id. To expand a guide into its full list of curated places, use the Apple Maps Guides API (engine=apple_maps_guides).

GET
https://www.searchapi.io/api/v1/search?center=40.544004%2C-74.055282&engine=apple_maps&q=pizza&span=0.676324%2C0.939881
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "apple_maps",
  "q": "pizza",
  "center": "40.544004,-74.055282",
  "span": "0.676324,0.939881"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "guide_results": [
    {
      "position": 1,
      "guide_id": "5374541315324508697",
      "provider_id": "9902",
      "title": "Zagat’s Top Pizza Restaurants in NYC",
      "long_title": "Zagat’s Top Pizza Restaurants in NYC",
      "description": "What are the best pizza places in the best pizza city in the world? These spots, says the Zagat 2020 NYC Survey. Find pizza delivery or takeout near you.",
      "date_modified": "2021-11-29T22:41:12Z",
      "link": "https://maps.apple.com/guides?curated=5374541315324508697&_provider=9902",
      "publisher": {
        "publisher_id": "3761625655810489457",
        "provider_id": "9902",
        "title": "Zagat",
        "subtitle": "User generated since 1979.",
        "source": "com.zagat",
        "guides_count": 3
      },
      "images": [
        {
          "source": "Emily Schindler",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/L1IlahHnf7pYTg7uU0B3EA/4924x3939w.jpg",
            "width": 4924,
            "height": 3939
          },
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/L1IlahHnf7pYTg7uU0B3EA/1200x800.jpg"
        }
      ],
      "places_count": 12,
      "places": [
        {
          "place_id": "I489A4573AE22CBCA",
          "provider_id": "9902",
          "link": "https://maps.apple.com/place?place-id=I489A4573AE22CBCA&_provider=9902"
        },
      ...
      ]
    },
  ...
  ]
}