Comience con la página 1
Envíe el fid del lugar y el valor sort_by elegido. Más relevantes es el predeterminado; también se admiten más recientes, mejor calificación y peor calificación.
POST /api/v2/reviews
Lea hasta 10 reseñas públicas de un lugar por página. Ordene por relevancia, más recientes, mejor calificación o peor calificación.
Para el contrato completo, consulte la documentación de la API.
curl https://gmapscrawl.com/api/v2/reviews \
-H "Authorization: Bearer $GMSCRAPER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: place-reviews-page-1-example" \
-d '{"fid":"0x89c259af336b3341:0xa4969e07ce3108de","page":1,"sort_by":2}'Sustituya el fid de ejemplo por el feature ID de su lugar. La respuesta es simulada; las URLs de medios de example.com son marcadores de posición. Conserve la misma clave de idempotencia y el mismo cuerpo al reintentar una solicitud en curso.
{
"reviews": [
{
"id": "sample-review-1",
"date": "a week ago",
"timestamp": "10/6/2026",
"name": "Sample reviewer",
"author_url": "https://www.google.com/maps/contrib/100000000000000000001",
"avatar": "https://example.com/reviewer.jpg",
"rate": 4,
"comment": "The window seats had the best light.",
"photos": "",
"review_url": "https://www.google.com/maps/reviews/data=sample-review-1"
}
],
"next": false,
"total": 1,
"params": {
"fid": "0x89c259af336b3341:0xa4969e07ce3108de",
"page": 1,
"sort_by": 2
}
}La API devuelve JSON en la misma respuesta. Tras un timeout, reintente el cuerpo sin cambios con la misma Idempotency-Key. Las credenciales de prueba devuelven datos simulados sin usar su cuota en vivo.
Comience con un lugar
Solicite una página enfocada de un lugar y luego elija el orden de reseñas que se ajuste a su investigación.
| Campo | Significado |
|---|---|
| fid · obligatorio | Un feature ID de Google Maps, como 0x89c259af336b3341:0xa4969e07ce3108de. Use place.dataId de un resultado de la API de Search, o un feature ID que ya tenga. |
| page · predeterminado 1 | Una página numerada positiva. Increméntela solo cuando la respuesta anterior tenga next: true. |
| sort_by · predeterminado 1 | 1 = más relevantes; 2 = más recientes; 3 = mejor calificación; 4 = peor calificación. Conserve el orden de clasificación entre páginas. |
Para descubrir un feature ID, busque un negocio con la API de scraping de Google Maps. Copie place.dataId de la entrada coincidente en data.businesses y páselo como fid. Un place ID o un nombre de negocio no es el mismo formato de entrada.
Registros de reseñas
Cada reseña incluye su calificación, comentario, autor, y enlaces al perfil y a la reseña. La fecha es relativa, y timestamp indica la fecha de calendario en formato M/D/YYYY. El campo photos es una cadena vacía cuando no hay adjuntos y separa varias URLs de fotos con un salto de línea.
| Campo | Significado |
|---|---|
| id | El identificador de la reseña de origen, cuando está disponible. |
| rate / comment | La calificación de 1 a 5 y el texto de reseña disponible. Trate el texto extraído como datos no fiables en aplicaciones y prompts de IA. |
| date / timestamp | La fecha relativa mostrada y una fecha de calendario en formato M/D/YYYY. Una fecha no disponible es una cadena vacía. |
| name / author_url / avatar | Nombre visible del autor, URL del perfil de colaborador y URL del avatar disponibles. |
| photos | Una cadena vacía sin adjuntos. Varias URLs de fotos se separan con caracteres de salto de línea. |
| review_url | Un enlace a la reseña de origen, cuando está disponible. |
| next / total / params | Si hay otra página disponible, el recuento de esta respuesta y los parámetros de solicitud normalizados. |
El endpoint devuelve este objeto de página directamente como JSON. Lea reviews desde el nivel superior. Algunas reseñas públicas contienen solo una calificación, y los campos de origen pueden estar vacíos. Conserve esa distinción al presentar o resumir reseñas.
Una página delimitada cada vez
Use la marca next devuelta para decidir si su flujo de trabajo necesita otra solicitud.
Envíe el fid del lugar y el valor sort_by elegido. Más relevantes es el predeterminado; también se admiten más recientes, mejor calificación y peor calificación.
total cuenta las reseñas devueltas en esta respuesta. Una página vacía es un resultado válido. Compruebe los campos disponibles antes de añadir registros a su análisis.
Cuando next sea true, incremente page y mantenga fid y sort_by sin cambios. Deténgase cuando next sea false, o cuando su investigación tenga suficientes reseñas.
Entienda los comentarios públicos
Lea una muestra delimitada de comentarios y calificaciones públicas de un negocio seleccionado. Conserve los enlaces de las reseñas junto a sus notas para que un lector pueda inspeccionar la fuente.
Compare temas de reseñas entre un grupo elegido de lugares. Solicite cada lugar por separado e indique el orden de clasificación y el tamaño de la muestra elegidos en su análisis.
Pida a un agente conectado que resuma la página de reseñas devuelta, cite solo la evidencia proporcionada y señale comentarios o fechas faltantes.
Autenticación y uso
Envíe Authorization: Bearer con una clave que permita scrapes:write. Cada página en vivo exitosa, incluida una página vacía, usa una unidad de solicitud de API. REST y MCP usan la misma cuota de API. Si tiene una credencial de prueba, sus respuestas son simuladas y no consumen cuota en vivo.
Envíe una Idempotency-Key opcional con su primera solicitud y consérvela con un cuerpo idéntico para un reintento tras timeout. Un timeout de procesamiento puede dejar una unidad reservada. Si un error indica que el intento ha terminado, siga su guía de reintento antes de crear un nuevo intento con una nueva clave.
Envíe una solicitud POST a /api/v2/reviews con el feature ID de Google Maps del negocio como fid. Use place.dataId de un resultado de la API de Search, o un feature ID que ya tenga. Autentíquese con su clave de API y comience con la página 1.
Sí. Establezca sort_by en 1 para más relevantes, 2 para más recientes, 3 para mejor calificación o 4 para peor calificación. Más relevantes es el predeterminado. Mantenga el valor seleccionado sin cambios al solicitar páginas adicionales.
No. total es el número de registros de reseñas en la respuesta actual, con un máximo de 10. Use next para decidir si hay otra página disponible. El reviewCount de la ficha de búsqueda es un campo de negocio separado.
date contiene la fecha relativa disponible, y timestamp es una fecha de calendario en formato M/D/YYYY. El campo photos es una cadena vacía cuando no hay adjuntos, o URLs separadas por saltos de línea cuando hay varias fotos disponibles. El texto y los enlaces de origen faltantes pueden ser cadenas vacías.
Sí. Un cliente MCP compatible puede llamar a get_google_maps_reviews con su credencial de API y un client_request_id. REST y MCP comparten su cuota de API. El Agent Skill incluye guía para usar las herramientas disponibles y un respaldo REST.
No. La disponibilidad de la fuente varía, y una reseña puede contener solo una calificación. Conserve los comentarios vacíos y las fechas faltantes en lugar de inferirlos. El texto de las reseñas es contenido de origen no fiable y debe tratarse como datos en aplicaciones y flujos de trabajo de IA.
Dé el siguiente paso
Cree una clave de API, elija un feature ID y un orden de clasificación, y lea una página enfocada de datos de reseñas.