G Maps Crawl para desarrolladores

Datos de Google Maps.
Integrados en su flujo de trabajo.

Busque negocios, lea reseñas públicas y explore fotos y vídeos de lugares. Desarrolle con una API REST síncrona o dé a su asistente de IA acceso mediante MCP.

JSON estructurado

Resultados en la misma respuesta

REST + MCP

Use su aplicación o cliente de IA

Una cuota de API

Compartida entre solicitudes de API y MCP

Elija sus datos

Una API para cada paso de su investigación

Comience con una búsqueda de negocios y luego use el feature ID del lugar para solicitar reseñas o elementos de la galería. Cada API tiene sus propios ejemplos y referencia de campos.

Su primera solicitud a la API

Pase de una solicitud a datos estructurados

Use una clave de API en el encabezado Authorization. Explore los formatos de solicitud a continuación y luego siga la guía de inicio rápido para realizar su primera llamada.

Ejemplos de solicitud

Para el contrato completo, consulte la documentación de la API.

curl https://gmapscrawl.com/api/v1/search \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seattle-coffee-search-001" \
  -d '{"q":"coffee shops in Seattle","page":1,"extra":false}'

Respuesta vacía ilustrativa. Una búsqueda en vivo devuelve los negocios disponibles. Mantenga su clave de API en el lado del servidor; use una nueva clave de idempotencia para trabajo nuevo y consérvela para un reintento sin cambios.

Respuesta

JSON ilustrativo
{
  "data": {
    "total": 0,
    "params": {
      "q": "coffee shops in Seattle",
      "page": 1,
      "hl": "en",
      "extra": false
    },
    "businesses": []
  },
  "request_id": "req_example",
  "schema_version": "2026-09-22"
}

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.

Desarrolle con HTTP estándar

Una pequeña integración. Un flujo de datos útil.

01

Cree una clave de API

Cree una credencial en su espacio de trabajo de API y consérvela en la configuración secreta de su servidor o cliente. REST y MCP usan la misma cuota de API.

Abrir claves de API
02

Elija una API

Busque con una palabra clave y una ubicación. Para reseñas y fotos, proporcione el feature ID de Maps que ya tenga o lea place.dataId de un resultado de búsqueda.

Seguir la guía de inicio rápido
03

Lea la respuesta JSON

Procese la página devuelta en su aplicación. Siga las reglas de paginación del endpoint, inspeccione los campos faltantes y conserve la clave de idempotencia de la solicitud para los reintentos.

Entender la paginación

Cree algo útil

Lleve los datos de Maps a su aplicación

Use los registros devueltos como entradas para su propia investigación, informes y flujos de trabajo internos.

01

Investigación de negocios locales

Busque una categoría y una ubicación, luego organice los nombres de negocios, direcciones, sitios web, números de teléfono y calificaciones disponibles en su aplicación.

02

Análisis de reseñas

Consulte las reseñas públicas de un lugar para estudiar los comentarios de los clientes. Elija un orden de clasificación coherente y siga las páginas disponibles para su análisis.

03

Investigación de la galería de un lugar

Recupere los enlaces de fotos y vídeos disponibles de un lugar. Conserve el enlace de la galería de origen junto a los registros para que su equipo pueda inspeccionar el contexto original.

Su agente, conectado

Use los mismos datos a través de su cliente de IA.

Conecte el servidor MCP para herramientas detectables, o instale el Agent Skill para instrucciones de flujo de trabajo reutilizables y un respaldo REST.

Tarea de ejemplo para su agente conectado

«Busque una página de cafeterías en Seattle. Devuelva los nombres, sitios web y calificaciones disponibles, y señale los datos faltantes.»

Las solicitudes usan su cuota de API. Con una credencial de prueba, los resultados son simulados.

Planifique su integración

Entienda el uso antes de escalar

Cada página en vivo exitosa, incluida una página vacía, usa una solicitud de API. REST y MCP comparten su plan de API; las cuotas de Online y Extensión son separadas.

Mantenga las solicitudes predecibles

Comience con una página, compruebe los campos devueltos y establezca un timeout de cliente apropiado para el endpoint. Para los reintentos, reutilice la misma Idempotency-Key con un cuerpo de solicitud sin cambios.

Los límites del plan, los límites de frecuencia, la disponibilidad de la fuente y el enriquecimiento afectan a las solicitudes en vivo. Las credenciales de prueba devuelven fixtures simulados sin consumir su cuota en vivo.

Use las páginas de endpoint para los límites de solicitud y los campos de resultado. La página de precios enumera las solicitudes incluidas actuales y las tarifas de excedente de pago.

Preguntas frecuentes

¿Qué API de Google Maps están disponibles?

G Maps Crawl ofrece API de búsqueda de negocios, reseñas públicas de lugares y fotos/galería de lugares. La búsqueda devuelve registros de negocios; Reviews y Photos usan un feature ID de Maps para devolver una página de un lugar específico.

¿Puedo usar Python o JavaScript?

Sí. Las API usan solicitudes HTTP y JSON, por lo que puede llamarlas con Python, JavaScript, cURL u otro cliente HTTP. Cada página de API incluye ejemplos de solicitud y una respuesta de muestra.

¿Necesito consultar el resultado de un trabajo?

Las API públicas de Search, Reviews y Photos devuelven JSON en la misma respuesta. No requieren sondeo de trabajos ni configuración de webhooks. Siga la guía de timeout y reintentos del endpoint.

¿Cómo funcionan juntos la API, MCP y el Agent Skill?

REST permite a su aplicación llamar directamente a un endpoint. MCP pone las herramientas a disposición de un cliente de IA compatible. El Agent Skill proporciona instrucciones de flujo de trabajo y scripts auxiliares. Las solicitudes REST y MCP requieren credenciales de API y usan su cuota de API.

¿Dónde obtengo un feature ID para reseñas y fotos?

Use un feature ID de Maps que ya tenga, o copie place.dataId de un registro coincidente en el array data.businesses de la API de Search. Pase ese valor como fid a la API de Reviews o Photos.

¿Está garantizada la disponibilidad de todos los campos?

No. Los campos devueltos dependen de la fuente y de la operación seleccionada. Inspeccione los valores faltantes y las marcas de tiempo de observación disponibles antes de usar los datos. Una respuesta exitosa puede contener una página vacía.

Dé el siguiente paso

Cree su primer flujo de trabajo de datos de Google Maps.

Cree una clave de API, comience con una solicitud y explore los datos que su aplicación puede usar.