DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Mots-clés classés
Les termes de recherche Amazon sur lesquels un produit se classe. Paginez avec limit, offset et offset_token ; utilisez le jeton au-delà des premières pages. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. C'est l'index Amazon propre à Labs, qui pagine et répond immédiatement — contrairement à seo-merchant, qui met en file d'attente un scraping en direct de la boutique.
Référence tarifaire
- Facturation : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.1356.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer une seconde fois à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- asinType: string
- filtersType: array (object | null)[] | null
tableau de paramètres de filtrage des résultats
champ facultatif
vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
vous devez définir un opérateur logiqueand,orentre les conditions
les opérateurs suivants sont pris en charge :regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,match,not_match
vous pouvez utiliser l'opérateur%aveclikeetnot_likepour correspondre à toute chaîne de zéro ou plusieurs caractères
exemple :["keyword_data.keyword_info.search_volume","in",[100,1000]];pour plus d'informations sur les filtres, consultez Dataforseo Labs - Filters ou ce guide du centre d'aide
Objet vide - ignoreType: boolean | null
_synonyms ignorer les mots-clés très similaires
champ facultatif
s'il est défini surtrue, seuls les mots-clés principaux sont renvoyés, tous les mots-clés très similaires sont exclus ;
valeur par défaut :false - languageType: string | null
_code code de langue
champ obligatoire si vous n'indiquez paslanguage_name
vous pouvez obtenir la liste des langues disponibles avec leurlanguage_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemple :en - languageType: string
_name nom complet de la langue
champ obligatoire si vous n'indiquez paslanguage_code
vous pouvez obtenir la liste des langues disponibles avec leurlanguage_nameen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemple :English - limitType: integer | null
nombre maximal de produits dans le tableau de résultats
champ facultatif
valeur par défaut :100;
valeur maximale :1000 - locationType: integer
_code code d'emplacement
champ obligatoire si vous n'indiquez paslocation_name
vous pouvez obtenir la liste des emplacements disponibles avec leurlocation_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Remarque : ce point de terminaison ne prend actuellement en charge que les emplacements des États-Unis, d'Égypte, d'Arabie saoudite et des Émirats arabes unis ;
exemple :2840 - locationType: string
_name nom complet de l'emplacement
champ obligatoire si vous n'indiquez paslocation_code
vous pouvez obtenir la liste des emplacements disponibles avec leurlocation_nameen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
Remarque : ce point de terminaison ne prend actuellement en charge que les emplacements des États-Unis, d'Égypte, d'Arabie saoudite et des Émirats arabes unis ;
exemple :United States - offsetType: integer | null
décalage dans le tableau de résultats des mots-clés renvoyés
champ facultatif
valeur par défaut :0
si vous indiquez la valeur10, les dix premiers mots-clés du tableau de résultats seront omis et les données seront fournies pour les mots-clés suivants - orderType: array string[] | null
_by règles de tri des résultats
champ facultatif
vous pouvez utiliser les mêmes valeurs que dans le tableaufilterspour trier les résultats
types de tri possibles :asc- les résultats seront triés par ordre croissantdesc- les résultats seront triés par ordre décroissant
vous devez utiliser une virgule pour définir un paramètre de tri
exemple :["keyword_data.keyword_info.competition,desc"]
règle par défaut :["ranked_serp_element.serp_item.rank_group,asc"]
notez que vous pouvez définir au maximum trois règles de tri dans une seule requête
vous devez utiliser une virgule pour séparer plusieurs règles de tri
exemple :["keyword_data.keyword_info.search_volume,desc","keyword_data.keyword_info.cpc,desc"] - tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_DataforseoLabsAmazonRankedKeywordsLiveResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_DataforseoLabsAmazonRankedKeywordsLiveTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- asinType: string | null
ASIN dans un tableau POST
- itemsType: array (object | null)[] | null
contient les concurrents de produits Amazon détectés et les données associées
- keywordType: object | null · Response36Afe1097B20_KeywordDataInfo
_data données de mot-clé pour le mot-clé renvoyé
- avgType: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info données de backlinks du mot-clé renvoyé
cet objet fournit le nombre moyen de backlinks, de pages de référence et de domaines, ainsi que les valeurs de classement moyennes parmi les 10 pages web les mieux classées organiquement pour le mot-clé- backlinksType: number | null
nombre moyen de backlinks
- dofollowType: number | null
nombre moyen de liens dofollow
- lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - mainType: number | null
_domain _rank - rankType: number | null
- referringType: number | null
_domains nombre moyen de domaines référents
- referringType: number | null
_main _domains nombre moyen de domaines principaux référents
- referringType: number | null
_pages nombre moyen de pages référentes
- seType: string | null
_type type de moteur de recherche
- clickstreamType: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info données clickstream du mot-clé renvoyé
pour obtenir des résultats pour ce champ, le paramètreinclude_clickstream_datadoit être défini surtrue- ageType: object | null
_distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- genderType: object | null
_distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - monthlyType: array (object | null)[] | null
_searches recherches mensuelles
représente le nombre (approximatif) de recherches sur cette idée de mot-clé (tel que disponible sur les douze derniers mois), ciblées sur les emplacements géographiques spécifiés- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- searchType: integer | null Format: int64
_volume taux moyen de volume de recherche mensuel
représente le nombre (approximatif) de recherches pour l'idée de mot-clé donnée sur google.com
- keywordType: string | null
idée de mot-clé renvoyée
- keywordType: object | null · Response36Afe1097B20_KeywordInfo
_info données de mot-clé de l'idée de mot-clé renvoyée
- categoriesType: array integer[] | null
- competitionType: number | null
concurrence
représente la quantité relative de concurrence associée au mot-clé donné. Cette valeur est basée sur les données Google Ads et peut être comprise entre 0 et 1 (inclus) - competitionType: string | null
_level - cpcType: number | null
coût par clic
représente le coût par clic moyen (USD) historiquement payé pour le mot-clé - highType: number | null
_top _of _page _bid enchère maximale pour que l'annonce s'affiche en haut de la première page
indique la valeur supérieure à environ 80 % des enchères les plus basses pour lesquelles des annonces ont été diffusées (d'après les statistiques Google Ads pour les annonceurs)
la valeur peut varier selon la localisation indiquée dans une requête POST - lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - lowType: number | null
_top _of _page _bid enchère minimale pour que l'annonce s'affiche en haut de la première page
indique la valeur supérieure à environ 20 % des enchères les plus basses pour lesquelles des annonces ont été diffusées (d'après les statistiques Google Ads pour les annonceurs)
la valeur peut varier selon la localisation indiquée dans une requête POST - monthlyType: array (object | null)[] | null
_searches recherches mensuelles
représente le nombre (approximatif) de recherches sur cette idée de mot-clé (tel que disponible sur les douze derniers mois), ciblées sur les emplacements géographiques spécifiés- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- seType: string | null
_type type de moteur de recherche
- searchType: integer | null Format: int64
_volume taux moyen de volume de recherche mensuel
représente le nombre (approximatif) de recherches pour l'idée de mot-clé donnée sur google.com - searchType: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend variations de la tendance du volume de recherche
représente la variation en pourcentage du volume de recherche par rapport à la période précédente- monthlyType: integer | null
variation en pourcentage du volume de recherche par rapport au mois précédent
- quarterlyType: integer | null
variation en pourcentage du volume de recherche par rapport au trimestre précédent
- yearlyType: integer | null
variation en pourcentage du volume de recherche par rapport à l'année précédente
- keywordType: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing contient le volume de recherche du mot-clé normalisé par le volume de recherche Bing
- isType: boolean | null
_normalized les informations de mot-clé sont normalisées si vrai, les valeurs sont normalisées avec les données Bing
- lastType: string | null
_updated _time date et heure de mise à jour de l'ensemble de données au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00
- monthlyType: array (object | null)[] | null
_searches taux mensuels de volume de recherche tableau d'objets avec les taux de volume de recherche pour un mois donné d'une année
- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- searchType: integer | null
_volume taux actuel de volume de recherche d'un mot-clé
- keywordType: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream contient le volume de recherche du mot-clé normalisé par les données clickstream
- isType: boolean | null
_normalized les informations de mot-clé sont normalisées si vrai, les valeurs sont normalisées avec les données Bing
- lastType: string | null
_updated _time date et heure de mise à jour de l'ensemble de données au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00
- monthlyType: array (object | null)[] | null
_searches taux mensuels de volume de recherche tableau d'objets avec les taux de volume de recherche pour un mois donné d'une année
- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- searchType: integer | null
_volume taux actuel de volume de recherche d'un mot-clé
- keywordType: object | null · Response36Afe1097B20_KeywordProperties
_properties informations complémentaires sur le mot-clé
- coreType: string | null
_keyword mot-clé principal d'un groupe
contient le mot-clé principal d'un groupe déterminé par l'algorithme de regroupement de synonymes
si la valeur estnull, notre base de données ne contient aucun mot-clé que l'algorithme correspondant pourrait identifier comme synonyme dekeyword - detectedType: string | null
_language langue détectée du mot-clé
indique la langue du mot-clé telle qu'identifiée par notre système - isType: boolean | null
_another _language la langue détectée du mot-clé diffère de la langue définie
sitrue, la langue définie dans la requête ne correspond pas à la langue déterminée par notre système pour un mot-clé donné - keywordType: integer | null
_difficulty difficulté de se classer dans les 10 premiers résultats organiques pour un mot-clé
indique la probabilité d'entrer dans les 10 premiers résultats organiques pour un mot-clé sur une échelle logarithmique de 0 à 100 ;
calculée en analysant, entre autres paramètres, les profils de liens des 10 premières pages des SERP ;
en savoir plus sur la métrique dans ce guide du centre d'aide - seType: string | null
_type type de moteur de recherche
- synonymType: string | null
_clustering _algorithm l'algorithme utilisé pour identifier les synonymes
valeurs possibles :keyword_metrics- indique l'algorithme basé sur les paramètreskeyword_infotext_processing- indique l'algorithme basé sur le texte
si la valeur estnull, notre base de données ne contient aucun mot-clé que l'algorithme correspondant pourrait identifier comme synonyme dekeyword - wordsType: integer | null Format: int64
_count nombre de mots dans le mot-clé
indique de combien de mots se compose le mot-clé
- languageType: string | null
_code code de langue dans un tableau POST
- locationType: integer | null
_code code de localisation dans un tableau POST
- seType: string | null
_type type de moteur de recherche
- searchType: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignType: array (string | null)[] | null
_intent intentions de recherche complémentaires
valeurs possibles :informational,navigational,commercial,transactional - lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - mainType: string | null
_intent intention de recherche principale
valeurs possibles :informational,navigational,commercial,transactional - seType: string | null
_type type de moteur de recherche
- serpType: object | null · Response36Afe1097B20_SerpInfo
_info données SERP
la valeur seranullsi vous n'avez pas défini le champinclude_serp_infosurtruedans le tableau POST ou s'il n'existe aucune donnée SERP pour ce mot-clé dans notre base de données- checkType: string | null
_url URL directe vers les résultats du moteur de recherche
vous pouvez l'utiliser pour vérifier que nous fournissons des résultats précis - lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - previousType: string | null
_updated _time date et heure précédant la plus récente mise à jour des données SERP
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-10-15 12:57:46 +00:00 - seType: integer | null Format: int64
_results _count nombre de résultats de recherche pour le mot-clé renvoyé
- seType: string | null
_type type de moteur de recherche
- serpType: array (string | null)[] | null
_item _types types de résultats de recherche dans la SERP
contient les types de résultats de recherche (items) trouvés dans la SERP
types d'éléments possibles :answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
remarque : les résultats réels ne seront renvoyés que pour les élémentsorganic,paid,featured_snippetetlocal_pack
- rankedType: object | null · Response36Afe1097B20_AmazonRankedSerpElement
_serp _element contient les données sur l'élément SERP du produit trouvé pour le
keywordrenvoyé- checkType: string | null
_url URL directe vers les résultats Amazon
vous pouvez l'utiliser pour vous assurer que nous fournissons des résultats exacts - lastType: string | null
_updated _time date et heure de mise à jour des données de mots-clés
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” ;
exemple :2019-11-15 12:57:46 +00:00 - previousType: string | null
_updated _time - seType: integer | null Format: int64
_results _count nombre total de résultats dans la SERP Amazon
- seType: string | null
_type type de moteur de recherche
- serpType: object | null · Response36Afe1097B20_AmazonInfo
_item contient des données sur l'élément SERP
la liste des éléments SERP pris en charge se trouve ci-dessous- asinType: string | null
ASIN dans un tableau POST
- boughtType: integer | null
_past _month Integer numbers.
- currencyType: string | null
- deliveryType: object | null · Response36Afe1097B20_AmazonDeliveryInfo
_info informations de livraison
informations de livraison, y compris les plages de dates de livraison gratuite et rapide- deliveryType: string | null
_date _from la date la plus proche à laquelle le produit peut être expédié
- deliveryType: string | null
_date _to la date la plus tardive à laquelle le produit peut être livré
- deliveryType: string | null
_message message accompagnant les informations de livraison tel que publié par le vendeur
- deliveryType: object | null · Response36Afe1097B20_PriceInfo
_price prix de la livraison prix de la livraison selon la localisation que vous avez indiquée dans la requête POST ; si la livraison gratuite est disponible, la valeur est null
- currencyType: string | null
devise du prix indiqué code ISO de la devise appliquée au prix
- currentType: number | null Format: double
prix actuel indique le prix actuel du produit ou du service présenté dans le résultat
- displayedType: string | null
_price chaîne de prix dans le résultat chaîne de prix brute telle que fournie dans le résultat
- isType: boolean | null
_price _range le prix est fourni sous forme de fourchette indique si un prix est fourni sous forme de fourchette
- maxType: number | null Format: double
_value le prix maximum le prix maximum du produit ou du service tel qu'indiqué dans le résultat
- regularType: number | null Format: double
prix normal indique le prix normal du produit ou du service sans réduction appliquée
- fastestType: string | null
_delivery _date _from la date la plus proche à laquelle le produit peut être livré avec une option de livraison rapide
- fastestType: string | null
_delivery _date _to la date la plus tardive à laquelle le produit peut être livré avec une option de livraison rapide
- domainType: string | null
domaine Amazon
- imageType: string | null
_url URL de l'image du produit mise en avant dans les résultats
- isType: boolean | null
_amazon _choice label "Amazon's choice"
si la valeur esttrue, le produit porte le label "Amazon's choice" - isType: boolean | null
_best _seller label "Best Seller"
si la valeur esttrue, le produit porte le label "Best Seller" - positionType: string | null
l'alignement de l'élément dans la SERP Amazon
peut prendre les valeurs suivantes :left,right - priceType: number | null
_from le prix normal d'un produit
exemple :49.98 - priceType: number | null
_to la limite supérieure de la plage de prix du produit
exemple :384.99 - rankType: integer | null
_absolute rang absolu dans la SERP Amazon
position absolue parmi tous les éléments de la SERP - rankType: integer | null
_group position au sein d'un groupe d'éléments ayant des valeurs
typeidentiques
les positions des éléments ayant des valeurstypedifférentes sont omises derank_group - ratingType: object | null · Response36Afe1097B20_RatingInfo
la note de l'élément
le taux de popularité basé sur les avis et affiché dans la SERP- ratingType: integer | null
_max la valeur maximale d'un rating_type
- ratingType: string | null
_type le type de note vous trouverez ici les éléments suivants : Max5, Percents, CustomMax
- valueType: number | null Format: float
la valeur de la note
- votesType: integer | null Format: int64
_count la quantité d'avis
- seType: string | null
_type type de moteur de recherche
- specialType: array (string | null)[] | null
_offers détails de l'offre spéciale
contient les détails de l'offre spéciale, y compris les remises par coupon et Subscribe & Save - titleType: string | null
titre du produit
- typeType: string | null
type d'élément
- urlType: string | null
URL de la page produit
- xpathType: string | null
le XPath de l'élément
- serpType: array (string | null)[] | null
_item _types URL directe vers les résultats Amazon
contient les types de tous les résultats de recherche (items) trouvés dans la SERP renvoyée ;
types d'éléments possibles :amazon_serp,amazon_paid,editorial_recommendations,top_rated_from_our_brands,related_searches
- seType: string | null
_type type de moteur de recherche
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - languageType: string | null
_code code de langue dans un tableau POST
s'il n'y a pas de données, la valeur estnull - locationType: integer | null
_code code d'emplacement dans un tableau POST
s'il n'y a pas de données, la valeur estnull - seType: string | null
_type type de moteur de recherche
- totalType: integer | null Format: int64
_count quantité totale de résultats de notre base de données correspondant à votre requête
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/amazon/ranked_keywords/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"asin": "B00R92CL5E",
"location_code": 2840,
"language_code": "en"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"se_type": null,
"asin": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"keyword_data": "[Max Depth Exceeded]",
"ranked_serp_element": "[Max Depth Exceeded]"
}
]
}
]
}
]
}