Historique des mots-clés

API + MCP

GET/v3/site-explorer/keywords-history

Paramètres de requête

selectstring

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.

Par défaut:date,top3,top4_10,top11_plus

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

outputstring

Le format de sortie.

Valeurs autorisées:jsoncsvxmlphp

keywordsarray<object>

datestring (date)

top3integer

Le nombre total de mots-clés pour lesquels votre cible se classe dans les 3 premiers résultats de recherche organique.

top4_10integer

Le nombre total de mots-clés pour lesquels votre cible se classe dans les résultats de recherche organique aux positions 4 à 10.

top11_20integer

Le nombre total de mots-clés pour lesquels votre cible se classe dans les résultats de recherche organique aux positions 11 à 20.

top11_plusinteger

Le nombre total de mots-clés pour lesquels votre cible se classe dans les résultats de recherche organique aux positions 11 et au-delà.

top21_50integer

Le nombre total de mots-clés pour lesquels votre cible se classe dans les résultats de recherche organique aux positions 21 à 50.

top51_plusinteger

Le nombre total de mots-clés pour lesquels votre cible se classe dans les résultats de recherche organique aux positions 51 et au-delà.