Places API allows you to lookup information on a particular place using a combination of the location name and details about the physical location. Attributes like address, city, region or even latitutde/longitude. You may request attributes from Safegraph Core, Geometry, or Pattern datasets.

Request Parameters: Query

query parameters are used to lookup POI details using Name and Location.

Parameter	Description
location_name	Name of the location
street_address	Street Address
city	Name of the city
region	Name of the Region
postal_code	The numeric postal code
iso_country_code	ISO Country code
latitude	The latitude with a precision of at least 3 decimal points.
longitude	The longitude with a precision of at least 3 decimal points.

🚧
Required Fields
When querying by location & address, it's necessary to have at least the following combination of fields to return a result:

location_name + street_address + city + region + iso_country_code

location_name + street_address + postal_code + iso_country_code

location_name + latitude + longitude + iso_country_code

query {
  lookup(
    query: {
      location_name: "Taco Bell"
      street_address: "710 3rd St"
      city: "San Francisco"
      region: "CA"
      iso_country_code: "US"
    }
  ) {
    placekey
    safegraph_core {
      location_name
      street_address
      postal_code
      phone_number
      category_tags
    }
  }
}

{
  "data": {
    "lookup": {
      "placekey": "224-222@5vg-7gv-d7q",
      "safegraph_core": {
        "location_name": "Taco Bell",
        "street_address": "710 3rd St",
        "postal_code": "94107",
        "phone_number": "+14159791587",
        "category_tags": [
          "Counter Service",
          "Late Night",
          "Lunch",
          "Fast Food",
          "Drive Through",
          "Breakfast",
          "Mexican Food",
          "Dinner"
        ]
      }
    }
  },
  "extensions": {
    "row_count": 1,
    "version_date": "1635494405__2021_10"
  }
}