Suggestions de recherche

API + MCP

GET/v3/keywords-explorer/search-suggestions

Paramètres de requête

timeoutinteger

Durée de délai d’attente manuelle, en secondes.

limitinteger

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

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.

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>

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.

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