google-maps/
reviews

Recopile reseñas públicas de URL conocidas de Google Maps con texto, referencias de quien reseña, calificaciones, enlaces de origen, marcas de tiempo, referencias del lugar y contenido multimedia disponible normalizados.

Google Maps Reviews API

Reseñas de lugares
Filtro por ventana de días
Registros de reseñas normalizados
0.15 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Google Maps Reviews

Las reseñas de Google Maps son registros públicos de opiniones sobre un lugar que pueden incluir texto escrito, una referencia de quien reseña, una calificación, enlaces de origen y del sujeto, momentos de publicación y de recopilación, y contenido multimedia. Sirven para armar conjuntos de datos de opiniones vinculados a su fuente y para hacer comparaciones entre lugares conocidos o ventanas de recopilación.

Funcionalidades de la Google Maps Reviews API

  • Entrada por lotes de URL conocidasEnvíe una o más URL compatibles de google.com o goo.gl en una sola tarea asíncrona, en lugar de resolver los lugares con una API de identificadores aparte.
  • Ventana de días opcionalAplique un único valor positivo de days_limit a cada fila de URL enviada cuando el flujo de trabajo necesite una ventana de reseñas recientes.
  • Registros de reseñas establesLea la identidad de la reseña, el texto, los campos de quien reseña, la calificación, las referencias del lugar, las marcas de tiempo, la URL de origen y el contenido multimedia disponible mediante el esquema de reseñas v1.0.

Parámetros de la Google Maps Reviews API

ParámetrosObligatorioDescripción
urlsObligatorioUna o más URL no vacías en google.com, en cualquier subdominio de google.com, en goo.gl o en un subdominio de goo.gl, separadas por comas o saltos de línea. Use URL conocidas de lugares de Maps para recopilar reseñas.
days_limitOpcionalEntero positivo opcional que se aplica a cada fila de entrada del proveedor como ventana de actualidad de las reseñas. Omítalo para no enviar ningún filtro de ventana de días.
results_limitOpcionalEntero opcional de 1 a 2,000 que limita el total de reseñas almacenadas para la tarea. Su valor predeterminado es 100, y la disponibilidad de la fuente puede producir menos filas.

Cómo usar la Google Maps Reviews API

Envíe URL conocidas de Google Maps, siga la tarea asíncrona y lea los registros de reseñas guardados mediante el cursor de resultados de la tarea.

  1. Prepare una o más URL compatibles de lugares de Google Maps en google.com o goo.gl.
  2. Envíe urls por POST a /v1/google-maps/reviews y, cuando haga falta, también days_limit y results_limit.
  3. Consulte /v1/tasks/{task_id} hasta que status sea succeeded o failed.
  4. Lea /v1/tasks/{task_id}?limit=50 y continúe con results.next_cursor mientras results.has_more sea true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Casos de uso de la Google Maps Reviews API

  • Conjuntos de datos de opiniones sobre lugares conocidos: Prepare el texto de las reseñas, las calificaciones, los momentos de publicación y los enlaces de origen para un conjunto definido de URL públicas de lugares.
  • Investigación de quienes reseñan con trazabilidad de la fuente: Conserve los nombres, los nombres de usuario, los enlaces de perfil y las URL de las reseñas disponibles de quienes reseñan, para que los registros sigan siendo trazables a su contexto público.
  • Comparaciones de ventanas recientes: Ejecute el mismo conjunto de lugares con valores documentados de days_limit en momentos distintos para comparar recopilaciones acotadas, sin afirmar que se tiene el historial completo.
  • Archivos de reseñas con contenido multimedia vinculado: Conserve el contenido multimedia disponible de las reseñas junto con el texto, la calificación, la referencia del lugar y el momento de recopilación en un registro de investigación normalizado.

Consejos de expertos para la Google Maps Reviews API

  • Envíe URL de Maps de google.com o goo.gl que se puedan resolver; un nombre de lugar, una cuenta de Perfil de Empresa de Google o un Place ID por sí solos no son un elemento aceptado de urls.
  • Use days_limit solo cuando tenga sentido una ventana en números enteros positivos; si lo omite, la fila del proveedor queda sin ese filtro.
  • Trate results_limit como un tope global de resultados almacenados para todo el lote de URL, no como una promesa por cada URL.
  • Mantenga separado el results_limit del envío y el limit de lectura de la tarea: este último controla el tamaño de página de 1 a 500 y usa un cursor opaco.
  • Permita que el texto, los atributos de quien reseña, la calificación, las referencias del sujeto, las marcas de tiempo y el contenido multimedia estén ausentes cuando la fuente pública no los exponga.

Además de la Google Maps Reviews API, use estas APIs cuando necesite otro tipo de datos públicos de Google Maps.

Explorar otras plataformas

Combine los datos de Google Maps con datos públicos de otras plataformas sociales compatibles.

Google Maps Reviews API — FAQ

Google Maps Reviews API es una interfaz programática para recopilar registros públicos de reseñas a partir de URL conocidas de Google Maps en un esquema de reseñas estable. Devuelve solo los datos disponibles mediante la vía pública de recopilación compatible y no ofrece acciones de administración del Perfil de Empresa de Google con sesión iniciada.

El entorno de ejecución acepta URL no vacías cuyo host sea google.com, un subdominio de google.com, goo.gl o un subdominio de goo.gl. Para obtener resultados de reseñas útiles, envíe URL conocidas de lugares de Google Maps y no nombres ni identificadores sueltos.

days_limit es opcional y debe ser un entero de al menos 1. Cuando está presente, el adaptador del proveedor copia el mismo valor en cada fila de entrada de URL; cuando se omite, no se envía ningún campo days_limit.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000. La solicitud al proveedor recibe el límite y el entorno de ejecución también deja de almacenar filas cuando el total de la tarea lo alcanza, por lo que la cantidad de URL, la ventana de días y la disponibilidad del conjunto de datos público pueden producir menos resultados.

El esquema de reseñas v1.0 puede contener id, platform, resource, type, url, published_at, collected_at, text, author, rating, subject_id, subject_url y media. author se expande en identidad, nombre de usuario, nombre, URL del perfil, URL del avatar e indicadores de cuenta que pueden ser nulos.

No hay un cargo base por tarea. La solicitud reserva 0.15 créditos por resultado estimado según results_limit, o 100 si se omite, luego liquida a 0.15 créditos por cada resultado realmente almacenado y reembolsa los créditos reservados que no se usaron; un resultado vacío se liquida en cero.