Docs
Pesquisar na documentação...⌘K

Visão geral da SERP

API + MCP
GET/v3/rank-tracker/serp-overview

As solicitações para este endpoint são gratuitas e não consomem unidades da API.

Parâmetros de consulta

top_positionsinteger

O número de principais posições orgânicas na SERP a retornar. Se não for especificado, todas as posições disponíveis serão retornadas.

devicestringObrigatório

Escolha entre rankings para dispositivos móveis e desktop.

Valores permitidos:desktopmobile
datestring

Um carimbo de data/hora em que a última Visão geral da SERP disponível é retornada no formato YYYY-MM-DDThh:mm:ss. Se não for especificado, a Visão geral da SERP mais recente será retornada.

location_idinteger

O ID de localização de uma palavra-chave monitorada. Você pode usar o endpoint management/project-keywords para obter códigos de país, códigos de idioma e IDs de localização das suas palavras-chave monitoradas.

countrystringObrigatório

Um código de país com duas letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
language_codestring

O código de idioma de uma palavra-chave monitorada. Você pode usar o endpoint management/project-keywords para obter códigos de país, códigos de idioma e IDs de localização das suas palavras-chave monitoradas.

keywordstringObrigatório

A palavra-chave para a qual retornar a Visão geral da SERP.

project_idintegerObrigatório

O identificador exclusivo do projeto. Você pode encontrá-lo na URL do seu projeto do Rank Tracker no Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

positionsarray<object>
ahrefs_rankinteger or null

A força do perfil de backlinks de um domínio em comparação com os outros sites no nosso banco de dados, em que a classificação #1 é a mais forte.

backlinksinteger or null

O número total de links de outros sites que direcionam para um resultado de pesquisa.

domain_ratingnumber or null

A força do perfil de backlinks de um domínio em comparação com os demais no nosso banco de dados, em uma escala de 100 pontos.

keywordsinteger or null

O número de palavras-chave que ranqueiam entre as 100 melhores posições orgânicas para um resultado de pesquisa.

nr_wordsinteger or null

O número total de palavras existentes no HTML de uma página web.

page_typestring or null

Lista separada por vírgulas de caminhos hierárquicos de tipos de página previstos por IA para a página ranqueada. Cada valor é um caminho com barra inicial (ex.: /Article/How_to).

positioninteger

A posição do resultado de pesquisa na SERP.

refdomainsinteger or null

O número total de domínios exclusivos vinculados a um resultado de pesquisa.

titlestring or null

O título de uma página classificada.

top_keywordstring or null

A palavra-chave que gera mais tráfego orgânico para um resultado de pesquisa.

top_keyword_volumeinteger or null

Uma estimativa do número médio de pesquisas mensais para a melhor palavra-chave ao longo dos últimos 12 meses de dados.

trafficinteger or null

Uma estimativa do tráfego de pesquisa orgânica mensal que um resultado recebe de todas as palavras-chave para as quais ele ranqueia.

typearray<string>

O tipo da posição: orgânica, paga ou um recurso da SERP. Valores permitidos: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring

A data em que verificamos os resultados do mecanismo de pesquisa para uma palavra-chave.

urlstring or null

A URL de uma página classificada.

url_ratingnumber or null

A força do perfil de backlinks de uma página em uma escala logarítmica de 100 pontos.

valueinteger or null

O valor estimado do tráfego orgânico de pesquisa mensal de uma página, em centavos de dólar (USD).