amazon/
reviews

Collectez les avis publics sur des produits Amazon à partir d’URL prises en charge et obtenez texte, notes, détails sur l’auteur, références produit, dates et médias sous forme d’enregistrements normalisés.

Amazon Reviews API

Plusieurs URL de produits
Texte et notes des avis
Contexte auteur et produit
Avis normalisés
0,15 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
urlsObligatoireListe 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_limitFacultatifNombre 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.

  1. Préparez une ou plusieurs URL de produits Amazon prises en charge et choisissez un results_limit de 1 à 2 000.
  2. Envoyez la requête en POST à /v1/amazon/reviews et conservez le task_id renvoyé.
  3. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 true

Cas 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.

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.

Explorer d’autres plateformes

Combinez les données Amazon avec les données publiques d’autres plateformes sociales prises en charge.

Amazon Reviews API — FAQ

Amazon Reviews API est une interface programmatique qui collecte les avis publics à partir d’URL de produits Amazon prises en charge. Elle renvoie le texte des avis, les notes, les détails sur l’auteur, les horodatages, les références produit, les liens sources et les médias sous forme normalisée.

Envoyez un tableau urls non vide dont les noms d’hôte analysés sont amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp, ou leurs sous-domaines. Tout schéma associé à un nom d’hôte, ainsi que les références relatives au protocole, sont acceptés.

results_limit est le nombre maximal d’avis normalisés enregistrés pour l’ensemble de la tâche, et non un nombre garanti par URL. La tâche peut se terminer avec moins d’enregistrements lorsque moins d’avis publics sont renvoyés ou que des doublons sont supprimés.

Une fois la tâche réussie, lisez data.results.items et transmettez next_cursor à l’endpoint de la tâche tant que has_more vaut true. L’endpoint de résultats accepte une limite de page de 1 à 500.

Chaque avis enregistré avec succès coûte 0,15 crédit SocQ. La requête réserve des crédits d’après results_limit, puis règle selon le nombre réel de résultats ; un résultat vide n’entraîne aucun frais de résultat.