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"
]
}
]
}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_keywordsPalavras-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_keywordsPalavras-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_keywordsPosiçã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_positionPalavras-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_3Palavras-chave no top 10
Número de palavras-chave na primeira página do Google no fim do período analisado.
keyword:top_10Palavras-chave no top 20
Número de palavras-chave entre os vinte primeiros resultados do Google no fim do período analisado.
keyword:top_20Palavras-chave no top 50
Número de palavras-chave entre os cinquenta primeiros resultados do Google no fim do período analisado.
keyword:top_50Palavras-chave no top 100
Número de palavras-chave entre os cem primeiros resultados do Google no fim do período analisado.
keyword:top_100Participaçã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_rateParticipaçã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_rateParticipação posicionada
Percentual das palavras-chave monitoradas encontradas entre os 100 primeiros resultados do Google no fim do período analisado.
keyword:top_100_ratePalavras-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_keywordsPalavras-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_keywordsPalavras-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_keywordsVariaçã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_changeVolume de busca total
Soma do volume de busca mensal de todas as palavras-chave monitoradas.
keyword:total_search_volumeVolume de busca médio
Volume de busca mensal médio das palavras-chave monitoradas.
keyword:average_search_volumeCPC médio
Custo por clique médio que o Google Ads informa para as palavras-chave monitoradas.
keyword:average_cpcTrechos em destaque
Número de palavras-chave em que o domínio monitorado ocupa o trecho em destaque do Google.
keyword:featured_snippetsPalavras-chave no pacote local
Número de palavras-chave em que o domínio monitorado aparece nos resultados locais do Google.
keyword:local_packParticipaçã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_timeEvoluçã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_timeDistribuição de posições
Como as palavras-chave monitoradas se distribuem pelas faixas de posição no fim do período analisado.
keyword:position_distributionPalavras-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:keywordsDetalhes das palavras-chave
Histórico de posicionamento e concorrência de cada palavra-chave monitorada.
keyword:keywords_detailedDesempenho 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_consolePosicionamento por tag
Desempenho de cada grupo de palavras-chave marcado com tag dentro do Keyword.com.
keyword:keywords_by_tagPosicionamento 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_pagePosicionamento por ferramenta de busca
Desempenho das palavras-chave monitoradas em cada domínio regional do Google acompanhado.
keyword:keywords_by_search_enginePosicionamento 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_intentParticipaçã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.
