Aperçu
API + MCPLe 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
Durée de délai d’attente manuelle, en secondes.
Nombre de résultats à renvoyer.
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.
L’expression de filtre. Les identifiants de colonnes suivants sont reconnus (ceux-ci diffèrent des identifiants reconnus par le paramètre select).
clicks: Le nombre mensuel moyen de Clics sur les résultats de recherche que les internautes effectuent lorsqu’ils recherchent le mot-clé cible.
type: integer nullable
cpc: Le Coût par clic indique le prix moyen payé par les annonceurs pour chaque clic sur une annonce dans les résultats de recherche payants pour un mot-clé, en cents USD.
type: integer nullable
cps: Les Clics par recherche (ou CPS) correspondent au rapport entre les Clics et le Volume de recherche du mot-clé. Il indique le nombre de résultats de recherche différents sur lesquels les internautes cliquent, en moyenne, lorsqu’ils recherchent le mot-clé cible dans un pays donné.
type: float nullable
difficulty (10 units): Estimation de la difficulté à 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
first_seen: La date à laquelle nous avons vérifié pour la première fois les résultats des moteurs de recherche pour un mot-clé.
type: datetime nullable
global_volume (10 units): Le nombre moyen de recherches mensuelles du mot-clé cible, tous pays confondus dans notre base de données.
type: integer nullable
intents (10 units): Indique l’objectif derrière la requête de l’utilisateur. Champs de l’objet : informational, navigational, commercial, transactional, branded ou local. Tous les champs sont de type bool, avec comme valeurs possibles true ou false.
type: object nullable
keyword:
type: string
parent_topic: Le Sujet parent détermine si vous pouvez vous positionner sur votre mot-clé cible tout en ciblant, à la place, 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 recherchons le mot-clé qui génère le plus de trafic vers cette page.
type: string nullable
parent_volume (10 units): Le volume de recherche du sujet parent.
type: integer nullable
serp_domain_rating_top10_min: Le mot-clé doit avoir au moins une position dans le top 10 des résultats avec un DR allant jusqu’à cette valeur.
type: float nullable
serp_domain_rating_top5_min: Le mot-clé doit avoir au moins une position dans le top 5 des résultats avec un DR allant jusqu’à cette valeur.
type: float nullable
serp_features: Les résultats enrichis sur une page de résultats de moteur de recherche (SERP) qui ne sont pas des résultats organiques traditionnels.
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"
serp_last_update: La date à laquelle nous avons vérifié pour la dernière fois les résultats des moteurs de recherche pour un mot-clé.
type: datetime nullable
traffic_potential (10 units): La somme du Trafic organique que la page classée n° 1 pour votre mot-clé cible reçoit de l’ensemble des mots-clés sur lesquels elle se positionne.
type: integer nullable
volume (10 units): Estimation du nombre moyen de recherches mensuelles pour un mot-clé sur les 12 derniers mois de données connus.
type: integer nullable
volume_desktop_pct: Le pourcentage de recherches d’un mot-clé effectuées sur des appareils de bureau.
type: float nullable
volume_mobile_pct: Le pourcentage de recherches d’un mot-clé effectuées sur des appareils mobiles.
type: float nullable
word_count:
type: integer
Une liste de colonnes, séparées par des virgules, à renvoyer. Voir le Schéma de réponse pour les identifiants de colonne valides.
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é.
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é.
La portée de l’URL cible que vous avez spécifiée.
La cible de la recherche : un domaine ou une URL.
Filtre les mots-clés en fonction de la position de classement de la target spécifiée.
Un code pays à deux lettres (ISO 3166-1 alpha-2).
[Obsolète depuis le 5 août 2024].
Une liste de mots-clés séparés par des virgules pour lesquels afficher des métriques.
L’identifiant d’une liste de mots-clés existante pour laquelle afficher des métriques.
Le format de sortie.
Réponses
Le nombre mensuel moyen de Clics sur les résultats de recherche que les internautes effectuent lorsqu’ils recherchent le mot-clé cible.
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.
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é.
(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.
Date de la première vérification des résultats des moteurs de recherche pour un mot-clé.
(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.
(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.
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.
(10 unités) Le Volume de recherche du Sujet parent.
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.
Le pourcentage mensuel moyen de personnes ayant cliqué uniquement sur des résultats organiques lors d’une recherche du mot-clé cible.
Le pourcentage mensuel moyen de personnes ayant cliqué uniquement sur des résultats payants lors d’une recherche du mot-clé cible.
Les résultats enrichis sur une page de résultats de moteur de recherche (SERP) qui ne sont pas des résultats organiques traditionnels.
Date de la dernière vérification des résultats des moteurs de recherche pour un mot-clé.
(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.
(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.
Le pourcentage de recherches pour un mot-clé effectuées sur des appareils de bureau.
Le pourcentage de recherches pour un mot-clé effectuées sur des appareils mobiles.
(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
(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.