POST /api/v2/reviews

API de scraping de reseñas de Google Maps

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.

Ejemplos de solicitud

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.

Respuesta

JSON ilustrativo
{
  "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

Elija el negocio y el orden de las reseñas.

Solicite una página enfocada de un lugar y luego elija el orden de reseñas que se ajuste a su investigación.

Parámetros de solicitud de la API de scraping de reseñas de Google Maps
CampoSignificado
fid · obligatorioUn 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 1Una página numerada positiva. Increméntela solo cuando la respuesta anterior tenga next: true.
sort_by · predeterminado 11 = 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

Calificaciones, comentarios y enlaces de origen.

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.

Campos de respuesta de la API de scraping de reseñas de Google Maps
CampoSignificado
idEl identificador de la reseña de origen, cuando está disponible.
rate / commentLa 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 / timestampLa 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 / avatarNombre visible del autor, URL del perfil de colaborador y URL del avatar disponibles.
photosUna cadena vacía sin adjuntos. Varias URLs de fotos se separan con caracteres de salto de línea.
review_urlUn enlace a la reseña de origen, cuando está disponible.
next / total / paramsSi 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

Lea hasta 10 reseñas en cada respuesta.

Use la marca next devuelta para decidir si su flujo de trabajo necesita otra solicitud.

01

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.

02

Inspeccione la página actual

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.

03

Continúe deliberadamente

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

Añada contexto de reseñas a su investigación de negocios.

01

Investigación de reseñas

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.

02

Comparaciones de comentarios

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.

03

Resúmenes asistidos por agente

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

Use su clave de API para cada página.

Cuota de API compartida

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.

Ver planes y límites de API →

Mantenga los reintentos vinculados a la solicitud

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.

Lea la guía de errores y reintentos →

Preguntas frecuentes

¿Cómo obtengo reseñas de un negocio específico de Google Maps?

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.

¿Puedo ordenar las reseñas de Google Maps por más recientes o por calificación?

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.

¿total me dice cuántas reseñas tiene el negocio?

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.

¿Qué formato tienen las fechas y las fotos de las reseñas?

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.

¿Puedo usar reseñas a través de MCP?

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.

¿Puedo asumir que todos los campos de reseña están presentes?

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

Comience con las reseñas públicas de un lugar.

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.