Docs
Rechercher dans la documentation...⌘K

Mots-clés organiques

API + MCP
GET/v3/site-explorer/organic-keywords

Paramètres de requête

timeoutinteger

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

limitinteger

Nombre de résultats à renvoyer.

Par défaut:1000
order_bystring

Une liste de colonnes séparées par des virgules pour trier les résultats, avec un sens de tri facultatif. Consultez le schéma de réponse pour connaître les identifiants de colonne valides.

Example:field_a,field_b:asc,field_c:desc
wherestring

L'expression de filtre. Les identifiants de colonnes suivants sont reconnus (ceux-ci 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.

protocolstring

Le protocole de votre cible.

Valeurs autorisées:bothhttphttps
Par défaut:both
targetstring (url)Obligatoire

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

modestring

La portée de la recherche en fonction de la cible que vous avez saisie.

Valeurs autorisées:exactprefixdomainsubdomains
Par défaut:subdomains
countrystring

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

Valeurs autorisées:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
date_comparedstring (date)

Une date avec laquelle comparer les métriques, au format YYYY-MM-DD.

datestring (date)Obligatoire

Date pour laquelle générer les métriques, au format AAAA-MM-JJ.

volume_modestring

Mode de calcul du volume de recherche : mensuel ou moyen. Cela 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

keywordsarray<object>
all_positionsarray<object>

(5 unités) La liste de toutes les positions pour un mot-clé.

all_positions_prevarray<object>

(5 unités) La liste de toutes les positions d’un mot-clé à la date de comparaison.

best_positioninteger or null

La première position pour laquelle votre cible se classe dans les résultats de recherche organiques pour un mot-clé.

best_position_diffinteger or null

Le changement de position entre vos dates sélectionnées.

best_position_has_thumbnailboolean or null

La meilleure position comporte une vignette.

best_position_has_thumbnail_prevboolean or null

La meilleure position comporte une vignette à la date de comparaison.

best_position_has_videoboolean or null

La meilleure position comporte une vidéo.

best_position_has_video_prevboolean or null

La meilleure position comporte une vidéo à la date de comparaison.

best_position_kindstring or null

Le type de la meilleure position : organique, payante ou une fonctionnalité SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_mergedstring

Le type de la meilleure position optimisé pour le tri.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_prevstring or null

Le type de la meilleure position à la date de comparaison.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_previnteger or null

La meilleure position à la date de comparaison.

best_position_setstring

Le groupe de classement de la meilleure position.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

Le groupe de classement de la meilleure position à la date de comparaison.

Allowed values:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

L’URL positionnée dans les résultats de recherche organique.

best_position_url_prevstring (url) or null

L'URL de classement à la date de comparaison.

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.

cpc_mergedinteger or null

Le champ CPC optimisé pour le tri.

cpc_previnteger or null

La métrique CPC pour la date de comparaison.

entitiesarray<object>

Organisations, produits, personnes, œuvres, événements et lieux trouvés dans un mot-clé.

is_best_position_set_top_11_50boolean

Le groupe de classement de la meilleure position est 11-50.

is_best_position_set_top_11_50_prevboolean or null

Le groupe de classement de la meilleure position était 11-50 à la date de comparaison.

is_best_position_set_top_3boolean

Le groupe de classement de la meilleure position est dans le Top 3.

is_best_position_set_top_3_prevboolean or null

Le groupe de classement de la meilleure position était dans le Top 3 à la date de comparaison.

is_best_position_set_top_4_10boolean

Le groupe de classement de la meilleure position est 4-10.

is_best_position_set_top_4_10_prevboolean or null

Le groupe de classement de la meilleure position était 4-10 à la date de comparaison.

is_brandedboolean

Intention de l'utilisateur : de marque. L'utilisateur recherche une marque ou un nom d'entreprise spécifique.

is_commercialboolean

Intention de l'utilisateur : commerciale. L'utilisateur compare des produits ou des services avant de prendre une décision d'achat.

is_informationalboolean

Intention de l'utilisateur : informationnel. L'utilisateur recherche des informations ou une réponse à une question spécifique.

is_localboolean

