Docs
Rechercher dans la documentation...⌘K

Pages payantes

API + MCP
GET/v3/site-explorer/paid-pages

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

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

selectstringObligatoire

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

protocolstring

Le protocole de votre cible.

Valeurs autorisées:bothhttphttps
Par défaut:both
targetstring (url)Obligatoire

La cible de la recherche : un domaine ou une URL.

modestring

La portée de la recherche en fonction de la cible que vous avez saisie.

Valeurs autorisées:exactprefixdomainsubdomains
Par défaut:subdomains
countrystring

Un code pays à deux lettres (ISO 3166-1 alpha-2).

Valeurs autorisées:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

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

datestring (date)Obligatoire

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

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

pagesarray<object>
ads_countinteger or null

Le nombre d'annonces uniques avec une page.

ads_count_diffinteger

La variation du nombre d'annonces entre vos dates sélectionnées.

ads_count_previnteger or null

Le nombre d’annonces à la date de comparaison.

keywordsinteger or null

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

keywords_diffinteger

Le changement de mots-clés entre vos dates sélectionnées.

keywords_diff_percentinteger

La variation des mots-clés entre vos dates sélectionnées, en pourcentage.

keywords_mergedinteger

Le nombre total de mots-clés optimisés pour le tri.

keywords_previnteger or null

Le mot-clé pour lequel votre cible se classe à la date de comparaison.

raw_urlstring

L’URL de la page classée au format encodé.

raw_url_prevstring or null

L’URL de la page classée à la date de comparaison, au format encodé.

referring_domainsinteger or null

(5 unités) Le nombre de domaines uniques pointant vers une page.

statusstring

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

Allowed values:leftrightboth
sum_trafficinteger or null

(10 units) Une estimation du trafic mensuel de recherche payante qu’une page obtient à partir de tous les mots-clés pour lesquels elle est classée.

sum_traffic_mergedinteger

(10 unités) Le champ du trafic payant optimisé pour le tri.

sum_traffic_previnteger or null

(10 unités) Le trafic payant à la date de comparaison.

top_keywordstring or null

Le mot-clé qui apporte le trafic le plus payé à une page.

top_keyword_best_positioninteger or null

La position de classement qu'une page occupe pour son mot-clé supérieur.

top_keyword_best_position_diffinteger or null

Le changement de la position la plus élevée entre les dates sélectionnées.

top_keyword_best_position_kindstring or null

Le type de la meilleure position : organique, payante ou une fonctionnalité SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
top_keyword_best_position_kind_prevstring or null

Le type de la meilleure position à la date de comparaison.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
top_keyword_best_position_previnteger or null

La meilleure position à la date de comparaison.

top_keyword_best_position_titlestring or null

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

top_keyword_best_position_title_prevstring or null

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

top_keyword_countrystring or null

Le pays dans lequel une page est classée pour son Mot-clé principal.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_country_prevstring or null

Le pays dans lequel une page est classée pour son Mot-clé principal à la date de comparaison.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
top_keyword_prevstring or null

Le mot-clé qui apporte le plus de trafic payant à une page à la date de comparaison.

top_keyword_volumeinteger or null

(10 units) Une estimation du nombre mensuel moyen de recherches pour le mot-clé principal sur le dernier mois ou sur les 12 derniers mois de données connus, selon le paramètre "volume_mode".

top_keyword_volume_previnteger or null

(10 unités) Le volume de recherche à la date de comparaison.

traffic_diffinteger

Le changement de trafic entre vos dates sélectionnées.

traffic_diff_percentinteger

La variation du trafic entre vos dates sélectionnées, en pourcentage.

urnumber (float) or null

La notation d'URL (UR) montre la force du profil de backlink de votre page cible sur une échelle logarithmique de 100 points.

urlstring (url) or null

L’URL de la page classée.

url_prevstring (url) or null

L’URL de la page classée à la date de comparaison.

valueinteger or null

(10 units) Le coût estimé du trafic mensuel de recherche payante d’une page, en cents USD.

value_diffinteger

La variation de la valeur du trafic entre les dates sélectionnées.

value_diff_percentinteger

La variation de la valeur de trafic entre les dates sélectionnées, en pourcentage.

value_mergedinteger or null

(10 units) Le champ valeur de trafic optimisé pour le tri.

value_previnteger or null

(10 units) La valeur de trafic à la date de comparaison.