G Maps Crawl para desenvolvedores

Dados do Google Maps.
Integrados ao seu fluxo de trabalho.

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

Uma API para cada etapa da sua pesquisa

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

De uma requisição a dados estruturados

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.

Exemplos de requisição

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.

Resposta

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"
}

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

Uma pequena integração. Um fluxo de dados útil.

01

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 API
02

Escolha uma API

Pesquise 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ápido
03

Leia a resposta JSON

Processe 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ção

Construa algo útil

Traga dados do Maps para o seu aplicativo

Use os registros retornados como entradas para sua própria pesquisa, relatórios e fluxos de trabalho internos.

01

Pesquisa de empresas locais

Pesquise uma categoria e localização, depois organize nomes, endereços, sites, telefones e avaliações disponíveis no seu aplicativo.

02

Análise de avaliações

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.

03

Pesquisa de galeria de lugares

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

Use os mesmos dados pelo seu cliente de IA.

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

Entenda o uso antes de escalar

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.

Mantenha as requisições previsíveis

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.

Perguntas frequentes

Quais APIs do Google Maps estão disponíveis?

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.

Posso usar Python ou JavaScript?

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.

Preciso fazer polling para obter o resultado de um job?

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.

Como API, MCP e o Agent Skill funcionam juntos?

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.

Onde obtenho um feature ID para avaliações e fotos?

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.

Todo campo é garantido como disponível?

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

Construa seu primeiro fluxo de dados do Google Maps.

Crie uma chave de API, comece com uma requisição e explore os dados que seu aplicativo pode usar.