Logo SearchApi

Apple Maps Places API

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

Apple Maps Places API returns full place details for one or more Apple Maps places in a single request. Pass the place_id values returned by the Apple Maps API and get back a place_results array with each place's title, category, address, phone number, website, rating, opening hours, amenities, photos, and GPS coordinates.

API Parameters

Places

  • Name
    place_ids
    Required
    Required
    Description

    A comma-separated list of up to 20 Apple Maps place identifiers to look up in a single request. Each value is a place_id returned by the Apple Maps API — the same identifier used in maps.apple.com place URLs, so you can also copy it from the place-id query parameter of any Apple Maps link (e.g. ID14FABEE6C8FC5A,IBB4C75E7EBE40E08). Identifiers that Apple can't resolve are echoed back in not_found_places, so place_results may contain fewer places than requested.

Localization

  • Name
    lang
    Required
    Optional
    Description

    Defines the language the 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. 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_places.

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

Place Details

Place Details
GET
https://www.searchapi.io/api/v1/search?engine=apple_maps_places&place_ids=ID14FABEE6C8FC5A
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "apple_maps_places",
  "place_ids": "ID14FABEE6C8FC5A"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_81zxXmPv3DdnFwq73VdOanD5",
    "status": "Success",
    "created_at": "2026-06-09T19:54:28Z",
    "request_time_taken": 1.75,
    "parsing_time_taken": 0.02,
    "total_time_taken": 1.77,
    "request_url": "https://maps.apple.com/place?place-id=ID14FABEE6C8FC5A",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_81zxXmPv3DdnFwq73VdOanD5.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_81zxXmPv3DdnFwq73VdOanD5"
  },
  "search_parameters": {
    "engine": "apple_maps_places",
    "place_ids": "ID14FABEE6C8FC5A",
    "country": "us",
    "lang": "en"
  },
  "place_results": [
    {
      "position": 1,
      "place_id": "ID14FABEE6C8FC5A",
      "provider_id": "9902",
      "title": "Google Visitor Experience",
      "link": "https://maps.apple.com/place?place-id=ID14FABEE6C8FC5A&_provider=9902",
      "address": "2000 N Shoreline Blvd, Mountain View, CA  94043, United States",
      "structured_address": {
        "short": "2000 N Shoreline Blvd, Mountain View",
        "city_and_above": "Mountain View, CA United States",
        "country": "United States",
        "country_code": "US",
        "administrative_area": "California",
        "administrative_area_code": "CA",
        "sub_administrative_area": "Santa Clara County",
        "locality": "Mountain View",
        "post_code": "94043",
        "sub_locality": "Shoreline",
        "sub_thoroughfare": "2000",
        "thoroughfare": "N Shoreline Blvd",
        "full_thoroughfare": "2000 N Shoreline Blvd",
        "dependent_locality": [
          "Shoreline",
          "..."
        ],
        "formatted_lines": [
          "2000 N Shoreline Blvd",
          "..."
        ]
      },
      "neighborhood": "Mountain View, CA",
      "rating": 79,
      "max_rating": 100,
      "rating_type": "apple_rating",
      "rating_source": "Apple",
      "reviews": 24,
      "reviews_formatted": "24",
      "phone": "+16506031828",
      "phone_formatted": "+1 (650) 603-1828",
      "website": "https://visit.withgoogle.com",
      "claim_listing_link": "https://business.apple.com/?claimId=942653919849938010",
      "gps_coordinates": {
        "latitude": 37.4218166,
        "longitude": -122.079374
      },
      "bounds": {
        "north_latitude": 37.4263132,
        "south_latitude": 37.4173199,
        "east_longitude": -122.073712,
        "west_longitude": -122.0850359
      },
      "access_points": [
        {
          "gps_coordinates": {
            "latitude": 37.4218684,
            "longitude": -122.0808124
          },
          "walking_direction": "entry_exit",
          "source": "basemap_curated"
        },
        "..."
      ],
      "type": "Visitor Center",
      "type_id": "visitor_center",
      "type_path": "travel_and_leisure.visitor_center",
      "types": [
        "Travel and Leisure",
        "..."
      ],
      "type_ids": [
        "travel_and_leisure",
        "..."
      ],
      "open_state": "open",
      "open_hours": {
        "monday": [
          "09:00–18:00",
          "..."
        ],
        "tuesday": [
          "09:00–18:00",
          "..."
        ],
        "wednesday": [
          "09:00–18:00",
          "..."
        ],
        "thursday": [
          "09:00–18:00",
          "..."
        ],
        "friday": [
          "09:00–18:00",
          "..."
        ],
        "saturday": [
          "09:00–18:00",
          "..."
        ],
        "sunday": [
          "10:00–17:00",
          "..."
        ]
      },
      "timezone": "America/Los_Angeles",
      "actions": [
        {
          "text": "Quote",
          "link": "https://www.yelp.com/raq/google-visitor-experience-mountain-view-5?utm_campaign=action_link_raq&utm_medium=feed_v2&utm_source=apple#popup:raq",
          "type": "quick_link"
        },
        "..."
      ],
      "amenities": [
        {
          "amenity_id": "crossbusiness.payments.applepay",
          "title": "Accepts Apple Pay",
          "vendor_id": "com.yelp"
        },
        "..."
      ],
      "external_ids": [
        {
          "vendor_id": "com.apple",
          "id": "54362378526000882"
        },
        "..."
      ],
      "images": [
        {
          "title": "Huddle",
          "source": "Yelp",
          "link": "http://yelp.com/apple_maps_action?id=28Vw90F6xgzE__iikX9pKg&component=photo&cid=6x9AxovRConhCBLWPBar9Q&action=view&language=en-US",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/CvidFytt0qT4CMojBZYcDw/0x0bb.jpg",
            "width": 0,
            "height": 0
          },
          "date_added": "2024-05-21T11:03:30Z",
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/CvidFytt0qT4CMojBZYcDw/320x320bb.jpeg"
        },
        "..."
      ],
      "guides": [
        {
          "guide_id": "9181564795503578159",
          "provider_id": "9902",
          "title": "Santa Clara Essentials",
          "long_title": "Santa Clara Essentials",
          "description": "Popular attractions and landmarks to explore, based on what people view, share, and interact with most on Apple Maps. The list updates over time, so save any places you want to revisit.",
          "date_modified": "2026-06-03T02:18:14Z",
          "link": "https://maps.apple.com/guides?curated=9181564795503578159&_provider=9902",
          "publisher": {
            "publisher_id": "10190490571777324232",
            "provider_id": "9902",
            "title": "Local Lists",
            "subtitle": "What's popular on Apple Maps",
            "source": "com.apple.lists",
            "guides_count": 880
          },
          "images": [
            {
              "original": {
                "link": "https://is1-ssl.mzstatic.com/image/thumb/KZ9O7kw1Vkd9KLeVsQmN0A/3600x2400w.jpg",
                "width": 3600,
                "height": 2400
              },
              "thumbnail": "https://media-cdn.tripadvisor.com/media/photo-o/16/e0/4f/e1/halloween-thrills-wait/1200x800.jpg"
            },
            "..."
          ],
          "places_count": 17
        },
        "..."
      ]
    }
  ]
}