Intention de l'utilisateur : local. L'utilisateur recherche des informations pertinentes relatives à un emplacement spécifique ou à des services à proximité.

is_navigationalboolean

Intention de l'utilisateur : navigationnel. L'utilisateur recherche un site web ou une page web spécifique.

is_transactionalboolean

Intention de l'utilisateur : transactionnel. L'utilisateur est prêt à effectuer une action, souvent un achat.

keywordstring or null

Le mot-clé pour lequel votre cible se classe.

keyword_countrystring

Le pays du mot-clé pour lequel votre cible se classe.

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
keyword_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.

keyword_difficulty_mergedinteger or null

(10 unités) Le champ de difficulté du mot-clé optimisé pour le tri.

keyword_difficulty_previnteger or null

(10 unités) La difficulté du mot-clé à la date de comparaison.

keyword_languagearray<string>

La langue de la requête de recherche

keyword_mergedstring

Le champ du mot-clé optimisé pour le tri.

keyword_prevstring or null

Le mot-clé pour lequel votre cible se classe à la date de comparaison.

languagestring

La langue de la SERP.

language_prevstring or null

La langue de la SERP à la date de comparaison.

last_updatestring (date-time)

Date de la dernière vérification des résultats des moteurs de recherche pour un mot-clé.

last_update_prevstring (date-time) or null

La date à laquelle nous avons vérifié les résultats des moteurs de recherche jusqu’à la date de comparaison.

serp_featuresarray<string>

Les fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_countinteger

Le nombre de fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé.

serp_features_count_previnteger or null

Le nombre de fonctionnalités SERP à la date de comparaison.

serp_features_mergedarray<string>

Le champ des fonctionnalités SERP optimisé pour le tri.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_features_prevarray<string>

Les fonctionnalités SERP qui apparaissent dans les résultats de recherche pour un mot-clé à la date de comparaison.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found
serp_target_main_positions_countinteger

Le nombre d’URL cibles classées pour un mot-clé, en excluant les positions dans les liens annexes, les articles à la une, les packs d’images et les publications sur X (Twitter).

serp_target_main_positions_count_previnteger or null

Le nombre d’URL cibles classées pour un mot-clé, en excluant les positions dans les liens annexes, les articles à la une, les packs d’images et les publications sur X (Twitter), à la date de comparaison.

serp_target_positions_countinteger

Le nombre d’URL cibles classées pour un mot-clé.

serp_target_positions_count_previnteger or null

Le nombre d’URL cibles classées pour un mot-clé à la date de comparaison.

statusstring

Le statut d’une page : la nouvelle page qui vient de commencer à se classer ("left"), la page perdue qui a disparu des résultats de recherche ("right"), ou aucun changement ("both").

Allowed values:leftrightboth
sum_paid_trafficinteger or null

(10 unités) Une estimation du nombre de visites mensuelles que votre cible reçoit de la recherche payante pour un mot-clé.

sum_paid_traffic_mergedinteger

(10 unités) Le champ du trafic payant optimisé pour le tri.

sum_paid_traffic_previnteger or null

(10 unités) Le trafic payant à la date de comparaison.

sum_trafficinteger or null

(10 unités) Une estimation du nombre de visites mensuelles que votre cible reçoit de la recherche organique pour un mot-clé.

sum_traffic_mergedinteger

(10 unités) Le champ de trafic optimisé pour le tri.

sum_traffic_previnteger or null

(10 unités) Le trafic à la date de comparaison.

volumeinteger or null

(10 unités) Une estimation du nombre de recherches pour un mot-clé au cours du dernier mois.

volume_desktop_pctnumber (float) or null

Le pourcentage du volume de recherche total provenant des appareils de bureau.

volume_mergedinteger or null

(10 unités) Le champ du volume de recherche optimisé pour le tri.

volume_mobile_pctnumber (float) or null

Le pourcentage du volume de recherche total provenant des appareils mobiles.

volume_previnteger or null

(10 unités) Le volume de recherche à la date de comparaison.

wordsinteger or null

Le nombre de mots d’un mot-clé.

words_mergedinteger

Le nombre de mots d’un mot-clé, optimisé pour le tri.

words_previnteger or null

Le nombre de mots d’un mot-clé à la date de comparaison.