Docs
Rechercher dans la documentation...⌘K

Aperçu

API + MCP
GET/v3/keywords-explorer/overview

Le filtre regex a des fonctionnalités limitées lorsqu’il est utilisé dans cette requête, et sa syntaxe diffère de celle des autres requêtes. Il attend le symbole astérisque (*) comme caractère générique.

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

La colonne selon laquelle trier les résultats. Consultez le Schéma de réponse pour connaître les identifiants de colonnes valides, à l’exception de volume_monthly, qui n’est pas pris en charge dans order_by pour ce point de terminaison.

Example:field_a,field_b:asc,field_c:desc
wherestring

Expression de filtrage. Les identifiants de colonnes suivants sont reconnus (ils 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.

volume_monthly_date_tostring (date)

La date de fin au format YYYY-MM-DD pour récupérer les volumes de recherche mensuels historiques dans le champ volume_monthly_history. Requise uniquement si volume_monthly_history est demandé.

volume_monthly_date_fromstring (date)

La date de début au format YYYY-MM-DD pour récupérer les volumes de recherche mensuels historiques dans le champ volume_monthly_history. Requise uniquement si volume_monthly_history est demandé.

target_modestring

La portée de l’URL cible que vous avez spécifiée.

Valeurs autorisées:exactprefixdomainsubdomains
targetstring (url)

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

target_positionstring

Filtre les mots-clés en fonction de la position de classement de la target spécifiée.

Valeurs autorisées:in_top10in_top100
countrystringObligatoire

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

Valeurs autorisées:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
keywordsstring

Une liste de mots-clés séparés par des virgules pour afficher les métriques correspondantes.

keyword_list_idinteger

L’identifiant d’une liste de mots-clés existante pour laquelle afficher les métriques.

outputstring

Le format de sortie.

Valeurs autorisées:jsonphpxml

Réponses

keywordsarray<object>
clicksinteger or null

Le nombre mensuel moyen de Clics sur les résultats de recherche que les internautes effectuent lorsqu’ils recherchent le mot-clé cible.

cpcinteger or null

Le Coût par clic indique le prix moyen que les annonceurs paient pour chaque clic sur une annonce dans les résultats de recherche payants pour un mot-clé, en cents USD.

cpsnumber (float) or null

Les Clics par recherche (ou CPS) correspondent au rapport entre les Clics et le Volume de recherche par mot-clé. Ils indiquent le nombre de résultats de recherche différents sur lesquels les internautes cliquent, en moyenne, lorsque des personnes recherchent le mot-clé cible dans un pays donné.

difficultyinteger or null

(10 unités) Estimation de la difficulté à se classer dans les 10 premiers résultats de recherche organiques pour un mot-clé, sur une échelle de 100 points.

first_seenstring (date-time) or null

Date de la première vérification des résultats des moteurs de recherche pour un mot-clé.

global_volumeinteger or null

(10 unités) Combien de fois par mois, en moyenne, les internautes recherchent le mot-clé cible dans tous les pays de notre base de données.

intentsobject or null

(10 unités) Indique l’intention derrière la requête de recherche de l’utilisateur. Champs de l’objet : informational, navigational, commercial, transactional, branded ou local. Tous les champs sont de type bool, avec pour valeurs possibles true ou false.

keywordstring
parent_topicstring or null

Le Sujet parent détermine si vous pouvez vous classer pour votre mot-clé cible tout en ciblant un sujet plus général sur votre page. Pour identifier le Sujet parent, nous prenons la page classée n°1 pour votre mot-clé et trouvons le mot-clé responsable d'envoyer le plus de trafic vers cette page.

parent_volumeinteger or null

(10 unités) Le Volume de recherche du Sujet parent.

searches_pct_clicks_organic_and_paidnumber (float) or null

Le pourcentage mensuel moyen de personnes ayant cliqué à la fois sur des résultats organiques et payants lors d’une recherche du mot-clé cible.

searches_pct_clicks_organic_onlynumber (float) or null

Le pourcentage mensuel moyen de personnes ayant cliqué uniquement sur des résultats organiques lors d’une recherche du mot-clé cible.

searches_pct_clicks_paid_onlynumber (float) or null

Le pourcentage mensuel moyen de personnes ayant cliqué uniquement sur des résultats payants lors d’une recherche du mot-clé cible.

serp_featuresarray<string>

Les résultats enrichis sur une page de résultats de moteur de recherche (SERP) qui ne sont pas des résultats organiques traditionnels.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping
serp_last_updatestring (date-time) or null

Date de la dernière vérification des résultats des moteurs de recherche pour un mot-clé.

traffic_potentialinteger or null

(10 unités) La somme du trafic organique que la page classée n°1 pour votre mot-clé cible reçoit de tous les mots-clés pour lesquels elle est classée.

volumeinteger or null

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

volume_desktop_pctnumber (float) or null

Le pourcentage de recherches pour un mot-clé effectuées sur des appareils de bureau.

volume_mobile_pctnumber (float) or null

Le pourcentage de recherches pour un mot-clé effectuées sur des appareils mobiles.

volume_monthlyinteger or null

(10 unités) Une estimation du nombre de recherches pour un mot-clé au cours du dernier mois. Ce champ peut ne pas être inclus dans le paramètre order_by

volume_monthly_historyarray<object>

(2 unités par mois historique, avec un minimum de 50 unités) Estimations historiques mensuelles du Volume de recherche d’un mot-clé pour la période définie par les paramètres volume_monthly_date_from et volume_monthly_date_to.