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

project_idintegerObrigatório

O identificador único 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#

keywordstringObrigatório

The keyword to return SERP Overview for.

language_codestring

The language code of a tracked keyword.You can use the management/project-keywords endpoint to get country codes, language codes and location IDs for your tracked keywords.

countrystringObrigatório

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

Valores permitidos:adaeafagaialamaoarasatauawazba…

location_idinteger

The location ID of a tracked keyword.You can use the management/project-keywords endpoint to get country codes, language codes and location IDs for your tracked keywords.

datestring (date-time)

A timestamp on which the last available SERP Overview is returned in YYYY-MM-DDThh:mm:ss format. If it is not specified, the most recent SERP Overview is returned.

devicestringObrigatório

Escolha entre rankings para dispositivos móveis e desktop.

Valores permitidos:desktopmobile

top_positionsinteger

The number of top organic SERP positions to return. If not specified, all available positions will be returned.

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 (float) 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 (date)

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

urlstring (url) or null

A URL de uma página classificada.

url_ratingnumber (float) 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).