Palavras-chave e tendências

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

Atualizado em .

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. 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 fazPreço por chamadaRota
keywords-ideiasIdeias de palavras-chaveR$ 0,11POST /v1/call/keywords-ideias
keywords-volumeVolume de buscaR$ 0,81POST /v1/call/keywords-volume
keywords-sugestoesSugestões que contêm o termoR$ 0,11POST /v1/call/keywords-sugestoes
keywords-intencao-buscaIntenção de buscaR$ 0,12POST /v1/call/keywords-intencao-busca
tendencias-googleGoogle TrendsR$ 0,10POST /v1/call/tendencias-google
keywords-historicoHistórico de volumeR$ 0,11POST /v1/call/keywords-historico
google-autocompletar-ideiasIdeias por autocompletarR$ 0,01POST /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.

Schema de entrada de keywords-ideias

{
  "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.

Schema de entrada de keywords-volume

{
  "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.

Schema de entrada de keywords-sugestoes

{
  "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.

Schema de entrada de keywords-intencao-busca

{
  "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.

Schema de entrada de tendencias-google

{
  "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.

Schema de entrada de keywords-historico

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

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

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. Veja também todas as ferramentas, como conectar seu agente e o FAQ.

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