API de Google Maps: Buscar
Busca en Google Maps lugares que coincidan con una consulta y una ubicación: hasta 20 registros de lugares normalizados por solicitud, con calificaciones, direcciones y datos básicos de contacto.
US$1.50/1k solic., pagas por solicitud, sin suscripción.
Mañana Coffee House
4.6(1,284)
Coffee shop · 612 W 6th St, Austin, TX 78701, USA
{"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY","cid": "8234917364550128200","name": "Mañana Coffee House","url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY","category": "Coffee shop","categories": [...],"address": "612 W 6th St, Austin, TX 78701, USA","street": "612 W 6th St",... 14 campos más}
Precios y proveedores
Precios del endpoint Buscar de la API de Google Maps: una API, 6 proveedores intercambiables
El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.
con un tope de US$0.0705 por solicitud1 resultadoUS$0.0035811 resultadosUS$0.0387821 resultadostope de US$0.0705Se te cobra por lo que se devuelve. Baja el límite para pagar menos, y ninguna solicitud puede costar más que el tope, sin importar cuánto se devuelva.
Pruébalo
Obtén Buscar de Google Maps en una sola solicitud
Este ejemplo muestra 24 de 26 campos. Ver todos los campos
{
"found": true,
"data": {
"items": [
{
"placeId": "ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"cid": "8234917364550128200",
"name": "Mañana Coffee House",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Breakfast restaurant",
"Bakery"
],
"address": "612 W 6th St, Austin, TX 78701, USA",
"street": "612 W 6th St",
"city": "Austin",
"state": "Texas",
"postalCode": "78701",
"countryCode": "US",
"latitude": 30.2687,
"longitude": -97.7469,
"phone": "+1 512-555-0142",
"website": "https://mananacoffeeaustin.com",
"rating": 4.6,
"reviewCount": 1284,
"priceLevel": "$$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no"
},
{
"placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"cid": "5127740981263455000",
"name": "Radio Coffee & Beer",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"category": "Coffee shop",
"categories": [
"Coffee shop",
"Bar"
],
"address": "4204 Menchaca Rd, Austin, TX 78704, USA",
"street": "4204 Menchaca Rd",
"city": "Austin",
"state": "Texas",
"postalCode": "78704",
"countryCode": "US",
"latitude": 30.2277,
"longitude": -97.7808,
"phone": "+1 512-555-0187",
"website": "https://radiocoffeeandbeer.com",
"rating": 4.7,
"reviewCount": 3021,
"priceLevel": "$$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHRadioCoffeeBeerPatio=w400-h300-k-no"
},
{
"placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"name": "Summer Moon Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"category": "Coffee shop",
"categories": [
"Coffee shop"
],
"address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
"street": "1900 Aldrich St Ste 100",
"city": "Austin",
"state": "Texas",
"postalCode": "78723",
"countryCode": "US",
"latitude": 30.296,
"longitude": -97.7028,
"website": "https://summermooncoffee.com",
"rating": 4.5,
"reviewCount": 642,
"priceLevel": "$",
"permanentlyClosed": false,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHSummerMoonAldrich=w400-h300-k-no"
}
]
}
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- locationstring
Austin, TX
Ubicación en texto libre donde buscar, idealmente ciudad y país (p. ej. Austin, USA).
- querystring
coffee shop
Lo que escribirías en la barra de búsqueda de Google Maps (p. ej. coffee shop).
- categoryFilterWordsarray
Lista opcional de nombres de categorías de lugares de Google Maps que conservar; los resultados se limitan a lugares cuya categoría coincida con alguna de ellas. Usa los nombres de categoría en minúsculas tal como aparecen en Google Maps (p. ej. ["coffee shop", "restaurant"]). Omítela para incluir todas las categorías y mantener el precio más barato; un filtro de categoría enruta a una fuente más cara.
- languagestring
Código de idioma de dos letras para los resultados (p. ej. en).
- limitinteger
3
Número máximo de resultados que devolver (1-20, predeterminado 20). El precio depende del proveedor seleccionado y puede ser fijo por solicitud.
- placeMinimumStarsenum
Devuelve solo lugares con una calificación promedio de al menos: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) o fourAndHalf (4.5+). Se excluyen los lugares sin reseñas. Omite este campo para mantener el precio más barato; una calificación mínima enruta a una fuente más cara.
- requireFieldsarray
Opcional; si lo omites, el enrutamiento no cambia y atiende la fuente más barata. Indica los campos de salida que esta solicitud debe poder devolver, por ejemplo `cid` o `street`, y solo la atenderá una fuente que los devuelva todos. Los campos que no indiques se siguen devolviendo siempre que la fuente que atiende los tenga. Esto puede subir tu precio: cuando la fuente más barata no puede devolver un campo indicado, atiende una fuente más cara, y se te cotiza y cobra su precio. Un campo indicado puede faltar igualmente en un lugar que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo.
- websiteenum
Filtra los lugares según si indican un sitio web: allPlaces (predeterminado), withWebsite (solo lugares que tienen sitio web) o withoutWebsite (solo lugares sin uno). Omite este campo, o envía allPlaces, para mantener el precio más barato; withWebsite y withoutWebsite enrutan a una fuente más cara.
Respuesta
JSON, un valor de ejemplo por campo.
Matching Google Maps place records. Populated whenever the provider has data for the entity.
- addressstring
612 W 6th St, Austin, TX 78701, USA
Full formatted street address.
- categoriesstring[]
Every Google Maps category listed for the place.
- categorystring
Coffee shop
Primary place category (e.g. Coffee shop).
- cidstringse puede exigir
8234917364550128200
Google customer/place id (cid).
- citystringse puede exigir
Austin
City the place is in.
- countryCodestringse puede exigir
US
Two-letter country code.
- hoursobject[]se puede exigir
Opening hours by day: each element is an object with the day name and its hours. null when the serving source does not return hours; name `hours` in `requireFields` to be served by one that does.
- imagestring
https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no
Primary place photo URL.
- latitudenumber
30.2687
Latitude of the place in decimal degrees.
- longitudenumber
-97.7469
Longitude of the place in decimal degrees.
- namestring
Mañana Coffee House
Place name. Populated whenever the provider has data for the entity.
- permanentlyClosedbooleanse puede exigir
false
True when the place is marked permanently closed.
- phonestringse puede exigir
+1 512-555-0142
Business phone number in E.164 format, when listed.
- placeIdstring
ChIJrX7cX9C1RIYR2LFEjaLyeuY
Google Maps place id (stable identifier for the place). Populated whenever the provider has data for the entity.
- postalCodestringse puede exigir
78701
Postal code of the place.
- priceLevelstringse puede exigir
$$
Relative price level indicator (e.g. $, $10-20).
- ratingnumber
4.6
Average star rating out of 5.
- reviewCountnumber
1284
Total number of reviews.
- statestringse puede exigir
Texas
State or region the place is in.
- streetstringse puede exigir
612 W 6th St
Street line of the address.
- urlstring
https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY
Canonical Google Maps URL for the place. Populated whenever the provider has data for the entity.
- websitestring
https://mananacoffeeaustin.com
The place's own website URL, when listed.
- foundboolean
true
True when the search returned at least one matching place.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
¿Vendes esta API? Consulta el esquema completo que debe devolver tu endpoint.
Preguntas frecuentes
Acerca del endpoint Buscar de la API de Google Maps
El endpoint Buscar de AnyAPI para Google Maps devuelve datos de Google Maps como JSON normalizado con una sola llamada POST a /v1/run/maps.search. Busca en Google Maps lugares que coincidan con una consulta y una ubicación: hasta 20 registros de lugares normalizados por solicitud, con calificaciones, direcciones y datos básicos de contacto. AnyAPI enruta cada solicitud entre 6 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$1.50 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 100.0% de las llamadas al endpoint Buscar de la API de Google Maps a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.7 segundos en 63.111 llamadas medidas.