Search: Text

Text Search allows you to search by a single text string. For example, you could search "coffee shops sf" to return all of the coffee shops in San Francisco. You can further filter your search within a certain area by using a bounding box or radius search.

Text Search returns a Basic Place Response. This query supports pagination and requires Nesting Place Responses.

ArgumentDescriptionExample
textRequired. String with search criteriacoffee shops sf
denver mexican food
boundingBoxOptional. Pass in two points
aroundCoordinatesOptional. Search within a specified radius around a specified point. Radius is in meterslatitude: 37.78247
longitude: -122.407752
distanceInMeters: 1000
pageNumberOptional. Integer to specify which results to return for pagination

In this example, we're searching for the first 20 results for "denver mexican food".

query {
  textSearch(text: "denver mexican food") {
    places {
      locationName
      address {
        streetAddress
        city
        region
      }
      latitude
      longitude
      topCategory
      placekey
    }
  	pageInfo {
      totalCount
      page
      pages
    }
  }
}
{
  "data": {
    "textSearch": {
      "places": [
        {
          "locationName": "Qdoba Mexican Grill",
          "address": {
            "streetAddress": "8500 Pena Blvd. Concourse B",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.85874,
          "longitude": -104.67372,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-22j@5qk-kb7-85f"
        },
        {
          "locationName": "Bartaco",
          "address": {
            "streetAddress": "2001 W 32nd Ave",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.76221,
          "longitude": -105.011428,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-226@5q9-bqx-hnq"
        },
        {
          "locationName": "The Taco Connection",
          "address": {
            "streetAddress": "733 16th St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.745659,
          "longitude": -104.992522,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-225@5q9-bqm-t5f"
        },
        {
          "locationName": "Federales",
          "address": {
            "streetAddress": "2901 Larimer St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.761797,
          "longitude": -104.981883,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-224@5q9-bqs-p5f"
        },
        {
          "locationName": "Paleteria La michoacana",
          "address": {
            "streetAddress": "3017 West Evans Ave Evans St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.679135,
          "longitude": -105.026249,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-224@5q9-bnw-gp9"
        },
        {
          "locationName": "El Patron Mexican Restaurant 2",
          "address": {
            "streetAddress": "4630 Peoria St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.78043,
          "longitude": -104.845678,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-224@5q9-bdp-ks5"
        },
        {
          "locationName": "Taqueria Guadalajara",
          "address": {
            "streetAddress": "106 N Tx 214",
            "city": "Denver City",
            "region": "TX"
          },
          "latitude": 32.965301,
          "longitude": -102.818624,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-223@8tk-24c-94v"
        },
        {
          "locationName": "Taqueria Mi pueblo",
          "address": {
            "streetAddress": "2945 W 23rd Ave",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.751388,
          "longitude": -105.024899,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-223@5q9-bqw-zfz"
        },
        {
          "locationName": "Perico's Tacos",
          "address": {
            "streetAddress": "1501 W 48th Ave",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.784119,
          "longitude": -105.00609,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-223@5q9-bq7-ysq"
        },
        {
          "locationName": "La Dona Mezcaleria",
          "address": {
            "streetAddress": "13 E Louisiana Ave",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.693313,
          "longitude": -104.987073,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-223@5q9-bp5-nt9"
        },
        {
          "locationName": "La Guerita Food Truck",
          "address": {
            "streetAddress": "40th Ave & Havana St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.772863,
          "longitude": -104.865872,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-223@5q9-bff-2tv"
        },
        {
          "locationName": "Taco Bell",
          "address": {
            "streetAddress": "6159 Hwy 16 South",
            "city": "Denver",
            "region": "NC"
          },
          "latitude": 35.555738,
          "longitude": -81.063438,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@8gf-fqw-dy9"
        },
        {
          "locationName": "MixCo Bar",
          "address": {
            "streetAddress": "3rd And Denver",
            "city": "Tulsa",
            "region": "OK"
          },
          "latitude": 36.152296,
          "longitude": -95.993704,
          "topCategory": "Beer, Wine, and Liquor Stores",
          "placekey": "zzy-222@5r8-fq9-f2k"
        },
        {
          "locationName": "Marquez Food",
          "address": {
            "streetAddress": "17th And Blake",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.751483,
          "longitude": -104.997986,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@5q9-bqx-ks5"
        },
        {
          "locationName": "Qdoba Mexican Grill",
          "address": {
            "streetAddress": "1201 Larimer St Academic Bldg One",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.746499,
          "longitude": -105.001968,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@5q9-bqw-xbk"
        },
        {
          "locationName": "Joe's Burrito Cart",
          "address": {
            "streetAddress": "1981 Curtis St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.75118,
          "longitude": -104.990871,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@5q9-bqt-8sq"
        },
        {
          "locationName": "Chipotle Mexican Grill",
          "address": {
            "streetAddress": "371 E Alameda Ave",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.711435,
          "longitude": -104.983081,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@5q9-bqr-bx5"
        },
        {
          "locationName": "Cocotaso",
          "address": {
            "streetAddress": "1234 Stout St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.742486,
          "longitude": -104.998151,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@5q9-bqm-5fz"
        },
        {
          "locationName": "Taco Block",
          "address": {
            "streetAddress": "638 S Lipan St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.7051,
          "longitude": -105.001208,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@5q9-bp6-kmk"
        },
        {
          "locationName": "El Rancherito",
          "address": {
            "streetAddress": "195 S Federal Blvd",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.719576,
          "longitude": -105.02541,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "zzy-222@5q9-bp5-45f"
        }
      ],
      "pageInfo": {
        "totalCount": 519,
        "page": 0,
        "pages": 26
      }
    }
  },
  "extensions": {
    "row_count": 20
  }
}