Pages des concurrents

API + MCP

GET/v3/rank-tracker/competitors-pages

Les requêtes vers ce point de terminaison sont gratuites et ne consomment aucune unité d’API.

Paramètres de requête

timeoutinteger

Durée de délai d’attente manuelle, en secondes.

limitinteger

Nombre de résultats à renvoyer.

Par défaut:1000

order_bystring

Une liste de colonnes séparées par des virgules pour trier les résultats, avec un sens de tri facultatif. Consultez le schéma de réponse pour connaître les identifiants de colonne valides.

Example:field_a,field_b:asc,field_c:desc

wherestring

Expression de filtre. Les identifiants de colonnes suivants sont reconnus (ceux-ci diffèrent des identifiants reconnus par le paramètre select).

country: Le pays dans lequel un mot-clé est suivi. Code pays à deux lettres (ISO 3166-1 alpha-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: Le pays dans lequel un mot-clé était suivi à la date de comparaison. Code pays à deux lettres (ISO 3166-1 alpha-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: Domaine de la page.
type: string

language: Langue de la SERP pour laquelle un mot-clé est suivi.
type: string

language_prev: Langue de la SERP à la date de comparaison.
type: string

location: Localisation (pays, État/province ou ville) dans laquelle un mot-clé est suivi.
type: string

location_prev: Localisation (pays, État/province ou ville) dans laquelle un mot-clé était suivi à la date de comparaison.
type: string

tags: Liste des tags attribués à un mot-clé.
type: array(string)

tags_prev: Liste des tags attribués à un mot-clé à la date de comparaison.
type: array(string)

url: URL de la page.
type: string

selectstringObligatoire

Une liste de colonnes, séparées par des virgules, à renvoyer. Voir le Schéma de réponse pour les identifiants de colonne valides.

target_and_tracked_competitors_onlyboolean

Restreindre les pages à la cible et aux concurrents suivis

Par défaut:false

date_comparedstring

Une date avec laquelle comparer les métriques, au format YYYY-MM-DD.

datestringObligatoire

Une date pour laquelle établir un rapport sur les métriques, au format AAAA-MM-JJ.

devicestringObligatoire

Choisissez entre les classements mobile et desktop.

Valeurs autorisées:desktopmobile

project_idintegerObligatoire

L’identifiant unique du projet. Vous pouvez le trouver dans l’URL de votre projet Rank Tracker dans Ahrefs : https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

Mode de calcul du volume de recherche : mensuel ou moyen. Cela affecte le volume, le trafic et la valeur de trafic.

Valeurs autorisées:monthlyaverage

Par défaut:monthly

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

competitors-pagesarray<object>

keywordsinteger

Le nombre total de mots-clés pour lesquels votre cible se classe dans les 100 premiers résultats de recherche organique.

share_of_traffic_valuenumber

La part de la valeur du trafic de recherche organique de votre cible par rapport à la valeur totale du trafic de recherche organique pour tous les mots-clés suivis.

share_of_traffic_value_prevnumber

La part de valeur de trafic à la date de comparaison.

share_of_voicenumber

La part du trafic de recherche organique de votre cible par rapport au trafic de recherche organique total pour tous les mots-clés suivis.

share_of_voice_prevnumber

La part de voix à la date de comparaison.

statusstring

Le statut d’une page : la nouvelle page qui vient de commencer à se classer ("left"), la page perdue qui a disparu des résultats de recherche ("right"), ou aucun changement ("both").

Allowed values:leftrightboth

titlestring or null

Le titre affiché pour la page dans la SERP de son Mot-clé principal.

title_prevstring or null

Le titre à la date de comparaison.

trafficinteger

Une estimation du nombre de visites mensuelles qu'une page reçoit grâce à la recherche organique.

traffic_previnteger

Le trafic à la date de comparaison.

traffic_valueinteger or null

La valeur estimée du trafic de recherche organique mensuel d’une page, en cents de dollar américain (USD).

traffic_value_previnteger or null

La valeur de trafic à la date de comparaison.

urlstring

L’URL de la page.