Google Maps e negócios locais

Google Maps e negócios locais: Busca de empresas, avaliações, fotos e perguntas de negócios no Google Maps.

Atualizado em 05/11/2026.

O que é Google Maps e negócios locais na APIcultura

Acesse Google Maps e negócios locais pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Busca de empresas, avaliações, fotos e perguntas de negócios no Google Maps. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: Mapas e locais. Autenticação: chave da própria APIcultura (apk_live_...); nenhuma conta de terceiros precisa ser conectada.

Endpoints e preço por chamada

Endpoint (slug)	O que faz	Preço por chamada	Rota
`maps-buscar-lugares`	Buscar lugares no Maps	R$ 0,03	`POST /v1/call/maps-buscar-lugares`
`maps-buscar-locais`	Locais do Google	R$ 0,01	`POST /v1/call/maps-buscar-locais`
`maps-avaliacoes-lugar`	Avaliações de um lugar	R$ 0,01	`POST /v1/call/maps-avaliacoes-lugar`
`maps-detalhe-lugar`	Detalhe de um lugar	R$ 0,02	`POST /v1/call/maps-detalhe-lugar`
`maps-buscar-barato`	Buscar empresas (econômico)	R$ 0,01	`POST /v1/call/maps-buscar-barato`
`maps-avaliacoes-econ`	Avaliações (econômico)	R$ 0,01	`POST /v1/call/maps-avaliacoes-econ`
`maps-contatos-empresas`	Contatos de empresas do Maps	R$ 0,85	`POST /v1/call/maps-contatos-empresas`
`maps-listagem-negocios`	Listagem de negócios	R$ 0,12	`POST /v1/call/maps-listagem-negocios`
`maps-perfil-empresa`	Perfil da empresa no Google	R$ 0,05	`POST /v1/call/maps-perfil-empresa`
`maps-perguntas-respostas`	Perguntas e respostas do local	R$ 0,05	`POST /v1/call/maps-perguntas-respostas`

Buscar lugares no Maps (`maps-buscar-lugares`)

Empresas e lugares do Google Maps para uma busca e região. Preço: R$ 0,03 por chamada.

q (string, obrigatório), ex.: OpenAI San Francisco
ll (string, opcional), ex.: @37.7749,-122.4194,12z
placeId (string, opcional)
cid (string, opcional)
hl (string, opcional, padrão "en"), ex.: en
page (integer, opcional, padrão 1, mín. 1)

Schema de entrada de maps-buscar-lugares

{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "ll": {
      "type": "string",
      "maxLength": 2000
    },
    "placeId": {
      "type": "string",
      "maxLength": 2000
    },
    "cid": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "number"
    }
  }
}

Locais do Google (`maps-buscar-locais`)

Locais do Google para uma consulta. Preço: R$ 0,01 por chamada.

q (string, obrigatório), ex.: coffee near Times Square
location (string, opcional), ex.: New York, New York, United States
gl (string, opcional, padrão "us"), ex.: us
hl (string, opcional, padrão "en"), ex.: en
page (integer, opcional, padrão 1, mín. 1)
autocorrect (boolean, opcional, padrão true)

Schema de entrada de maps-buscar-locais

{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "page": {
      "type": "number"
    },
    "autocorrect": {
      "type": "boolean"
    }
  }
}

Avaliações de um lugar (`maps-avaliacoes-lugar`)

Avaliações de um lugar do Google. Preço: R$ 0,01 por chamada.

cid (string, opcional), ex.: 855637193957362546
fid (string, opcional)
placeId (string, opcional)
gl (string, opcional, padrão "us"), ex.: us
hl (string, opcional, padrão "en"), ex.: en
sortBy (string, opcional)
topicId (string, opcional)
nextPageToken (string, opcional)

Schema de entrada de maps-avaliacoes-lugar

{
  "required": [],
  "properties": {
    "cid": {
      "type": "string",
      "maxLength": 2000
    },
    "fid": {
      "type": "string",
      "maxLength": 2000
    },
    "placeId": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    },
    "sortBy": {
      "type": "string",
      "maxLength": 2000
    },
    "topicId": {
      "type": "string",
      "maxLength": 2000
    },
    "nextPageToken": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Detalhe de um lugar (`maps-detalhe-lugar`)

Detalhes de um lugar do Google Maps. Preço: R$ 0,02 por chamada.

categoryFilterWords (array, opcional)
language (string, opcional, padrão "en")
location (string, opcional), ex.: San Francisco, CA
placeMinimumStars (string, opcional)
query (string, obrigatório), ex.: Blue Bottle Coffee
website (string, opcional)

Schema de entrada de maps-detalhe-lugar

{
  "required": [
    "query"
  ],
  "properties": {
    "categoryFilterWords": {
      "type": "array"
    },
    "language": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "placeMinimumStars": {
      "type": "string",
      "maxLength": 2000
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    },
    "website": {
      "type": "string",
      "maxLength": 2000
    },
    "fields": {
      "type": "string",
      "maxLength": 2000
    },
    "max_items": {
      "type": "number"
    },
    "summary": {
      "type": "boolean"
    },
    "jq": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Buscar empresas (econômico) (`maps-buscar-barato`)

Busca de empresas locais por palavra-chave e categoria. Preço: R$ 0,01 por chamada.

limit (integer, opcional)
location (string, opcional), ex.: Austin, TX
query (string, obrigatório), ex.: coffee

Schema de entrada de maps-buscar-barato

{
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "query": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Avaliações (econômico) (`maps-avaliacoes-econ`)

Avaliações de um lugar no Google Maps. Preço: R$ 0,01 por chamada.

limit (integer, opcional)
place (string, obrigatório), ex.: ChIJG-gJw2vKRIYROWi2uwOp8QE
sort (string, opcional), ex.: newest

Schema de entrada de maps-avaliacoes-econ

{
  "required": [
    "place"
  ],
  "properties": {
    "limit": {
      "type": "number"
    },
    "place": {
      "type": "string",
      "maxLength": 2000
    },
    "sort": {
      "type": "string",
      "maxLength": 2000
    }
  }
}

Mais 4 endpoints na tabela acima; os parâmetros seguem o input_schema de cada um.

Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta call com o slug do endpoint e a entrada:

{ "name": "call", "arguments": { "slug": "maps-buscar-lugares", "input": {"q":"OpenAI San Francisco","ll":"@37.7749,-122.4194,12z","hl":"en"}, "max_cost_brl": 0.1 } }

Exemplo de chamada HTTP

curl -X POST https://api.apicultura.app/v1/call/maps-buscar-lugares \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"q":"OpenAI San Francisco","ll":"@37.7749,-122.4194,12z","hl":"en"}'

Formato da resposta, preço e limites

A resposta é JSON com data (o resultado do endpoint) e meta (inclui cost_brl, o valor cobrado). Preço deste endpoint: R$ 0,03 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use max_cost_brl para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

Workflows que usam Google Maps e negócios locais

Experimente

Teste no playground interativo: Google Maps e negócios locais no playground. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

Nota. Google Maps e negócios locais é marca de seus respectivos donos, citada apenas para identificar a integração.