Metrics

Métricas do Keyword.com pela API

Seu cliente conecta a conta do Keyword.com e seu produto consulta 34 métricas pelo mesmo endpoint das outras plataformas. Cada métrica tem um identificador (reference_key) que vai na chamada.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:total_keywords",
      "component": "number_v1",
      "metrics": [
        "total_keywords"
      ]
    }
  ]
}
Exemplo: "Palavras-chave monitoradas" em outubro, comparado a setembro.

Mais exemplos de chamadas no Keyword.com

O mesmo endpoint para cada tipo de métrica. Os campos metrics e dimensions de cada item vêm do catálogo da plataforma (GET /api/metrics/{integration_slug}).

Gráfico

Posição média ao longo do tempo

Evolução da posição média no Google das palavras-chave monitoradas durante o período analisado.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:average_position_over_time",
      "component": "chart_v1",
      "metrics": [
        "average_position"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Tabela

Posicionamento das palavras-chave

Posição de cada palavra-chave monitorada no fim do período analisado, com a variação acumulada no período e a página que está posicionada.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:keywords",
      "component": "datatable_v1",
      "metrics": [
        "position",
        "position_change",
        "best_position",
        "search_volume",
        "cpc",
        "ranking_url"
      ],
      "dimensions": [
        "keyword"
      ]
    }
  ]
}

Número

Palavras-chave posicionadas

Número de palavras-chave que ocupam alguma posição entre os 100 primeiros resultados do Google no fim do período analisado.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "keyword:ranked_keywords",
      "component": "number_v1",
      "metrics": [
        "ranked_keywords"
      ]
    }
  ]
}

Números

22 métricas

  • Palavras-chave monitoradas

    Número de palavras-chave monitoradas no projeto no fim do período analisado.

    keyword:total_keywords
  • Palavras-chave posicionadas

    Número de palavras-chave que ocupam alguma posição entre os 100 primeiros resultados do Google no fim do período analisado.

    keyword:ranked_keywords
  • Palavras-chave sem posição

    Número de palavras-chave que não foram encontradas entre os 100 primeiros resultados do Google no fim do período analisado.

    keyword:unranked_keywords
  • Posição média

    Posição média no Google das palavras-chave posicionadas no fim do período analisado. Palavras-chave fora dos 100 primeiros resultados não entram na média.

    keyword:average_position
  • Palavras-chave no top 3

    Número de palavras-chave entre os três primeiros resultados do Google no fim do período analisado.

    keyword:top_3
  • Palavras-chave no top 10

    Número de palavras-chave na primeira página do Google no fim do período analisado.

    keyword:top_10
  • Palavras-chave no top 20

    Número de palavras-chave entre os vinte primeiros resultados do Google no fim do período analisado.

    keyword:top_20
  • Palavras-chave no top 50

    Número de palavras-chave entre os cinquenta primeiros resultados do Google no fim do período analisado.

    keyword:top_50
  • Palavras-chave no top 100

    Número de palavras-chave entre os cem primeiros resultados do Google no fim do período analisado.

    keyword:top_100
  • Participação no top 3

    Percentual das palavras-chave monitoradas que estão entre os três primeiros resultados do Google no fim do período analisado.

    keyword:top_3_rate
  • Participação na primeira página

    Percentual das palavras-chave monitoradas que estão na primeira página do Google no fim do período analisado.

    keyword:top_10_rate
  • Participação posicionada

    Percentual das palavras-chave monitoradas encontradas entre os 100 primeiros resultados do Google no fim do período analisado.

    keyword:top_100_rate
  • Palavras-chave que subiram

    Número de palavras-chave que subiram no posicionamento entre o primeiro e o último dia do período analisado, incluindo as que entraram nos 100 primeiros resultados.

    keyword:improved_keywords
  • Palavras-chave que caíram

    Número de palavras-chave que perderam posições entre o primeiro e o último dia do período analisado, incluindo as que saíram dos 100 primeiros resultados.

    keyword:declined_keywords
  • Palavras-chave que mantiveram a posição

    Número de palavras-chave que terminaram o período analisado na mesma posição em que começaram.

    keyword:unchanged_keywords
  • Variação média de posição

    Média de posições ganhas durante o período analisado. Um valor positivo significa que as palavras-chave subiram no posicionamento.

    keyword:average_position_change
  • Volume de busca total

    Soma do volume de busca mensal de todas as palavras-chave monitoradas.

    keyword:total_search_volume
  • Volume de busca médio

    Volume de busca mensal médio das palavras-chave monitoradas.

    keyword:average_search_volume
  • CPC médio

    Custo por clique médio que o Google Ads informa para as palavras-chave monitoradas.

    keyword:average_cpc
  • Trechos em destaque

    Número de palavras-chave em que o domínio monitorado ocupa o trecho em destaque do Google.

    keyword:featured_snippets
  • Palavras-chave no pacote local

    Número de palavras-chave em que o domínio monitorado aparece nos resultados locais do Google.

    keyword:local_pack
  • Participação de voz

    Fatia dos cliques estimados das palavras-chave monitoradas que vai para o domínio do projeto, em comparação com todos os domínios posicionados para elas.

    keyword:share_of_voice

Gráficos

4 métricas

  • Posição média ao longo do tempo

    Evolução da posição média no Google das palavras-chave monitoradas durante o período analisado.

    keyword:average_position_over_time
  • Evolução do posicionamento

    Evolução de quantas palavras-chave estão no top 3, na primeira página e entre os 100 primeiros resultados.

    keyword:rankings_over_time
  • Distribuição de posições

    Como as palavras-chave monitoradas se distribuem pelas faixas de posição no fim do período analisado.

    keyword:position_distribution
  • Palavras-chave por dispositivo

    Como as palavras-chave monitoradas se dividem entre monitoramento em computador e em celular.

    keyword:keywords_by_device

Tabelas

8 métricas

  • Posicionamento das palavras-chave

    Posição de cada palavra-chave monitorada no fim do período analisado, com a variação acumulada no período e a página que está posicionada.

    keyword:keywords
  • Detalhes das palavras-chave

    Histórico de posicionamento e concorrência de cada palavra-chave monitorada.

    keyword:keywords_detailed
  • Desempenho das palavras-chave no Search Console

    Cliques, impressões e taxa de cliques de cada palavra-chave. Disponível apenas quando o Search Console está conectado dentro do Keyword.com.

    keyword:keywords_search_console
  • Posicionamento por tag

    Desempenho de cada grupo de palavras-chave marcado com tag dentro do Keyword.com.

    keyword:keywords_by_tag
  • Posicionamento por página

    Páginas do domínio monitorado que estão posicionadas para o maior número de palavras-chave durante o período analisado.

    keyword:keywords_by_landing_page
  • Posicionamento por ferramenta de busca

    Desempenho das palavras-chave monitoradas em cada domínio regional do Google acompanhado.

    keyword:keywords_by_search_engine
  • Posicionamento por intenção de busca

    Desempenho das palavras-chave monitoradas agrupadas pela intenção que o Keyword.com atribui a cada busca.

    keyword:keywords_by_intent
  • Participação de voz por domínio

    Domínios que disputam as palavras-chave monitoradas, ordenados pela fatia de cliques estimados que cada um leva.

    keyword:competitors

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.