API de plataforma de EveryData
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 3
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Reseñas de Google Maps por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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 | 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. | $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 · day · hours |
reviewsLeer reseñas de Google Maps Lee reseñas de la | url | lang, language, 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. | $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é 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.
¿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.
¿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 IDGoogle 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 garantizar que una URL alternativa funcione. 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 IDGoogle 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. 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 devuelto si la acción es 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>"}}'
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 de origen contengan 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.