Batch Lookup

batch_lookup allows you to retrieve details of multiple places in a single query. To retrieve details, submit an array of Placekeys as input. You will get details on up to 20 places in each response.

Generate Placekeys of the desired locations from here. Provide an array of Placekeys as query variables. You may request any attributes from SafeGraph Core, Geometry, or Patterns data sets.

Request Parameters

ParameterDescription
[placekeys]Array of the Placekeys of the locations

Below is an example of submitting an array of Placekeys to obtain information. You may add up to 20 Placekeys in this array. Add the array under Query variables in the GraphiQL Explorer.

query($placekeys: [Placekey!]) {
  batch_lookup(placekeys: $placekeys) {
    placekey
    safegraph_core {
      location_name
      street_address
      city
      region
      postal_code
      iso_country_code
    }
  }
}
{
  "placekeys": [
    "222-222@5qw-shj-7qz",
    "222-222@5s6-pyc-7qz",
    "zzw-222@5vg-3tv-7qz",
    "22s-223@63j-4f8-7qz",
    "228-222@5sb-cyn-7qz"
  ]
}
{
  "data": {
    "batch_lookup": [
      {
        "placekey": "222-222@5qw-shj-7qz",
        "safegraph_core": {
          "location_name": "Patrick Baptist Church",
          "street_address": "2006 Parkinson Rd",
          "city": "Ferris",
          "region": "TX",
          "postal_code": "75125",
          "iso_country_code": "US"
        }
      },
      {
        "placekey": "222-222@5s6-pyc-7qz",
        "safegraph_core": {
          "location_name": "United States Postal Service (USPS)",
          "street_address": "317 E Main St",
          "city": "Edmore",
          "region": "MI",
          "postal_code": "48829",
          "iso_country_code": "US"
        }
      },
      {
        "placekey": "228-222@5sb-cyn-7qz",
        "safegraph_core": {
          "location_name": "Private Ink",
          "street_address": "333 Peterson Rd Ste 250",
          "city": "Libertyville",
          "region": "IL",
          "postal_code": "60048",
          "iso_country_code": "US"
        }
      },
      {
        "placekey": "22s-223@63j-4f8-7qz",
        "safegraph_core": {
          "location_name": "Little Italy Pizza Cafe",
          "street_address": "16A N State St",
          "city": "Greenfield",
          "region": "IN",
          "postal_code": "46140",
          "iso_country_code": "US"
        }
      },
      {
        "placekey": "zzw-222@5vg-3tv-7qz",
        "safegraph_core": {
          "location_name": "Tolenas Elementary",
          "street_address": "4500 Tolenas Rd",
          "city": "Fairfield",
          "region": "CA",
          "postal_code": "94533",
          "iso_country_code": "US"
        }
      }
    ]
  },
  "extensions": {
    "row_count": 5,
    "version_date": "1627739802__2021_07"
  }
}