# 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.

URL: https://apicultura.app/ferramentas/google-maps-locais/
Atualizado em 05/11/2026 (2026-11-05).

## 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](/catalogo/?cat=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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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

```json
{
  "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:

```json
{ "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

```bash
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

- [Prospectar empresas B2B de um nicho e enriquecer com e-mail verificado e telefone comercial](/workflows/prospeccao-b2b/)
- [Pesquisa de mercado local com avaliações do Google Maps](/workflows/pesquisa-mercado-local/)
- [Lista de leads de um bairro ou cidade](/workflows/leads-do-bairro/)
- [Comparar a reputação pública de três concorrentes](/workflows/reputacao-concorrentes/)

## Experimente

Teste no playground interativo: [Google Maps e negócios locais no playground](/ferramentas/ferramenta.html?slug=google-maps-locais). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

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