APIs

API de Dados do Google Maps

Extraia informações públicas estruturadas de empresas a partir de buscas no Google Maps para pesquisa de mercado, descoberta de leads e análise baseada em localização.

Acesso Antecipado — requer token de API

O que retorna

Uma única requisição retorna uma lista estruturada de empresas correspondentes a uma busca, com campos consistentes prontos para uso em análise, prospecção ou integrações de software. Os dados são coletados de resultados públicos do Google Maps.

Campos de dados disponíveis

Os campos listados abaixo são suportados pela API. Um pequeno número depende do motor de extração ou disponibilidade da fonte.

CampoDescriçãoChave
Nome da empresaNome público do localnome
CategoriaCategoria principal do negóciocategoria
EndereçoEndereço público completoendereco
Horário de funcionamentoStatus / horário atual de funcionamentohorario
Faixa de preçoNível de preço, quando disponívelfaixa_preco
AvaliaçãoNota agregada, quando disponívelnota
Telefone / WhatsAppContato público, quando disponívelwhatsapp
Descrição curtaResumo do local, quando disponíveldescricao_curta
FotosURLs de imagens públicasfotos
AcessibilidadeAtributos de acessibilidade, quando disponívelacessibilidade
Tipos de negócioTags detalhadas de tipotipos
Place IDIdentificador único estávelplace_id

A contagem de avaliações é retornada pelo motor baseado em navegador sob demanda; não faz parte da resposta rápida padrão.

Exemplo de resposta

Resposta JSON representativa para uma busca.

  GET /scrape?query=coffee+shop
{
  "success": true,
  "count": 1,
  "data": [
    {
      "nome": "Blue Harbour Coffee",
      "nota": "4.7",
      "categoria": "Coffee shop",
      "endereco": "142 Market St, San Francisco, CA",
      "horario": "Open - Closes 7PM",
      "faixa_preco": "$$",
      "whatsapp": "+1 415-555-0142",
      "tipos": ["coffee_shop", "food"],
      "descricao_curta": "Specialty coffee and fresh pastries",
      "fotos": ["https://lh3.googleusercontent.com/..."],
      "acessibilidade": ["Wheelchair accessible entrance"],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4"
    }
  ]
}

Como funciona

1. Solicite acesso

Entre em contato para receber um token de API durante o período de acesso antecipado.

2. Consulte

Envie uma busca (e localização e limites opcionais) para o endpoint.

3. Integre

Receba JSON estruturado pronto para sua aplicação ou pipeline.

A documentação pública completa será publicada conforme a API estabiliza. A API atualmente requer autenticação e não está abertamente disponível.