Crie uma chave de API
Crie uma credencial no seu workspace de API e mantenha-a na configuração secreta do seu servidor ou cliente. REST e MCP usam a mesma cota de API.
Abrir chaves de APIG Maps Crawl para desenvolvedores
Pesquise empresas, leia avaliações públicas e navegue por fotos e vídeos de lugares. Construa com uma API REST síncrona ou dê acesso ao seu assistente de IA via MCP.
JSON estruturado
Resultados na mesma resposta
REST + MCP
Use seu aplicativo ou cliente de IA
Uma cota de API
Compartilhada entre requisições de API e MCP
Escolha seus dados
Comece com uma pesquisa de empresas, depois use o feature ID do lugar para solicitar avaliações ou itens de galeria. Cada API tem seus próprios exemplos e referência de campos.
Sua primeira requisição de API
Use uma chave de API no cabeçalho Authorization. Explore os formatos de requisição abaixo, depois siga o início rápido para fazer sua primeira chamada.
Para o contrato completo, consulte a documentação da 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}'Resposta vazia ilustrativa. Uma pesquisa live retorna as empresas disponíveis. Mantenha sua chave de API no lado do servidor; use uma nova chave de idempotência para novo trabalho e preserve-a para uma nova tentativa inalterada.
{
"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"
}A API retorna JSON na mesma resposta. Após um timeout, repita o corpo inalterado com a mesma Idempotency-Key. Credenciais de teste retornam dados simulados sem usar sua cota live.
Construa com HTTP padrão
Crie uma credencial no seu workspace de API e mantenha-a na configuração secreta do seu servidor ou cliente. REST e MCP usam a mesma cota de API.
Abrir chaves de APIPesquise com uma palavra-chave e localização. Para avaliações e fotos, forneça o feature ID do Maps que você já tem ou leia place.dataId de um resultado de pesquisa.
Seguir o início rápidoProcesse a página retornada no seu aplicativo. Siga as regras de paginação do endpoint, inspecione campos ausentes e preserve a chave de idempotência da requisição para novas tentativas.
Entenda a paginaçãoConstrua algo útil
Use os registros retornados como entradas para sua própria pesquisa, relatórios e fluxos de trabalho internos.
Pesquise uma categoria e localização, depois organize nomes, endereços, sites, telefones e avaliações disponíveis no seu aplicativo.
Consulte as avaliações públicas de um lugar para estudar o feedback dos clientes. Escolha uma ordem de classificação consistente e acompanhe as páginas disponíveis para sua análise.
Recupere links de fotos e vídeos disponíveis de um lugar. Mantenha o link da galeria de origem com os registros para que sua equipe possa inspecionar o contexto original.
Seu agente, conectado
Conecte o servidor MCP para ferramentas detectáveis, ou instale o Agent Skill para instruções de fluxo de trabalho reutilizáveis e um fallback REST.
Tarefa de exemplo para o seu agente conectado
“Pesquise uma página de cafeterias em Seattle. Retorne os nomes, sites e avaliações disponíveis e aponte os dados ausentes.”
As requisições usam sua cota de API. Com uma credencial de teste, os resultados são simulados.
Planeje sua integração
Cada página live bem-sucedida, incluindo uma página vazia, usa uma requisição de API. REST e MCP compartilham seu plano de API; as cotas Online e da Extensão são separadas.
Comece com uma página, verifique os campos retornados e defina um timeout de cliente adequado ao endpoint. Para novas tentativas, reutilize a mesma Idempotency-Key com um corpo de requisição inalterado.
Limites de plano, limites de taxa, disponibilidade da fonte e enriquecimento afetam requisições live. Credenciais de teste retornam fixtures simulados sem consumir sua cota live.
Use as páginas de endpoint para limites de requisição e campos de resultado. A página de preços lista as requisições incluídas atuais e as tarifas de excedente pagas.
O G Maps Crawl fornece APIs de pesquisa de empresas, avaliações públicas de lugares e fotos/galeria de lugares. A pesquisa retorna registros de empresas; Reviews e Photos usam um feature ID do Maps para retornar uma página de um lugar específico.
Sim. As APIs usam requisições HTTP e JSON, então você pode chamá-las com Python, JavaScript, cURL ou outro cliente HTTP. Cada página de API inclui exemplos de requisição e uma resposta de exemplo.
As APIs públicas Search, Reviews e Photos retornam JSON na mesma resposta. Elas não exigem polling de job nem configuração de webhook. Siga as orientações de timeout e nova tentativa do endpoint.
REST permite que seu aplicativo chame um endpoint diretamente. MCP disponibiliza ferramentas para um cliente de IA compatível. O Agent Skill fornece instruções de fluxo de trabalho e scripts auxiliares. Requisições REST e MCP exigem credenciais de API e usam sua cota de API.
Use um feature ID do Maps que você já tem, ou copie place.dataId de um registro correspondente no array data.businesses da API Search. Passe esse valor como fid para a API Reviews ou Photos.
Não. Os campos retornados dependem da fonte e da operação selecionada. Inspecione valores ausentes e timestamps de observação disponíveis antes de usar os dados. Uma resposta bem-sucedida pode conter uma página vazia.
Dê o próximo passo
Crie uma chave de API, comece com uma requisição e explore os dados que seu aplicativo pode usar.