Docs
Buscar documentación...⌘K

Competencia: Vista general

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

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.

outputstring

El formato de salida.

Valores permitidos:jsonphp

Respuestas

keywordsarray<object>
competitors_listarray<object>

Información de competidores para una palabra clave. Se incluyen los siguientes campos: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. Los campos que terminan en prev solo se incluyen en la vista comparada.

countrystring

El país en el que se realiza el seguimiento de una palabra clave determinada. Código de país de dos letras (ISO 3166-1 alfa-2).

Valores permitidos:ADAEAFAGAIALAMAOAQARASATAUAWAX…
keywordstring

La palabra clave por la que tu objetivo está posicionado.

keyword_difficultyinteger or null

Una estimación de la dificultad de posicionarse en los 10 primeros resultados de búsqueda orgánica para una palabra clave determinada, en una escala de 100 puntos.

keyword_has_databoolean

Devolverá false si la palabra clave aún se está procesando y todavía no se ha obtenido ninguna SERP.

keyword_is_frozenboolean

Indica si una palabra clave ha superado el límite de palabras clave en seguimiento de tu plan. Estas palabras clave quedan "congeladas", lo que significa que no se actualizan sus posiciones.

languagestring

El idioma de la SERP para el que se realiza el seguimiento de una palabra clave determinada.

locationstring

La ubicación (país, estado/provincia o ciudad) en la que se realiza el seguimiento de una palabra clave determinada.

serp_featuresarray<string>

Las funcionalidades de SERP que aparecen en los resultados de búsqueda para una palabra clave.

Valores permitidos:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
serp_updatedstring (date-time) or null

La fecha en la que comprobamos por última vez los resultados de búsqueda para una palabra clave.

serp_updated_prevstring (date-time) or null

La fecha en la que comprobamos los resultados de búsqueda hasta la fecha de comparación.

tagsarray<string>

Una lista de etiquetas asignadas a una palabra clave determinada.

volumeinteger or null

Una estimación del número medio mensual de búsquedas de una palabra clave durante el último mes o durante los últimos 12 meses de datos disponibles, según el parámetro "volume_mode".