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

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"

country_prev: El país en el que se estaba rastreando una palabra clave en la fecha de comparación. 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"

domain: El dominio de la página.
type: string

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

language_prev: El idioma de la SERP en la fecha de comparación.
type: string

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

location_prev: La ubicación (país, estado/provincia o ciudad) en la que se estaba rastreando una palabra clave en la fecha de comparación.
type: string

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

tags_prev: Una lista de etiquetas asignadas a una palabra clave en la fecha de comparación.
type: array(string)

url: La URL de la página.
type: string

selectstringObligatorio

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

target_and_tracked_competitors_onlyboolean

Restringe las páginas al objetivo y a los competidores rastreados

Opción predeterminada:false

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: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

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

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

share_of_voicenumber

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

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

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

La URL de la página.