API de Google Maps: Contactos
Busca negocios en Google Maps y enriquece cada resultado con datos de contacto (correos electrónicos, teléfonos y perfiles sociales tomados de sus sitios web), hasta 20 registros por solicitud.
US$3.25/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",... 23 campos más}
Precios y proveedores
Precios del endpoint Contactos de la API de Google Maps: una API, 2 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.0991 por solicitud1 resultadoUS$0.0050111 resultadosUS$0.0545121 resultadostope de US$0.0991Se 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 Contactos de Google Maps en una sola solicitud
Este ejemplo muestra 34 de 35 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"
],
"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,
"image": "https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no",
"emails": [
"hello@mananacoffeeaustin.com",
"events@mananacoffeeaustin.com"
],
"phones": [
"+1 512-555-0142"
],
"instagrams": [
"https://instagram.com/mananacoffeeatx"
],
"facebooks": [
"https://facebook.com/mananacoffeeatx"
],
"twitters": [],
"linkedIns": [],
"youtubes": [],
"tiktoks": [
"https://tiktok.com/@mananacoffeeatx"
],
"neighborhood": "Downtown",
"domain": "mananacoffeeaustin.com",
"language": "en",
"rank": 1
},
{
"placeId": "ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"cid": "5127740981263455000",
"name": "Radio Coffee & Beer",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJq6qq6X61RIYRXVfIhGlJ7YQ",
"category": "Coffee shop",
"address": "4204 Menchaca Rd, Austin, TX 78704, USA",
"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,
"emails": [
"info@radiocoffeeandbeer.com"
],
"phones": [
"+1 512-555-0187"
],
"instagrams": [
"https://instagram.com/radiocoffeeandbeer"
],
"facebooks": [
"https://facebook.com/radiocoffeeandbeer"
],
"domain": "radiocoffeeandbeer.com",
"rank": 2
},
{
"placeId": "ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"name": "Summer Moon Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJgUbEo8cKRIYRZ4h8dQ3jL2s",
"category": "Coffee shop",
"address": "1900 Aldrich St Ste 100, Austin, TX 78723, USA",
"city": "Austin",
"state": "Texas",
"postalCode": "78723",
"countryCode": "US",
"website": "https://summermooncoffee.com",
"rating": 4.5,
"reviewCount": 642,
"emails": [
"franchise@summermooncoffee.com"
],
"instagrams": [
"https://instagram.com/summermooncoffee"
],
"domain": "summermooncoffee.com",
"rank": 3
}
]
}
}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. Denver, USA).
- querystring
coffee shop
Lo que escribirías en la barra de búsqueda de Google Maps (p. ej. dentist).
- 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. ["dentist", "orthodontist"]). Omítela para incluir todas las categorías.
- languagestring
Código de idioma de dos letras para los resultados (p. ej. en).
- limitinteger
3
Número máximo de resultados que se devuelven (1-20, predeterminado 20).
- placeMinimumStarsenum
four
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. Omítelo para no filtrar por calificación.
- 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 `city` o `postalCode`, 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 negocio que realmente no lo tenga. Indicar una combinación que ninguna fuente devuelve junta se rechaza como entrada no válida, sin cargo.
- websiteenum
withWebsite
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). El enriquecimiento de contactos obtiene correos electrónicos y perfiles sociales del sitio web de un lugar, así que withWebsite apunta a leads que se pueden enriquecer.
Respuesta
JSON, un valor de ejemplo por campo.
Matching business records, each enriched with contact details scraped from the business website. 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 business.
- categorystring
Coffee shop
Primary business category.
- cidstring
8234917364550128200
Google customer/place id (cid).
- citystringse puede exigir
Austin
City the business is in.
- countryCodestringse puede exigir
US
Two-letter country code.
- domainstring
mananacoffeeaustin.com
Registrable domain of the business website.
- emailsstring[]
Email addresses scraped from the business website.
- facebooksstring[]
Facebook profile URLs found on the business website.
- imagestring
https://lh3.googleusercontent.com/places/ANXAkqHmananaCoffee6thSt=w400-h300-k-no
Primary business photo URL.
- instagramsstring[]
Instagram profile URLs found on the business website.
- languagestringse puede exigir
en
Two-letter language code of the listing Google served.
- latitudenumber
30.2687
Latitude of the business in decimal degrees.
- linkedInsstring[]
LinkedIn profile URLs found on the business website.
- longitudenumber
-97.7469
Longitude of the business in decimal degrees.
- namestring
Mañana Coffee House
Business name. Populated whenever the provider has data for the entity.
- neighborhoodstringse puede exigir
Downtown
Neighborhood the business is in.
- phonestring
+1 512-555-0142
Business phone number in E.164 format, when listed on Google Maps.
- phonesstring[]
Additional phone numbers scraped from the business website.
- placeIdstring
ChIJrX7cX9C1RIYR2LFEjaLyeuY
Google Maps place id (stable identifier for the business). Populated whenever the provider has data for the entity.
- postalCodestringse puede exigir
78701
Postal code of the business.
- rankinteger
1
One-based position of the business in the Google Maps result order.
- ratingnumber
4.6
Average star rating out of 5.
- reviewCountnumber
1284
Total number of reviews.
- statestringse puede exigir
Texas
State or region the business is in.
- streetstringse puede exigir
612 W 6th St
Street portion of the address.
- tiktoksstring[]
TikTok profile URLs found on the business website.
- twittersstring[]
X/Twitter profile URLs found on the business website.
- urlstring
https://www.google.com/maps/place/?q=place_id:ChIJrX7cX9C1RIYR2LFEjaLyeuY
Canonical Google Maps URL for the business. Populated whenever the provider has data for the entity.
- websitestring
https://mananacoffeeaustin.com
The business website URL, when listed.
- youtubesstring[]
YouTube channel URLs found on the business website.
- foundboolean
true
True when the search returned at least one matching business.
- 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.
Preguntas frecuentes
Acerca del endpoint Contactos de la API de Google Maps
El endpoint Contactos de AnyAPI para Google Maps devuelve datos de Google Maps como JSON normalizado con una sola llamada POST a /v1/run/maps.contacts. Busca negocios en Google Maps y enriquece cada resultado con datos de contacto (correos electrónicos, teléfonos y perfiles sociales tomados de sus sitios web), hasta 20 registros por solicitud. AnyAPI enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$3.25 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 Contactos de la API de Google Maps a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 5.3 segundos en 28.292 llamadas medidas.