Logo SearchApi

Apple Maps Guides API

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

Apple Maps Guides API returns a full editorial guide (a curated place collection) for a guide_id returned by the Apple Maps API: the guide's title, description, publisher, and cover photos, plus every place with its full details and the guide's editorial description of it, sourced to the publisher's own article.

API Parameters

Guide

  • Name
    guide_id
    Required
    Required
    Description

    The numeric identifier of the guide to fetch, returned as guide_id in the guide_results of the Apple Maps API (e.g. 15492827070352335266). It also appears as the curated query parameter of maps.apple.com/guides URLs.

Localization

  • Name
    lang
    Required
    Optional
    Description

    Defines the language the guide and place details are returned in. Check the full list of supported lang values. Defaults to en.

  • Name
    country
    Required
    Optional
    Description

    Parameter defines the country where the request 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_guides.

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

Guide with Places

Guide with Places
GET
https://www.searchapi.io/api/v1/search?engine=apple_maps_guides&guide_id=15492827070352335266
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "apple_maps_guides",
  "guide_id": "15492827070352335266"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_MJQGykEzoKXOSLPY3aB6bl2N",
    "status": "Success",
    "created_at": "2026-06-10T20:40:14Z",
    "request_time_taken": 2.6,
    "parsing_time_taken": 0.09,
    "total_time_taken": 2.69,
    "request_url": "https://maps.apple.com/guides?curated=15492827070352335266&_provider=9902",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_MJQGykEzoKXOSLPY3aB6bl2N.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_MJQGykEzoKXOSLPY3aB6bl2N"
  },
  "search_parameters": {
    "engine": "apple_maps_guides",
    "guide_id": "15492827070352335266",
    "country": "us",
    "lang": "en"
  },
  "guide": {
    "guide_id": "15492827070352335266",
    "provider_id": "9902",
    "title": "Best Pizza in New York City",
    "long_title": "Best Pizza in New York City",
    "description": "While there’s a specific joy in walking down the street with a folded slice of pizza, these are the spots for when you want to linger over your pie.",
    "language": "en-US",
    "date_modified": "2024-10-08T19:28:02Z",
    "link": "https://maps.apple.com/guides?curated=15492827070352335266&_provider=9902",
    "direct_link": "https://www.opentable.com/blog/best-pizza-nyc/?utm_source=guidediscovery&utm_medium=applemaps&utm_campaign=applemapguidesus",
    "publisher": {
      "publisher_id": "14597610067619911255",
      "provider_id": "9902",
      "title": "OpenTable",
      "subtitle": "Restaurants & Reservations",
      "link": "https://opentable.com",
      "guides_count": 284
    },
    "media_link": {
      "app_id": "296581815",
      "type": "app"
    },
    "images": [
      {
        "source": "Credit: Emmy Squared",
        "original": {
          "link": "https://is1-ssl.mzstatic.com/image/thumb/QWnZ_aceHVxatb1xhFtw5w/3000x2250w.jpg",
          "width": 3000,
          "height": 2250
        },
        "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/QWnZ_aceHVxatb1xhFtw5w/1200x800.jpg"
      },
      "..."
    ],
    "places_count": 5
  },
  "place_results": [
    {
      "position": 1,
      "place_id": "IF66AB50C137AE4E0",
      "provider_id": "9902",
      "title": "Scarr’s Pizza",
      "link": "https://maps.apple.com/place?place-id=IF66AB50C137AE4E0&_provider=9902",
      "description": {
        "text": "Among pizza aficionados in New York, Scarr’s is legendary, which is saying a lot considering the restaurant only opened in 2016. Head here for an unconventional New York slice with a sturdy yet airy crust and a bright sauce all created by owner Scarr Pimentel. He grew up in Hamilton Heights and came up in the kitchens of local favorites like Emilio’s Ballato, Artichoke Basille’s, and Lombardi’s, so you know his pies are next-level.",
        "source": {
          "name": "OpenTable",
          "link": "https://www.opentable.com/r/scarrs-pizza-new-york?utm_source=guidediscovery&utm_medium=applemaps&utm_campaign=applemapguidesus"
        }
      },
      "address": "35 Orchard St, New York, NY 10002, United States",
      "structured_address": {
        "short": "35 Orchard St, 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": "10002",
        "sub_locality": "Manhattan",
        "sub_thoroughfare": "35",
        "thoroughfare": "Orchard St",
        "full_thoroughfare": "35 Orchard St",
        "dependent_locality": [
          "LoDel",
          "..."
        ],
        "formatted_lines": [
          "35 Orchard St",
          "..."
        ]
      },
      "rating": 86,
      "max_rating": 100,
      "rating_type": "apple_rating",
      "rating_source": "Apple",
      "reviews": 279,
      "subratings": [
        {
          "category": "Atmosphere",
          "rating": 86,
          "max_rating": 100,
          "reviews": 201
        },
        "..."
      ],
      "phone": "+12123343481",
      "phone_formatted": "+1 (212) 334-3481",
      "website": "https://www.scarrspizza.com",
      "gps_coordinates": {
        "latitude": 40.7157392,
        "longitude": -73.9915788
      },
      "type": "New York-Style Pizza Restaurant",
      "type_id": "new_york_style_pizza_restaurant",
      "type_path": "dining.restaurant.pizza_restaurant.new_york_style_pizza_restaurant",
      "types": [
        "Dining",
        "..."
      ],
      "type_ids": [
        "dining",
        "..."
      ],
      "open_state": "open",
      "open_hours": {
        "monday": [
          "11:30–23:00",
          "..."
        ],
        "tuesday": [
          "11:30–23:00",
          "..."
        ],
        "wednesday": [
          "11:30–23:00",
          "..."
        ],
        "thursday": [
          "11:30–23:00",
          "..."
        ],
        "friday": [
          "11:30–24:00",
          "..."
        ],
        "saturday": [
          "00:00–01:00",
          "..."
        ],
        "sunday": [
          "00:00–01:00",
          "..."
        ]
      },
      "timezone": "America/New_York",
      "actions": [
        {
          "text": "Order",
          "link": "https://www.ubereats.com/wrapper/apple-maps/scarrs-pizza/V2ejYLBrVDysv3jJrQBXVQ",
          "type": "app_clip_link"
        },
        "..."
      ],
      "external_ids": [
        {
          "vendor_id": "com.apple",
          "id": "45347005420011673"
        },
        "..."
      ],
      "images": [
        {
          "title": "Eggplant Parm App",
          "source": "Apple Business Register",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/5dRyCpecEyeniR7mQxeAyQ/3000x2000bb.jpg",
            "width": 3000,
            "height": 2000
          },
          "category_id": "from_owner",
          "category_name": "From the Business",
          "date_added": "2026-01-28T03:24:38Z",
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/5dRyCpecEyeniR7mQxeAyQ/320x320bb.jpg"
        },
        "..."
      ],
      "editorial_photos": [
        {
          "source": "Credit: Scarr’s",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/uW-QK5LafBxmY8vqhsPBTA/1242x930w.jpg",
            "width": 1242,
            "height": 930
          },
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/uW-QK5LafBxmY8vqhsPBTA/1200x800.jpg"
        }
      ]
    },
    "..."
  ]
}