Docs
Buscar documentación...⌘K

Páginas de la competencia

API + MCP
GET/v3/rank-tracker/competitors-pages

Las solicitudes a este endpoint son gratuitas y no consumen ninguna unidad de API.

Parámetros de consulta

selectstringObligatorio

Una lista de columnas separadas por comas que se deben devolver. Consulta el schema de respuesta para ver los identificadores de columna válidos.

wherestring

La expresión del filtro. Se reconocen los siguientes identificadores de columna (esto difiere de los identificadores que reconoce el parámetro select).

order_bystring

Una lista separada por comas de columnas para ordenar los resultados, con dirección opcional. Consulta el schema de respuesta para ver los identificadores de columna válidos.

Example:field_a,field_b:asc,field_c:desc
limitinteger

El número de resultados que se van a devolver.

Opción predeterminada:1000
timeoutinteger

Una duración de tiempo de espera manual en segundos.

volume_modestring

El modo de cálculo del volumen de búsqueda: mensual o promedio. Afecta al volumen, al tráfico y al valor del tráfico.

Valores permitidos:monthlyaverage
Opción predeterminada:monthly
project_idintegerObligatorio

El identificador único del proyecto. Puedes encontrarlo en la URL de tu proyecto de Rank Tracker en Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

devicestringObligatorio

Elige entre rankings de móvil y escritorio.

Valores permitidos:desktopmobile
datestring (date)Obligatorio

Fecha para la que se informan las métricas en formato AAAA-MM-DD.

date_comparedstring (date)

Una fecha en formato AAAA-MM-DD con la que comparar las métricas.

target_and_tracked_competitors_onlyboolean

Restringir páginas al objetivo y a los competidores rastreados

Opción predeterminada:false
outputstring

El formato de salida.

Valores permitidos:jsoncsvxmlphp

Respuestas

competitors-pagesarray<object>
keywordsinteger

El número total de palabras clave para las que tu objetivo se sitúa en los 100 primeros resultados de búsqueda orgánica.

share_of_traffic_valuenumber (float)

La cuota del valor del tráfico orgánico de búsqueda de tu objetivo en comparación con el valor total del tráfico orgánico de búsqueda para todas las palabras clave rastreadas.

share_of_traffic_value_prevnumber (float)

La cuota del valor del tráfico en la fecha de comparación.

share_of_voicenumber (float)

La proporción del tráfico orgánico de búsqueda de tu objetivo en comparación con el tráfico total de búsqueda orgánica para todas las palabras clave rastreadas.

share_of_voice_prevnumber (float)

La cuota de voz en la fecha de comparación.

statusstring

El estado de una página: la página nueva que acaba de empezar a posicionarse ("left"), la página perdida que desapareció de los resultados de búsqueda ("right"), o sin cambios ("both").

Valores permitidos:leftrightboth
titlestring or null

El título que se muestra para la página en la SERP de su palabra clave principal.

title_prevstring or null

El título en la fecha de comparación.

trafficinteger

Estimación del número de visitas mensuales que obtiene una página a partir de búsquedas orgánicas.

traffic_previnteger

El tráfico en la fecha de comparación.

traffic_valueinteger or null

El valor estimado del tráfico de búsqueda orgánica mensual de una página, en centavos de USD.

traffic_value_previnteger or null

El valor del tráfico en la fecha de comparación.

urlstring (url)

La URL de la página.