Amazon Reviews
Les avis sur les produits Amazon sont des retours clients publics, composés d’un texte rédigé, d’une note, d’informations sur l’auteur, d’une date de publication, de références produit et de médias joints. Ces enregistrements alimentent les études de retours produit, les comparaisons de notes, la veille sur les avis et l’enrichissement de données relié à leurs sources.
Fonctionnalités de la Amazon Reviews API
- Saisie de plusieurs URL de produitsEnvoyez une ou plusieurs URL de produits Amazon prises en charge dans une même tâche ; un seul plafond de résultats s’applique à l’ensemble des avis normalisés enregistrés.
- Contenu des avis et auteursChaque enregistrement peut conserver le texte public de l’avis, la note chiffrée, l’identité de l’auteur, la date de publication et les images ou vidéos jointes.
- Enregistrements rattachés au produitLes résultats normalisés gardent les identifiants et URL de produit à côté de l’identité de l’avis et de ses liens sources, pour que chaque enregistrement reste lié à l’article évalué.
Paramètres de la Amazon Reviews API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire de références de produits Amazon non vides. Chaque nom d’hôte analysé doit appartenir à une place de marché prise en charge ou à l’un de ses sous-domaines ; tout schéma associé à un nom d’hôte, ainsi que les références relatives au protocole, sont acceptés. Chaque élément devient une ligne d’entrée pour le fournisseur. |
results_limit | Facultatif | Nombre maximal d’avis normalisés enregistrés pour toute la tâche ; la valeur par défaut est 100 et les entiers de 1 à 2 000 sont acceptés. |
Comment utiliser la Amazon Reviews API
Envoyez des URL de produits prises en charge, suivez la tâche asynchrone, puis lisez les avis normalisés avec la pagination par curseur.
- Préparez une ou plusieurs URL de produits Amazon prises en charge et choisissez un results_limit de 1 à 2 000.
- Envoyez la requête en POST à /v1/amazon/reviews et conservez le task_id renvoyé.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items et demandez le next_cursor renvoyé tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Amazon Reviews API
- Étude des retours sur un produit : Exploitez le texte, les notes, les auteurs et les dates de publication pour examiner les retours publics renvoyés sur des produits que vous connaissez.
- Comparaison de notes entre produits : Envoyez plusieurs URL de produits et regroupez les notes renvoyées par subject_id ou subject_url pour comparer les avis collectés.
- Enrichissement par des preuves d’avis : Rattachez liens sources, références produit, détails d’auteur, horodatages et médias d’avis à vos jeux de données produits ou à vos suivis existants.
Conseils d’expert pour la Amazon Reviews API
- Utilisez des références dont le nom d’hôte analysé appartient à une place de marché Amazon prise en charge ; les liens raccourcis sur des hôtes sans rapport et les hôtes régionaux non pris en charge échouent à la validation.
- Définissez results_limit selon le nombre total d’avis que vous voulez stocker pour toutes les URL envoyées, puis suivez next_cursor jusqu’à ce que has_more passe à false pour lire chaque page enregistrée.
- Identifiez les enregistrements par l’id de l’avis lorsqu’il est présent et conservez subject_id ou subject_url pour regrouper les avis par produit.
- Traitez un texte, un champ d’auteur, une note, un horodatage, une référence produit ou un média manquants comme des inconnues, sans inventer de valeur de remplacement.
API associées
En complément de la Amazon Reviews API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Amazon.
- Amazon Best Sellers API — Collectez les produits à partir d’URL de catégories Amazon Best Sellers publiques, avec vendeur, prix, réputation, ventes, médias, source et horodatage normalisés.
- Amazon Product Details API — Collectez le détail de produits à partir d’URL Amazon connues avec titre, description, vendeur, prix, note, nombre d’avis, ventes et médias.
- Amazon Product Search API — Recherchez dans une boutique Amazon prise en charge à partir d’une expression de produit et obtenez des champs normalisés de produit, vendeur, prix, note, avis, ventes, médias et source lorsqu’ils sont disponibles.
- Amazon Seller Info API — Collectez, à partir d’URL de vendeurs Amazon connues, l’identité publique du profil vendeur, sa description, son site web, sa note, ses évaluations, sa localisation, sa source et l’heure de collecte.
- Amazon Storefront API — Lisez la vitrine d’un créateur Amazon à partir de son URL, avec profil, comptes sociaux liés, listes d’idées et leur nombre d’articles, posts curatés et produits tendance avec leur prix.