API de Google Maps

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.

coffee shop - Google Maps
google.com/maps/search/coffee%20shop
coffee shop in Austin, TX
ResultsShare

Mañana Coffee House

4.6(1,284)

Coffee shop · 612 W 6th St, Austin, TX 78701, USA

Mañana Coffee House
Google Maps
Lo que devolvió la APIitems[0]
{
"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
}
Disponibilidad
100.00%
30d · 63,111 llamadas
Solicitudes
63,473
30d · semanal, últimas 12 sem.
Respuesta
2.7s
mediana · 30d

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.

Pagas
US$15.00
US$1.50/1k solic., solo por lo que usas. Sin plan mensual.
Tus primeras 66 solicitudes son gratis con el saldo inicial de US$0.10.

Pruébalo

Obtén Buscar de Google Maps en una sola solicitud

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.
Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.

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.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

each itemdata.items[]

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.

top level
  • 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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

¿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.

Cuesta desde US$1.50 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

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. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

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. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 66 llamadas a Buscar de Google Maps a US$0.0015 cada una.

AnyAPI consulta la siguiente de sus 6 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/maps.search con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.