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

timeoutinteger

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

limitinteger

El número de resultados que se devolverán.

Opción predeterminada:1000
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
wherestring

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

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.

date_comparedstring (date)

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

datestring (date)Obligatorio

Fecha para la que se informarán las métricas, en formato AAAA-MM-DD.

devicestringObligatorio

Elige entre rankings de móvil y escritorio.

Valores permitidos:desktopmobile
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#

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
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).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
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.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
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".