Aperçu SERP

API + MCP

GET/v3/serp-overview/serp-overview

Paramètres de requête

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.

top_positionsinteger

Nombre de positions SERP organiques les mieux classées à renvoyer. S’il n’est pas spécifié, toutes les positions disponibles seront renvoyées.

datestring

Horodatage auquel le dernier Aperçu SERP disponible est renvoyé, au format YYYY-MM-DDThh:mm:ss. S’il n’est pas spécifié, l’Aperçu SERP le plus récent est renvoyé.

countrystringObligatoire

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

Valeurs autorisées:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordstringObligatoire

Le mot-clé pour lequel renvoyer l’Aperçu SERP.

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

positionsarray<object>

ahrefs_rankinteger or null

La force du profil de backlinks d'un domaine par rapport aux autres sites Web de notre base de données, le rang n°1 étant le plus fort.

backlinksinteger or null

Le nombre total de liens provenant d'autres sites Web pointant vers un résultat de recherche.

domain_ratingnumber or null

La force du profil de backlinks d'un domaine par rapport aux autres dans notre base de données, sur une échelle de 100 points.

keywordsinteger or null

Le nombre total de mots-clés pour lesquels un résultat de recherche se classe dans les 100 premières positions organiques.

page_typestring or null

Liste séparée par des virgules de chemins hiérarchiques de types de pages prédits par l’IA pour la page classée. Chaque valeur est un chemin préfixé par une barre oblique (p. ex. /Article/How_to).

positioninteger

La position du résultat de recherche dans la SERP.

refdomainsinteger or null

(5 unités) Le nombre total de domaines uniques pointant vers un résultat de recherche.

titlestring or null

Le titre d’une page classée.

top_keywordstring or null

Le mot-clé qui génère le plus de trafic organique vers un résultat de recherche.

top_keyword_volumeinteger or null

(10 unités) Une estimation du nombre mensuel moyen de recherches pour le mot-clé principal sur la base des données des 12 derniers mois connus.

trafficinteger or null

(10 unités) Une estimation du trafic de recherche organique mensuel qu’un résultat obtient à partir de tous les mots-clés pour lesquels il est classé.

typearray<string>

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

update_datestring

La date à laquelle nous avons vérifié les résultats des moteurs de recherche pour un mot-clé.

urlstring or null

L’URL d’une page classée.

url_ratingnumber or null

La force du profil de backlinks d'une page sur une échelle logarithmique de 100 points.

valueinteger or null

(10 unités) La valeur estimée du trafic de recherche organique mensuel d’une page, en cents USD.