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.

Argument

Description

Example

text

Required. String with search criteria

coffee shops sf
denver mexican food

boundingBox

Optional. Pass in two points

aroundCoordinates

Optional. Search within a specified radius around a specified point. Radius is in meters

latitude: 37.78247
longitude: -122.407752
distanceInMeters: 1000

pageNumber

Optional. 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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "locationName": "Federales",
          "address": {
            "streetAddress": "2901 Larimer St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.761797,
          "longitude": -104.981883,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "locationName": "Cocotaso",
          "address": {
            "streetAddress": "1234 Stout St",
            "city": "Denver",
            "region": "CO"
          },
          "latitude": 39.742486,
          "longitude": -104.998151,
          "topCategory": "Restaurants and Other Eating Places",
          "placekey": "[email protected]"
        },
        {
          "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": "[email protected]"
        },
        {
          "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": "[email protected]"
        }
      ],
      "pageInfo": {
        "totalCount": 519,
        "page": 0,
        "pages": 26
      }
    }
  },
  "extensions": {
    "row_count": 20
  }
}