# Palavras-chave e tendências

> Palavras-chave e tendências: Volume de busca, ideias de palavras-chave, intenção e tendências.

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

## O que é Palavras-chave e tendências na APIcultura

Acesse Palavras-chave e tendências pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Volume de busca, ideias de palavras-chave, intenção e tendências. 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 |
|---|---|---|---|
| `keywords-ideias` | Ideias de palavras-chave | R$ 0,11 | `POST /v1/call/keywords-ideias` |
| `keywords-volume` | Volume de busca | R$ 0,81 | `POST /v1/call/keywords-volume` |
| `keywords-sugestoes` | Sugestões que contêm o termo | R$ 0,11 | `POST /v1/call/keywords-sugestoes` |
| `keywords-intencao-busca` | Intenção de busca | R$ 0,12 | `POST /v1/call/keywords-intencao-busca` |
| `tendencias-google` | Google Trends | R$ 0,10 | `POST /v1/call/tendencias-google` |
| `keywords-historico` | Histórico de volume | R$ 0,11 | `POST /v1/call/keywords-historico` |
| `google-autocompletar-ideias` | Ideias por autocompletar | R$ 0,01 | `POST /v1/call/google-autocompletar-ideias` |

### Ideias de palavras-chave (`keywords-ideias`)

Palavras-chave relacionadas a um termo, com volume, CPC e dificuldade. Preço: R$ 0,11 por chamada.

- `keyword` (string, obrigatório), ex.: `coffee`
- `location_code` (integer, obrigatório), ex.: `2840`
- `language_code` (string, obrigatório), ex.: `en`
- `depth` (integer, opcional), ex.: `1`
- `limit` (integer, opcional), ex.: `2`
- `offset` (integer, opcional)
- `include_seed_keyword` (boolean, opcional)
- `include_serp_info` (boolean, opcional)
- `include_clickstream_data` (boolean, opcional)
- `ignore_synonyms` (boolean, opcional)

### Schema de entrada de keywords-ideias

```json
{
  "required": [
    "keyword",
    "location_code",
    "language_code"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "depth": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "include_seed_keyword": {
      "type": "boolean"
    },
    "include_serp_info": {
      "type": "boolean"
    },
    "include_clickstream_data": {
      "type": "boolean"
    },
    "ignore_synonyms": {
      "type": "boolean"
    }
  }
}
```

### Volume de busca (`keywords-volume`)

Volume mensal de busca e CPC para até 1000 palavras-chave. Preço: R$ 0,81 por chamada.

- `keywords` (array, obrigatório), ex.: `coffee`
- `location_code` (integer, opcional), ex.: `2840`
- `language_code` (string, opcional), ex.: `en`
- `search_partners` (boolean, opcional)
- `date_from` (string, opcional)
- `date_to` (string, opcional)
- `include_adult_keywords` (boolean, opcional)
- `sort_by` (string, opcional)

### Schema de entrada de keywords-volume

