Docs
Rechercher dans la documentation...⌘K

Volume par pays

API + MCP
GET/v3/keywords-explorer/volume-by-country

Paramètres de requête

selectstring

Une liste de champs à renvoyer, séparés par des virgules.

order_bystring

Un champ selon lequel trier les résultats, avec une direction facultative. Format : field_name:asc ou field_name:desc (desc par défaut).

Champs disponibles :
  • cpc
  • difficulty (10 units)
  • growth_rate_12m
  • traffic_potential (10 units)
  • volume (10 units)
limitinteger

Le nombre de résultats à renvoyer.

offsetinteger

Le nombre de résultats à ignorer.

Par défaut:0
keyword_list_idinteger

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

keywordstring

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

countriesstring

Une liste de codes pays à deux lettres (ISO 3166-1 alpha-2), séparés par des virgules.

Valeurs autorisées:adaeafagaialamaoarasatauawazba…
volume_monthly_date_fromstring (date)

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

volume_monthly_date_tostring (date)

Date de fin au format AAAA-MM-JJ permettant de récupérer l’historique mensuel des volumes de recherche dans le champ volume_monthly_history. Obligatoire uniquement si volume_monthly_history est demandé.

outputstring

Le format de sortie.

Valeurs autorisées:jsonphp

Réponses

countriesarray<object>
countrystring

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

cpcinteger or null

Coût par clic de top_keyword, en cents US.

difficultyinteger or null

(10 units) Difficulté du mot-clé pour top_keyword.

growth_rate_12mnumber (float) or null

Croissance du volume de recherche sur 12 mois. Disponible pour les mots-clés de départ composés d’un seul mot-clé.

has_serpboolean or null

Indique si des données SERP sont disponibles pour top_keyword.

top_keywordstring or null

Le mot-clé de départ avec le volume de recherche le plus élevé dans ce pays.

top_pagestring or null

La page organique n° 1 pour top_keyword.

top_page_titlestring or null

Titre de top_page.

traffic_potentialinteger or null

(10 units) Potentiel de trafic de top_keyword.

volumeinteger

(10 unités) Une estimation du nombre mensuel moyen de recherches pour un mot-clé dans un pays donné.

volume_monthly_historyarray<object>

(50 units) Volumes de recherche mensuels additionnés pour les mots-clés de départ dans ce pays.

datestring (date)
volumeinteger