Historique du volume de recherche total

API + MCP

GET/v3/site-explorer/total-search-volume-history

Paramètres de requête

modestring

La portée de la cible.

Valeurs autorisées:exactprefixdomainsubdomains

Par défaut:subdomains

targetstring (url)Obligatoire

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

portfolio_idinteger

L’identifiant unique du portfolio. S’il est fourni, il prévaut sur target.

protocolstring

Le protocole de votre cible.

Valeurs autorisées:bothhttphttps

Par défaut:both

countrystring

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

Valeurs autorisées:adaeafagaialamaoarasatauawazba…

date_fromstring (date)Obligatoire

La date de début de la période historique au format AAAA-MM-JJ.

date_tostring (date)

La date de fin de la période historique au format AAAA-MM-JJ.

history_groupingstring

L’intervalle de temps utilisé pour regrouper les données historiques.

Valeurs autorisées:dailyweeklymonthly

Par défaut:monthly

top_positionsstring

Le nombre des meilleures positions de recherche organique à prendre en compte lors du calcul du volume de recherche total.

Valeurs autorisées:top_10top_100

Par défaut:top_10

volume_modestring

Le mode de calcul du volume de recherche : mensuel ou moyen. Il affecte le volume, le trafic et la valeur de trafic.

Valeurs autorisées:monthlyaverage

Par défaut:monthly

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

Réponses

metricsarray<object>

datestring (date)

total_search_volumeinteger

(10 unités) Le volume de recherche total des mots-clés pour lesquels votre cible se classe aux top_positions spécifiées dans les résultats de recherche.