Docs
Rechercher dans la documentation...⌘K

Suggestions de recherche

API + MCP
GET/v3/keywords-explorer/search-suggestions

Paramètres de requête

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.

wherestring

L’expression de filtrage. Les identifiants de colonne suivants sont reconnus (cela diffère des identifiants reconnus par le paramètre select).

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
limitinteger

Le nombre de résultats à renvoyer. Max. : 150000.

Par défaut:1000
timeoutinteger

Un délai d’expiration manuel, en secondes.

keyword_list_idinteger

L’identifiant d’une liste de mots-clés existante.

keywordsstring

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

countrystringObligatoire

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

Valeurs autorisées:adaeafagaialamaoarasatauawazba…
outputstring

Le format de sortie.

Valeurs autorisées:jsonphpxml

Réponses

keywordsarray<object>
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.

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.

Valeurs autorisées:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_card…
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