Páginas dos concorrentes

API + MCP

GET/v3/rank-tracker/competitors-pages

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

Parâmetros de consulta

selectstringObrigatório

Uma lista de colunas separadas por vírgulas a serem retornadas. Consulte o Schema de resposta para ver identificadores de coluna válidos.

wherestring

A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).

order_bystring

Uma lista de colunas separadas por vírgula para ordenar os resultados, com direção opcional. Consulte o schema de resposta para ver identificadores de coluna válidos.

Example:field_a,field_b:asc,field_c:desc

limitinteger

O número de resultados a retornar.

Padrão:1000

timeoutinteger

Um tempo limite manual em segundos.

volume_modestring

O modo de cálculo do volume de pesquisa: mensal ou médio. Ele afeta o volume, o tráfego e o valor do tráfego.

Valores permitidos:monthlyaverage

Padrão:monthly

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#

devicestringObrigatório

Escolha entre rankings para dispositivos móveis e desktop.

Valores permitidos:desktopmobile

datestring (date)Obrigatório

Uma data para a qual as métricas serão relatadas, no formato AAAA-MM-DD.

date_comparedstring (date)

Uma data para comparar as métricas, no formato YYYY-MM-DD.

target_and_tracked_competitors_onlyboolean

Restringir páginas aos concorrentes-alvo e monitorados

Padrão:false

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Respostas

competitors-pagesarray<object>

keywordsinteger

O número total de palavras-chave para as quais seu alvo ranqueia entre os 100 melhores resultados de busca orgânica.

share_of_traffic_valuenumber (float)

A proporção do valor do tráfego de busca orgânica do seu alvo em comparação com o valor total do tráfego de busca orgânica para todas as palavras-chave rastreadas.

share_of_traffic_value_prevnumber (float)

A participação do valor do tráfego na data de comparação.

share_of_voicenumber (float)

A proporção do tráfego de busca orgânica do seu alvo em comparação com o tráfego de busca orgânica total para todas as palavras-chave rastreadas.

share_of_voice_prevnumber (float)

A participação de voz na data de comparação.

statusstring

O status de uma página: a nova página que começou a ranquear recentemente ("left"), a página perdida que desapareceu dos resultados de pesquisa ("right") ou sem alterações ("both").

Valores permitidos:leftrightboth

titlestring or null

O título exibido para a página na SERP da sua Principal palavra-chave.

title_prevstring or null

O título na data de comparação.

trafficinteger

Uma estimativa do número de visitas mensais que uma página recebe de buscas orgânicas.

traffic_previnteger

O tráfego na data de comparação.

traffic_valueinteger or null

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

traffic_value_previnteger or null

O valor do tráfego na data de comparação.

urlstring (url)

A URL da página.