Multiple Places

Multiple Places
GET
https://www.searchapi.io/api/v1/search?engine=apple_maps_places&place_ids=ID14FABEE6C8FC5A%2CIBB4C75E7EBE40E08%2CIFFFFFFFFFFFFFFFF
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "apple_maps_places",
  "place_ids": "ID14FABEE6C8FC5A,IBB4C75E7EBE40E08,IFFFFFFFFFFFFFFFF"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_nGJKwASNZuxUu2cl1JXdniOq",
    "status": "Success",
    "created_at": "2026-06-08T18:00:00Z",
    "request_time_taken": 1.94,
    "parsing_time_taken": 0.05,
    "total_time_taken": 1.99,
    "request_url": "https://maps.apple.com/data/place",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_Pkdiw8j6Yp0dhCZvlRm2ttrS.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_0YujORZvAH3EZpI51CWKsJCS"
  },
  "search_parameters": {
    "engine": "apple_maps_places",
    "place_ids": "ID14FABEE6C8FC5A,IBB4C75E7EBE40E08,IFFFFFFFFFFFFFFFF",
    "country": "us",
    "lang": "en"
  },
  "place_results": [
    {
      "position": 1,
      "place_id": "ID14FABEE6C8FC5A",
      "provider_id": "9902",
      "title": "Google Visitor Experience",
      "link": "https://maps.apple.com/place?place-id=ID14FABEE6C8FC5A&_provider=9902",
      "address": "2000 N Shoreline Blvd, Mountain View, CA  94043, United States",
      "structured_address": {
        "short": "2000 N Shoreline Blvd, Mountain View",
        "city_and_above": "Mountain View, CA United States",
        "country": "United States",
        "country_code": "US",
        "administrative_area": "California",
        "administrative_area_code": "CA",
        "sub_administrative_area": "Santa Clara County",
        "locality": "Mountain View",
        "post_code": "94043",
        "sub_locality": "Shoreline",
        "sub_thoroughfare": "2000",
        "thoroughfare": "N Shoreline Blvd",
        "full_thoroughfare": "2000 N Shoreline Blvd",
        "dependent_locality": [
          "Shoreline",
          "..."
        ],
        "formatted_lines": [
          "2000 N Shoreline Blvd",
          "..."
        ]
      },
      "neighborhood": "Mountain View, CA",
      "rating": 79,
      "max_rating": 100,
      "rating_type": "apple_rating",
      "rating_source": "Apple",
      "reviews": 24,
      "reviews_formatted": "24",
      "phone": "+16506031828",
      "phone_formatted": "+1 (650) 603-1828",
      "website": "https://visit.withgoogle.com",
      "claim_listing_link": "https://business.apple.com/?claimId=942653919849938010",
      "gps_coordinates": {
        "latitude": 37.4218166,
        "longitude": -122.079374
      },
      "bounds": {
        "north_latitude": 37.4263132,
        "south_latitude": 37.4173199,
        "east_longitude": -122.073712,
        "west_longitude": -122.0850359
      },
      "access_points": [
        {
          "gps_coordinates": {
            "latitude": 37.4218684,
            "longitude": -122.0808124
          },
          "walking_direction": "entry_exit",
          "source": "basemap_curated"
        },
        "..."
      ],
      "type": "Visitor Center",
      "type_id": "visitor_center",
      "type_path": "travel_and_leisure.visitor_center",
      "types": [
        "Travel and Leisure",
        "..."
      ],
      "type_ids": [
        "travel_and_leisure",
        "..."
      ],
      "open_state": "open",
      "open_hours": {
        "monday": [
          "09:00–18:00",
          "..."
        ],
        "tuesday": [
          "09:00–18:00",
          "..."
        ],
        "wednesday": [
          "09:00–18:00",
          "..."
        ],
        "thursday": [
          "09:00–18:00",
          "..."
        ],
        "friday": [
          "09:00–18:00",
          "..."
        ],
        "saturday": [
          "09:00–18:00",
          "..."
        ],
        "sunday": [
          "10:00–17:00",
          "..."
        ]
      },
      "timezone": "America/Los_Angeles",
      "actions": [
        {
          "text": "Quote",
          "link": "https://www.yelp.com/raq/google-visitor-experience-mountain-view-5?utm_campaign=action_link_raq&utm_medium=feed_v2&utm_source=apple#popup:raq",
          "type": "quick_link"
        },
        "..."
      ],
      "amenities": [
        {
          "amenity_id": "crossbusiness.payments.applepay",
          "title": "Accepts Apple Pay",
          "vendor_id": "com.yelp"
        },
        "..."
      ],
      "external_ids": [
        {
          "vendor_id": "com.apple",
          "id": "54362378526000882"
        },
        "..."
      ],
      "images": [
        {
          "title": "Huddle",
          "source": "Yelp",
          "link": "http://yelp.com/apple_maps_action?id=28Vw90F6xgzE__iikX9pKg&component=photo&cid=6x9AxovRConhCBLWPBar9Q&action=view&language=en-US",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/CvidFytt0qT4CMojBZYcDw/0x0bb.jpg",
            "width": 0,
            "height": 0
          },
          "date_added": "2024-05-21T11:03:30Z",
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/CvidFytt0qT4CMojBZYcDw/320x320bb.jpeg"
        },
        "..."
      ],
      "guides": [
        {
          "guide_id": "9181564795503578159",
          "provider_id": "9902",
          "title": "Santa Clara Essentials",
          "long_title": "Santa Clara Essentials",
          "description": "Popular attractions and landmarks to explore, based on what people view, share, and interact with most on Apple Maps. The list updates over time, so save any places you want to revisit.",
          "date_modified": "2026-06-03T02:18:14Z",
          "link": "https://maps.apple.com/guides?curated=9181564795503578159&_provider=9902",
          "publisher": {
            "publisher_id": "10190490571777324232",
            "provider_id": "9902",
            "title": "Local Lists",
            "subtitle": "What's popular on Apple Maps",
            "source": "com.apple.lists",
            "guides_count": 880
          },
          "images": [
            {
              "original": {
                "link": "https://is1-ssl.mzstatic.com/image/thumb/KZ9O7kw1Vkd9KLeVsQmN0A/3600x2400w.jpg",
                "width": 3600,
                "height": 2400
              },
              "thumbnail": "https://media-cdn.tripadvisor.com/media/photo-o/16/e0/4f/e1/halloween-thrills-wait/1200x800.jpg"
            },
            "..."
          ],
          "places_count": 17
        },
        "..."
      ]
    },
    {
      "position": 2,
      "place_id": "IBB4C75E7EBE40E08",
      "provider_id": "9902",
      "title": "Katz's Delicatessen",
      "link": "https://maps.apple.com/place?place-id=IBB4C75E7EBE40E08&_provider=9902",
      "description": {
        "text": "One of the last-standing, old-time Eastern European spots on the Lower East Side, Katz’s is a true NY institution. It’s crowded, crazy and packed with a panoply of characters weirder than a jury duty pool. Tourists, hipsters, blue hairs and everybody in between flock here, so come on off-hours. Because it’s really that good. Walk inside, get a ticket and don’t lose it (those guys at the front aren’t hosts—upset their system and you’ll get a verbal beating). Then pick up your food at the counter and bring it to a first-come first-get table; or opt for a slightly less dizzying experience at a waitress-served table.Nothing’s changed in the looks or taste. Matzo ball soup, pastrami sandwiches, potato latkes—everything is what you’d expect, only better.",
        "source": {
          "name": "Michelin",
          "link": "https://guide.michelin.com/r/122748"
        }
      },
      "address": "205 E Houston St, New York, NY 10002, United States",
      "structured_address": {
        "short": "205 E Houston 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": "205",
        "thoroughfare": "E Houston St",
        "full_thoroughfare": "205 E Houston St",
        "area_of_interest": [
          "Manhattan",
          "..."
        ],
        "dependent_locality": [
          "Lower East Side",
          "..."
        ],
        "formatted_lines": [
          "205 E Houston St",
          "..."
        ]
      },
      "neighborhood": "Lower East Side, Manhattan",
      "rating": 89,
      "max_rating": 100,
      "rating_type": "apple_rating",
      "rating_source": "Apple",
      "reviews": 958,
      "subratings": [
        {
          "category": "Atmosphere",
          "rating": 89,
          "max_rating": 100,
          "reviews": 748
        },
        "..."
      ],
      "phone": "+12122542246",
      "phone_formatted": "+1 (212) 254-2246",
      "website": "https://katzsdelicatessen.com",
      "is_unclaimed": true,
      "claim_listing_link": "https://business.apple.com/?claimId=13496291822278020616",
      "gps_coordinates": {
        "latitude": 40.7223633,
        "longitude": -73.9873614
      },
      "bounds": {
        "north_latitude": 40.7268599,
        "south_latitude": 40.7178666,
        "east_longitude": -73.9814282,
        "west_longitude": -73.9932945
      },
      "access_points": [
        {
          "gps_coordinates": {
            "latitude": 40.7224458,
            "longitude": -73.9872556
          },
          "driving_direction": "destination",
          "walking_direction": "entry_exit",
          "source": "access_point_service_curated"
        },
        "..."
      ],
      "type": "Deli",
      "type_id": "deli",
      "type_path": "dining.deli",
      "types": [
        "Dining",
        "..."
      ],
      "type_ids": [
        "dining",
        "..."
      ],
      "open_state": "open",
      "open_hours": {
        "monday": [
          "08:00–23:00",
          "..."
        ],
        "tuesday": [
          "08:00–23:00",
          "..."
        ],
        "wednesday": [
          "08:00–23:00",
          "..."
        ],
        "thursday": [
          "08:00–23:00",
          "..."
        ],
        "friday": [
          "08:00–24:00",
          "..."
        ],
        "saturday": [
          "00:00–24:00",
          "..."
        ],
        "sunday": [
          "00:00–23:00",
          "..."
        ]
      },
      "timezone": "America/New_York",
      "actions": [
        {
          "text": "Order",
          "link": "https://www.ubereats.com/wrapper/apple-maps/katzs-delicatessen/UO5j9laHQCOtgD3H8yWjBw",
          "type": "app_clip_link"
        },
        "..."
      ],
      "amenities": [
        {
          "amenity_id": "crossbusiness.services.take_out",
          "title": "Takeout",
          "vendor_id": "com.yelp"
        },
        "..."
      ],
      "awards": [
        {
          "name": "Bib Gourmand",
          "source": "MICHELIN Guide",
          "vendor_id": "com.michelin"
        },
        "..."
      ],
      "external_ids": [
        {
          "vendor_id": "com.apple",
          "id": "103421430"
        },
        "..."
      ],
      "images": [
        {
          "title": "Pastrami",
          "source": "Yelp",
          "link": "http://yelp.com/apple_maps_action?id=V7lXZKBDzScDeGB8JmnzSA&component=photo&cid=Vz7h89H4-yFjcPoS0gXzTA&action=view&language=en-US",
          "original": {
            "link": "https://is1-ssl.mzstatic.com/image/thumb/Jah8765qpMQpxkaU7JffNQ/1980x1114bb.jpg",
            "width": 1980,
            "height": 1114
          },
          "category_id": "foodanddrink",
          "category_name": "Food & Drink",
          "date_added": "2025-09-23T14:20:21Z",
          "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/Jah8765qpMQpxkaU7JffNQ/320x320bb.jpeg"
        },
        "..."
      ],
      "guides": [
        {
          "guide_id": "15590613486016767458",
          "provider_id": "9902",
          "title": "8 Restaurants in Popular Films",
          "long_title": "8 Restaurants in Popular Films",
          "description": "These real-life restaurants didn’t just host iconic scenes; they’re still open, still serving, and still feel straight out of the film.",
          "review_snippet": "There’s something irresistible about Katz’s, even before you think of <i>When Harry Met Sally</i>. Open since 1888, this Lower East Side staple is loud, fast, and pure New York. Go straight for the pastrami on rye, hand-carved and piled high, then add matzo ball soup or latkes. The famous table is marked, but the whole place has that classic, cinematic feel.",
          "date_modified": "2026-05-12T01:22:44Z",
          "link": "https://maps.apple.com/guides?curated=15590613486016767458&_provider=9902",
          "direct_link": "https://places.travel",
          "publisher": {
            "publisher_id": "4141377096332787914",
            "provider_id": "9902",
            "title": "Places.Travel",
            "subtitle": "Hyper-local travel inspo",
            "source": "travel.places",
            "link": "https://places.travel/",
            "guides_count": 345
          },
          "images": [
            {
              "source": "Sharkshock/Shutterstock.com",
              "original": {
                "link": "https://is1-ssl.mzstatic.com/image/thumb/NIs5ewBhHGKBORyUuG_7mA/4256x2832w.jpg",
                "width": 4256,
                "height": 2832
              },
              "thumbnail": "https://is1-ssl.mzstatic.com/image/thumb/NIs5ewBhHGKBORyUuG_7mA/1200x800.jpg"
            },
            "..."
          ],
          "places_count": 8
        },
        "..."
      ]
    }
  ],
  "not_found_places": [
    "IFFFFFFFFFFFFFFFF"
  ]
}