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": "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
}
}