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 APIG Maps Crawl para desarrolladores
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
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
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.
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.
{
"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
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 APIBusque 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ápidoProcese 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ónCree algo útil
Use los registros devueltos como entradas para su propia investigación, informes y flujos de trabajo internos.
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.
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.
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
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
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.
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.
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.
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.
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.
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.
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.
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 una clave de API, comience con una solicitud y explore los datos que su aplicación puede usar.