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

country: El país en el que se está rastreando una palabra clave. Un código de país de dos letras (ISO 3166-1 alfa-2).
type: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

is_main_position: Excluye posiciones en AI Overview, Sitelinks, Top stories, Image packs, Videos, Discussions and forums, y publicaciones en X (Twitter).
type: boolean

is_main_position_prev: Excluye posiciones en AI Overview, Sitelinks, Top stories, Image packs, Videos, Discussions and forums, y publicaciones en X (Twitter) en la fecha de comparación.
type: boolean

keyword: La palabra clave por la que se posiciona tu objetivo.
type: string

keyword_difficulty: Una estimación de lo difícil que es posicionarse en los 10 primeros resultados orgánicos de búsqueda para una palabra clave en una escala de 100 puntos.
type: integer nullable

keyword_has_data: Devuelve false si la palabra clave aún se está procesando y todavía no se ha obtenido ninguna SERP.
type: boolean

keyword_is_frozen: Indica si una palabra clave ha superado el límite de palabras clave rastreadas de tu plan. Esas palabras clave quedan "congeladas", lo que significa que no se actualizan sus posiciones.
type: boolean

language: El idioma de la SERP para el que se está rastreando una palabra clave.
type: string

location: La ubicación (país, estado/provincia o ciudad) en la que se está rastreando una palabra clave.
type: string

serp_features: Las Funcionalidades SERP que aparecen en los resultados de búsqueda de una palabra clave.
type: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_updated: La fecha en la que comprobamos por última vez los resultados del motor de búsqueda para una palabra clave.
type: datetime nullable

serp_updated_prev: La fecha en la que comprobamos los resultados del motor de búsqueda hasta la fecha de comparación.
type: datetime nullable

tags: Una lista de etiquetas asignadas a una palabra clave.
type: array(string)

volume: 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 conocidos de datos, según el parámetro "volume_mode".
type: integer nullable

selectstringObligatorio

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

date_comparedstring

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

datestringObligatorio

Una fecha para informar sobre 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 or null

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

serp_updated_prevstring 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".