API de Reseñas de Google Maps
Busca lugares en Google Maps y consulta por URL su ficha o reseñas públicas. place_id, nombre, dirección y coordenadas ayudan a distinguir establecimientos con nombres parecidos.
Una valoración agregada no sustituye las reseñas individuales. Horarios, teléfonos, respuestas y atributos pueden faltar o cambiar; la API no edita la ficha ni responde opiniones.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Reseñas de Google Maps, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar lugares en Google Mapssearch | Busca lugares en Google Maps mediante keyword y contexto de país, idioma o ubicación. | $1.39 por 1.000 solicitudes | Normal |
Consultar la ficha de un lugarprofile | Abre la url de un lugar y permite contexto de ciudad, idioma, fecha u orden. | $1.39 por 1.000 solicitudes | Normal |
Leer reseñas de Google Mapsreviews | Lee reseñas de la url del lugar y permite seleccionar idioma, fecha u orden. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Reseñas de Google Maps?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar lugares en Google Maps Busca lugares en Google Maps mediante | keyword | country, language, location, page_token | Entrega síncrona | El catálogo declara defaultLimit = 15 y maxLimit = 50 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. Para la siguiente página, devuelve next_page_token como page_token sin cambiar los demás parámetros; cada página es una llamada. Se puede paginar hasta 120 filas; más allá de 60 filas, pide la página con mode=async. | $1.39 por 1.000 solicitudes | place_id · name · url · category · categories · description · address · city · state · postal_code · country_code · lat · lng · phone · website · rating · rating_scale · review_count · price · permanently_closed · image_url · platform |
profileConsultar la ficha de un lugar Abre la | url | city, language, since, sort | Entrega síncrona | — | $1.39 por 1.000 solicitudes | place_id · name · url · category · categories · description · address · neighborhood · city · state · postal_code · country_code · plus_code · lat · lng · phone · website · rating · rating_scale · review_count · image_count · price · permanently_closed · temporarily_closed · opening_hours · image_url · platform |
reviewsLeer reseñas de Google Maps Lee reseñas de la | url | lang, language, page_token, since, sort | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. Para la siguiente página, devuelve next_page_token como page_token sin cambiar los demás parámetros; cada página es una llamada. Se puede paginar hasta 400 filas; más allá de 200 filas, pide la página con mode=async. | $1.39 por 1.000 solicitudes | id · text · rating · rating_scale · reviewer_name · reviewer_review_count · is_local_guide · like_count · posted_at · url · owner_response · owner_response_at · detailed_rating · image_urls · place_id · place_name · platform |
¿Qué significan los parámetros de Reseñas de Google Maps search?
Busca lugares en Google Maps mediante keyword y contexto de país, idioma o ubicación. Devuelve place_id, dirección, categoría y valoración; no calcula reputación ni garantiza una cobertura geográfica completa.
keywordObligatorio- Lugar, tipo de negocio o nombre en Google Maps, como
dentistodentist in Chicago.searchbusca lugares, no busca en el texto de las reseñas de un negocio existente. countryOpcional- Código de país o región para la búsqueda en
search, comous(por defecto). Afecta al contexto regional de la búsqueda, pero no garantiza un filtrado exacto por el país del negocio. languageOpcional- Idioma de la consulta y del contenido de la página. El valor por defecto es
en. Si enreviewstambién se envíalang, este último tiene prioridad. La selección de idioma no garantiza que el texto original de todas las reseñas esté en ese idioma. locationOpcional- Ubicación para la búsqueda en
search, comoChicago. Se combinará conkeyword. Sikeywordya incluye una ubicación, evita indicar unalocationque entre en conflicto. page_tokenOpcional- Token de paginación: devuelve el next_page_token de la respuesta anterior para obtener la siguiente página; omítelo para la primera. Mantén el resto de parámetros sin cambios. Los tokens duran 24 horas y cada página es una llamada.
¿Qué significan los parámetros de Reseñas de Google Maps profile?
Abre la url de un lugar y permite contexto de ciudad, idioma, fecha u orden. Reúne datos del establecimiento y métricas visibles; no acredita propiedad, horario futuro o disponibilidad.
urlObligatorio- Enlace completo del lugar en Google Maps. Usa preferentemente la URL de los resultados de búsqueda que conserva el
query_place_id. Los enlaces/place/que solo contienen el nombre y las coordenadas del negocio pueden no localizarlo de forma estable.profileobtiene los datos del negocio yreviewsobtiene sus reseñas.Google Maps: enlaces de lugares y Place ID — Google Maps documenta que `query_place_id` puede identificar un lugar concreto dentro de una URL. Ayuda a no depender solo del nombre o las coordenadas; no añade geocodificación ni edición de fichas a esta API. · Consultada cityOpcional- Texto para restringir la búsqueda a una ciudad. La acción
profiletambién admite este parámetro, pero no puedes usarlo para cambiar la ubicación de un negocio ni para sustituir la URL del lugar. languageOpcional- Idioma de la consulta y del contenido de la página. El valor por defecto es
en. Si enreviewstambién se envíalang, este último tiene prioridad. La selección de idioma no garantiza que el texto original de todas las reseñas esté en ese idioma. sinceOpcional- Fecha de publicación mínima de las reseñas, en formato YYYY-MM-DD. Se usa para obtener reseñas, no es la fecha de apertura del negocio. La acción
profiletambién admite este parámetro, pero no se puede asumir que los detalles del lugar se filtren por fecha de apertura. sortOpcional- Orden de las reseñas:
newest(más recientes) orelevance(relevancia de la plataforma). Enreviews, el valor por defecto esnewest. El parámetro con el mismo nombre enprofilesolo afecta a las reseñas que puedan incluirse, no ordena el objeto del negocio.Valores permitidos:newestrelevance
¿Qué significan los parámetros de Reseñas de Google Maps reviews?
Lee reseñas de la url del lugar y permite seleccionar idioma, fecha u orden. Distingue autor, Local Guide, likes y respuesta del negocio; no publica respuestas ni garantiza todo el historial.
urlObligatorio- Enlace completo del lugar en Google Maps. Usa preferentemente la URL de los resultados de búsqueda que conserva el
query_place_id. Los enlaces/place/que solo contienen el nombre y las coordenadas del negocio pueden no localizarlo de forma estable.profileobtiene los datos del negocio yreviewsobtiene sus reseñas.Google Maps: enlaces de lugares y Place ID — Google Maps documenta que `query_place_id` puede identificar un lugar concreto dentro de una URL. Ayuda a no depender solo del nombre o las coordenadas; no añade geocodificación ni edición de fichas a esta API. · Consultada langOpcional- Idioma para
reviews:en(inglés),zhcn(chino simplificado),zhtw(chino tradicional), etc. Consulta la lista completa en los valores permitidos de esta API. Tiene prioridad sobrelanguage. No filtra por la nacionalidad del autor de la reseña.Valores permitidos:afamarazbgbnbscacsdadeeleneses419eteufafifilfrglguhihrhuhyidisitiwjakakkkmknkokyloltlvmkmlmnmrmsmynenlnopaplptbrptptrorusiskslsqsrsvswtatethtrukuruzvizhcnzhtwzu languageOpcional- Idioma de la consulta y del contenido de la página. El valor por defecto es
en. Si enreviewstambién se envíalang, este último tiene prioridad. La selección de idioma no garantiza que el texto original de todas las reseñas esté en ese idioma. page_tokenOpcional- Token de paginación: devuelve el next_page_token de la respuesta anterior para obtener la siguiente página; omítelo para la primera. Mantén el resto de parámetros sin cambios. Los tokens duran 24 horas y cada página es una llamada.
sinceOpcional- Fecha de publicación mínima de las reseñas, en formato YYYY-MM-DD. Se usa para obtener reseñas, no es la fecha de apertura del negocio. La acción
profiletambién admite este parámetro, pero no se puede asumir que los detalles del lugar se filtren por fecha de apertura. sortOpcional- Orden de las reseñas:
newest(más recientes) orelevance(relevancia de la plataforma). Enreviews, el valor por defecto esnewest. El parámetro con el mismo nombre enprofilesolo afecta a las reseñas que puedan incluirse, no ordena el objeto del negocio.Valores permitidos:newestrelevance
Cómo usar la API de Reseñas de Google Maps
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_maps_reviews","action":"search","params":{"keyword":"<keyword>"}}'
Guías de Reseñas de Google Maps
Ejemplos completos y métodos basados en estas acciones. Comprueba primero en esta página las acciones, parámetros y campos actuales; los ejemplos y límites de un artículo no sustituyen al catálogo en vivo.
API de reseñas de Google Maps: elige el punto de acceso correcto antes de registrar ubicaciones y opiniones
Distingue entre Business Profile, Places API y la lectura de reseñas de ubicaciones EveryInfra. Verifica la identidad de la ubicación, los filtros de idioma y fecha, conserva los cambios en las valoraciones y respuestas de los comerciantes, y establece los límites de muestras, almacenamiento y visualización.
Leer el artículo →Deduplicación de ubicaciones en Google Maps: el Place ID no es una identidad de negocio permanente
Un mismo lugar puede tener múltiples Place ID y los identificadores cambian. A partir de la documentación oficial de Google, se analizan la deduplicación de sucursales, el mapeo de entidades internas, el registro de mudanzas y la validación de falsas fusiones.
Leer el artículo →Plan de seguimiento de reputación en múltiples plataformas: registra el alcance de la recolección antes de evaluar cambios negativos.
Diseña un proceso de seguimiento de reputación trazable a partir de listas de objetivos, identidades de comentarios y cursores incrementales; usa muestras locales para demostrar la deduplicación y las brechas de recolección, conserva la revisión manual y evita presentar casos de éxito de clientes.
Leer el artículo →Preguntas sobre la API de Reseñas de Google Maps
¿Cómo llamo a la API de Reseñas de Google Maps?
Envía POST /api/v1/social con platform igual a google_maps_reviews, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Reseñas de Google Maps?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye place_id, name, category y categories. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Reseñas de Google Maps?
Google Maps documenta que query_place_id puede identificar un lugar concreto dentro de una URL. Ayuda a no depender solo del nombre o las coordenadas; no añade geocodificación ni edición de fichas a esta API.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword; profile requiere url; reviews requiere url.
¿Las acciones de Reseñas de Google Maps responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.