```json
{
  "required": [
    "keywords"
  ],
  "properties": {
    "keywords": {
      "type": "array"
    },
    "location_code": {
      "type": "number"
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "search_partners": {
      "type": "boolean"
    },
    "date_from": {
      "type": "string",
      "maxLength": 2000
    },
    "date_to": {
      "type": "string",
      "maxLength": 2000
    },
    "include_adult_keywords": {
      "type": "boolean"
    },
    "sort_by": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Sugestões que contêm o termo (`keywords-sugestoes`)

Palavras-chave que contêm o termo informado, com métricas. Preço: R$ 0,11 por chamada.

- `keyword` (string, opcional), ex.: `phone`
- `location_name` (string, opcional)
- `location_code` (integer, opcional), ex.: `2840`
- `language_name` (string, opcional)
- `language_code` (string, opcional), ex.: `en`
- `include_seed_keyword` (boolean, opcional), ex.: `true`
- `include_serp_info` (boolean, opcional), ex.: `true`
- `include_clickstream_data` (boolean, opcional)
- `exact_match` (boolean, opcional)
- `ignore_synonyms` (boolean, opcional)
- `filters` (array, opcional)
- `order_by` (array, opcional)
- `limit` (integer, opcional), ex.: `1`
- `offset` (integer, opcional)
- `offset_token` (string, opcional)
- `tag` (string, opcional)

### Schema de entrada de keywords-sugestoes

```json
{
  "required": [],
  "properties": {
    "keyword": {
      "type": "string",
      "maxLength": 2000
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "language_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "include_seed_keyword": {
      "type": "boolean"
    },
    "include_serp_info": {
      "type": "boolean"
    },
    "include_clickstream_data": {
      "type": "boolean"
    },
    "exact_match": {
      "type": "boolean"
    },
    "ignore_synonyms": {
      "type": "boolean"
    },
    "filters": {
      "type": "array"
    },
    "order_by": {
      "type": "array"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "offset_token": {
      "type": "string",
      "maxLength": 2000
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Intenção de busca (`keywords-intencao-busca`)

Classifica a intenção de busca de até 1000 palavras-chave. Preço: R$ 0,12 por chamada.

- `keywords` (array, opcional), ex.: `login page,audi a7,elon musk,milk store new york`
- `language_name` (string, opcional)
- `language_code` (string, opcional), ex.: `en`
- `tag` (string, opcional)

### Schema de entrada de keywords-intencao-busca

```json
{
  "required": [],
  "properties": {
    "keywords": {
      "type": "array"
    },
    "language_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Google Trends (`tendencias-google`)

Popularidade de termos ao longo do tempo no Google Trends. Preço: R$ 0,10 por chamada.

- `keywords` (array, opcional), ex.: `rugby,cricket`
- `location_name` (string, opcional), ex.: `United States`
- `location_code` (string, opcional)
- `language_name` (string, opcional)
- `language_code` (string, opcional)
- `type` (string, opcional), ex.: `youtube`
- `category_code` (integer, opcional), ex.: `3`
- `date_from` (string, opcional), ex.: `2026-04-24`
- `date_to` (string, opcional), ex.: `2026-06-24`
- `time_range` (string, opcional)
- `tag` (string, opcional)

### Schema de entrada de tendencias-google

```json
{
  "required": [],
  "properties": {
    "keywords": {
      "type": "array"
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "string",
      "maxLength": 2000
    },
    "language_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "type": {
      "type": "string",
      "maxLength": 2000
    },
    "category_code": {
      "type": "number"
    },
    "date_from": {
      "type": "string",
      "maxLength": 2000
    },
    "date_to": {
      "type": "string",
      "maxLength": 2000
    },
    "time_range": {
      "type": "string",
      "maxLength": 2000
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

### Histórico de volume (`keywords-historico`)

Volume histórico e CPC de palavras-chave. Preço: R$ 0,11 por chamada.

- `keywords` (array, opcional), ex.: `iphone`
- `location_name` (string, opcional)
- `location_code` (integer, opcional), ex.: `2840`
- `language_name` (string, opcional)
- `language_code` (string, opcional), ex.: `en`
- `tag` (string, opcional)

### Schema de entrada de keywords-historico

```json
{
  "required": [],
  "properties": {
    "keywords": {
      "type": "array"
    },
    "location_name": {
      "type": "string",
      "maxLength": 2000
    },
    "location_code": {
      "type": "number"
    },
    "language_name": {
      "type": "string",
      "maxLength": 2000
    },
    "language_code": {
      "type": "string",
      "maxLength": 2000
    },
    "tag": {
      "type": "string",
      "maxLength": 2000
    }
  }
}
```

Mais 1 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": "keywords-ideias", "input": {"keyword":"coffee","location_code":2840,"language_code":"en","depth":1,"limit":2}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/keywords-ideias \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"coffee","location_code":2840,"language_code":"en","depth":1,"limit":2}'
```

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

## Experimente

Teste no playground interativo: [Palavras-chave e tendências no playground](/ferramentas/ferramenta.html?slug=palavras-chave). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Palavras-chave e tendências é marca de seus respectivos donos, citada apenas para identificar a integração.