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á haciendo seguimiento de una palabra clave determinada. 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 está haciendo seguimiento de una palabra clave determinada 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

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

keyword_prev: La palabra clave para la que se posiciona tu objetivo en la fecha de comparación.
type: string

language: El idioma de la SERP para el que se está haciendo seguimiento de una palabra clave determinada.
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á haciendo seguimiento de una palabra clave determinada.
type: string

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

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

tags_prev: Una lista de etiquetas asignadas a una palabra clave determinada 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 deben devolver. Consulta el schema de respuesta para ver los 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 (date)

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

datestring (date)Obligatorio

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

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 (url)

La URL de la página.