# Busca no Google (SERP)

> Busca no Google (SERP): Resultados do Google em tempo real: web, notícias, imagens, sugestões e respostas de IA.

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

## O que é Busca no Google (SERP) na APIcultura

Acesse Busca no Google (SERP) pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Resultados do Google em tempo real: web, notícias, imagens, sugestões e respostas de IA. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [SEO e tráfego](/catalogo/?cat=seo). 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 |
|---|---|---|---|
| `google-busca-web` | Busca no Google | R$ 0,01 | `POST /v1/call/google-busca-web` |
| `google-busca-noticias` | Notícias do Google | R$ 0,01 | `POST /v1/call/google-busca-noticias` |
| `google-busca-imagens` | Imagens do Google | R$ 0,02 | `POST /v1/call/google-busca-imagens` |
| `google-sugestoes-busca` | Sugestões de busca | R$ 0,01 | `POST /v1/call/google-sugestoes-busca` |
| `google-busca-compras` | Google Shopping | R$ 0,02 | `POST /v1/call/google-busca-compras` |
| `google-serp-completo` | SERP completo do Google | R$ 0,02 | `POST /v1/call/google-serp-completo` |
| `bing-busca-web` | Busca no Bing | R$ 0,02 | `POST /v1/call/bing-busca-web` |
| `google-modo-ia` | Google Modo IA | R$ 0,01 | `POST /v1/call/google-modo-ia` |
| `google-visao-geral-ia` | Visão geral de IA do Google | R$ 0,02 | `POST /v1/call/google-visao-geral-ia` |

### Busca no Google (`google-busca-web`)

Resultados orgânicos, caixas de resposta e perguntas relacionadas para uma consulta. Preço: R$ 0,01 por chamada.

- `q` (string, obrigatório), ex.: `OpenAI API documentation`
- `num` (integer, opcional, padrão 10, mín. 10, máx. 100)
- `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`
- `tbs` (string, opcional)
- `page` (integer, opcional, padrão 1, mín. 1)
- `autocorrect` (boolean, opcional, padrão true)

### Schema de entrada de google-busca-web

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

### Notícias do Google (`google-busca-noticias`)

Notícias recentes do Google para um assunto. Preço: R$ 0,01 por chamada.

- `q` (string, obrigatório), ex.: `OpenAI`
- `location` (string, opcional)
- `gl` (string, opcional, padrão "us"), ex.: `us`
- `hl` (string, opcional, padrão "en"), ex.: `en`
- `num` (integer, opcional, mín. 1, máx. 100)
- `tbs` (string, opcional)
- `page` (integer, opcional, padrão 1, mín. 1)
- `autocorrect` (boolean, opcional, padrão true)

### Schema de entrada de google-busca-noticias

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

### Imagens do Google (`google-busca-imagens`)

Resultados do Google Imagens para uma consulta. Preço: R$ 0,02 por chamada.

- `q` (string, obrigatório), ex.: `golden retriever`
- `location` (string, opcional)
- `gl` (string, opcional, padrão "us"), ex.: `us`
- `hl` (string, opcional, padrão "en"), ex.: `en`
- `tbs` (string, opcional)
- `page` (integer, opcional, padrão 1, mín. 1)
- `num` (integer, opcional, padrão 10)
- `autocorrect` (boolean, opcional, padrão true)

### Schema de entrada de google-busca-imagens

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

### Sugestões de busca (`google-sugestoes-busca`)

Sugestões de autocompletar do Google para um termo. Preço: R$ 0,01 por chamada.

- `q` (string, obrigatório), ex.: `how to build an ai`
- `location` (string, opcional)
- `gl` (string, opcional, padrão "us"), ex.: `us`
- `hl` (string, opcional, padrão "en"), ex.: `en`

### Schema de entrada de google-sugestoes-busca

```json
{
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 2000
    },
    "location": {
      "type": "string",
      "maxLength": 2000
    },
    "gl": {
      "type": "string",
      "maxLength": 2000
    },
    "hl": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Google Shopping (`google-busca-compras`)

Produtos, preços e lojas do Google Shopping para uma consulta. Preço: R$ 0,02 por chamada.

- `q` (string, obrigatório), ex.: `wireless headphones`
- `location` (string, opcional)
- `gl` (string, opcional, padrão "us"), ex.: `us`
- `hl` (string, opcional, padrão "en"), ex.: `en`
- `tbs` (string, opcional)
- `page` (integer, opcional, padrão 1, mín. 1)
- `num` (integer, opcional, padrão 40)
- `autocorrect` (boolean, opcional, padrão true)

### Schema de entrada de google-busca-compras

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

### SERP completo do Google (`google-serp-completo`)

Resultados orgânicos do Google para uma palavra-chave, com recursos da página, por país e idioma. Preço: R$ 0,02 por chamada.

- `keyword` (string, obrigatório), ex.: `coffee`
- `location_code` (integer, obrigatório), ex.: `2840`
- `location_name` (string, opcional)
- `language_code` (string, obrigatório), ex.: `en`
- `depth` (integer, opcional), ex.: `10`
- `device` (string, opcional)
- `os` (string, opcional)

### Schema de entrada de google-serp-completo

```json
{
  "required": [
    "keyword",
    "location_code",
    "language_code"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "depth": {
      "type": "number"
    },
    "device": {
      "type": "string",
      "maxLength": 2000
    },
    "os": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

Mais 3 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": "google-busca-web", "input": {"q":"OpenAI API documentation","location":"New York, New York, United States","gl":"us","hl":"en"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/google-busca-web \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"q":"OpenAI API documentation","location":"New York, New York, United States","gl":"us","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,01 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 Busca no Google (SERP)

- [Monitorar menções públicas da sua marca](/workflows/monitorar-mencoes/)
- [Monitor de preços de produtos nos marketplaces](/workflows/precos-concorrentes/)

## Experimente

Teste no playground interativo: [Busca no Google (SERP) no playground](/ferramentas/ferramenta.html?slug=busca-google). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Busca no Google (SERP) é marca de seus respectivos donos, citada apenas para identificar a integração.