Apple Maps Guide Results API

Our Apple Maps Guide Results API allows you to scrape guide results from the Apple Maps search page.


Search results are returned in the JSON response in the guide_results array.


Items in this array can contain: position, title, description, items, and more. View the schema for more details.


The API endpoint is https://serpapi.com/search?engine=apple_maps

Head to the playground for a live and interactive demo.

API Examples

Example guide results with q: Coffee, and Austin, TX, US as a location

Example guide results with q: Coffee, and Austin, TX, US as a location

JSON Example

{
  ...
  "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

{
  "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"
        },
        ...
      ]
    },
    ...
  ],
}