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

ads_count: Le nombre de publicités uniques associées à une page.
type: integer

ads_count_diff: La variation du nombre de publicités entre vos dates sélectionnées.
type: integer

ads_count_prev: Le nombre de publicités à la date de comparaison.
type: integer

cpc
type: integer nullable

cpc_prev: La métrique CPC à la date de comparaison.
type: integer nullable

description: La description d’une annonce telle qu’elle apparaît dans les résultats de recherche.
type: string

description_prev: La description d’une annonce à la date de comparaison.
type: string

has_thumbnail: La position comporte une miniature.
type: boolean

has_thumbnail_prev: La position comportait une miniature à la date de comparaison.
type: boolean

has_video: La position comporte une vidéo.
type: boolean

has_video_prev: La position comportait une vidéo à la date de comparaison.
type: boolean

keyword: Le mot-clé pour lequel votre cible est classée.
type: string

keyword_difficulty (10 units): Une estimation de la Difficulté du mot-clé (difficulté de se classer dans le top 10 des résultats de recherche organiques pour un mot-clé), sur une échelle de 100 points.
type: integer nullable

keyword_difficulty_prev (10 units): La Difficulté du mot-clé à la date de comparaison.
type: integer nullable

keyword_prev: Le mot-clé pour lequel votre cible était classée à la date de comparaison.
type: string

keywords: Le nombre total de mots-clés pour lesquels votre cible est classée dans les résultats de recherche payants.
type: integer

keywords_diff: La variation du nombre de mots-clés entre vos dates sélectionnées.
type: integer

keywords_diff_percent: La variation du nombre de mots-clés entre vos dates sélectionnées, en pourcentage.
type: integer

keywords_merged: Le nombre total de mots-clés optimisé pour le tri.
type: integer

keywords_prev: Le mot-clé pour lequel votre cible était classée à la date de comparaison.
type: integer

position: La position de votre cible dans les résultats de recherche payants pour un mot-clé.
type: integer

position_kind: Le type d’une position : organique, payant ou une fonctionnalité SERP. Cela s’applique à toutes les positions pour un mot-clé et une URL donnés, avant de sélectionner la meilleure position.
type: 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"

position_kind_prev: Le type d’une position à la date de comparaison.
type: 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"

position_prev: La position de votre cible pour un mot-clé donné à la date de comparaison.
type: integer

raw_url: L’URL de la page classée au format encodé.
type: string

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

referring_domains (5 units): Le nombre de domaines uniques pointant vers une page.
type: integer nullable

serp_features
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_features_prev: Les Fonctionnalités SERP à la date de comparaison.
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"

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

sum_traffic (10 units): Une estimation du trafic mensuel issu de la recherche payante qu’une page reçoit depuis l’ensemble des mots-clés pour lesquels elle est classée.
type: integer nullable

sum_traffic_merged (10 units): Le champ de trafic payant optimisé pour le tri.
type: integer

sum_traffic_prev (10 units): Le trafic payant à la date de comparaison.
type: integer nullable

title: Le titre d’une annonce tel qu’il apparaît dans les résultats de recherche.
type: string

title_prev: Le titre d’une annonce à la date de comparaison.
type: string

top_keyword: Le Mot-clé principal qui génère le plus de trafic payant pour une page.
type: string nullable

top_keyword_best_position: La position de classement qu’une page occupe pour son Mot-clé principal.
type: integer nullable

top_keyword_best_position_diff: La variation de la meilleure position entre vos dates sélectionnées.
type: integer nullable

top_keyword_best_position_kind: Le type de la meilleure position : organique, payant, ou une fonctionnalité SERP.
type: string nullable
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"

top_keyword_best_position_kind_prev: Le type de la meilleure position à la date de comparaison.
type: string nullable
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"

top_keyword_best_position_prev: La meilleure position à la date de comparaison.
type: integer nullable

top_keyword_best_position_title: Le titre affiché pour la page dans la SERP de son Mot-clé principal.
type: string nullable

top_keyword_best_position_title_prev: Le titre affiché pour la page dans la SERP de son Mot-clé principal à la date de comparaison.
type: string nullable

top_keyword_country: Le pays dans lequel une page est classée pour son Mot-clé principal.
type: string nullable
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"

top_keyword_country_prev: Le pays dans lequel une page était classée pour son Mot-clé principal à la date de comparaison.
type: string nullable
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"

top_keyword_prev: Le Mot-clé principal qui générait le plus de trafic payant pour une page à la date de comparaison.
type: string nullable

top_keyword_volume (10 units): Une estimation du Volume de recherche mensuel moyen pour le Mot-clé principal sur le dernier mois, ou sur les 12 derniers mois de données connues selon le paramètre "volume_mode".
type: integer nullable

top_keyword_volume_prev (10 units): Le Volume de recherche à la date de comparaison.
type: integer nullable

traffic (10 units): Une estimation du nombre de visiteurs mensuels que votre cible reçoit depuis la recherche payante pour un mot-clé.
type: integer

traffic_diff: La variation de trafic entre vos dates sélectionnées.
type: integer

traffic_diff_percent: La variation de trafic entre vos dates sélectionnées, en pourcentage.
type: integer

traffic_prev (10 units): Le trafic provenant d’un mot-clé à la date de comparaison.
type: integer

ur: URL Rating (UR) indique la puissance du profil de Backlinks de votre page cible sur une échelle logarithmique de 100 points.
type: float nullable

url: L’URL de la page classée.
type: url nullable

url_prev: L’URL de la page classée à la date de comparaison.
type: url nullable

url_visual: L’URL d’une annonce telle qu’elle apparaît dans les résultats de recherche.
type: string

url_visual_prev: L’URL d’une annonce à la date de comparaison.
type: string

value (10 units): Le coût estimé du trafic mensuel d’une page depuis la recherche payante, en cents USD.
type: integer nullable

value_diff: La variation de la Valeur de trafic entre vos dates sélectionnées.
type: integer

value_diff_percent: La variation de la Valeur de trafic entre vos dates sélectionnées, en pourcentage.
type: integer

value_merged (10 units): Le champ Valeur de trafic optimisé pour le tri.
type: integer nullable

value_prev (10 units): La Valeur de trafic à la date de comparaison.
type: integer nullable

volume (10 units): Une estimation du Volume de recherche (nombre de recherches) pour un mot-clé sur le dernier mois.
type: integer nullable

volume_prev (10 units): Le Volume de recherche à la date de comparaison.
type: integer nullable

words: Le nombre de mots dans un mot-clé.
type: integer

words_prev: Le nombre de mots dans un mot-clé à la date de comparaison.
type: integer

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.

protocolstring

Le protocole de votre cible.

Valeurs autorisées:bothhttphttps

Par défaut:both

targetstringObligatoire

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

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.

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.

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.

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 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 or null

L’URL de la page classée.

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