Amazon Best Sellers
Les pages Amazon Best Sellers classent par catégorie des produits visibles publiquement, avec, lorsqu’ils sont exposés, les titres, le contexte vendeur, les prix, les notes, le nombre d’avis, le nombre de ventes, les médias, les liens sources et les dates d’observation. SocQ transforme les URL de listes choisies en fiches produit normalisées pour l’étude de catégories, la comparaison d’assortiments et des workflows de données e-commerce reproductibles.
Fonctionnalités de la Amazon Best Sellers API
- Collecte par URL de catégorie régionaleEnvoyez en une seule tâche asynchrone une ou plusieurs URL publiques de Best Sellers ou de listes de catégories, sur l’ensemble des places de marché Amazon prises en charge.
- Identité produit normaliséeRecevez des fiches produit stables avec les ID disponibles, les titres, les descriptions, les URL sources, les libellés de plateforme et de ressource ainsi que les horodatages de collecte.
- Contexte commercial et réputationLes informations vendeur, les prix, les notes, les nombres d’avis et de ventes disponibles sont rangés dans des champs explicites, sans avoir à analyser le balisage des pages.
- Fiches produit prêtes pour les médiasChaque produit s’accompagne d’objets média normalisés, utilisables pour des catalogues, des files de relecture, des pipelines d’enrichissement et l’analyse visuelle en aval.
Paramètres de la Amazon Best Sellers API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Liste obligatoire de références Amazon sur des hôtes ou sous-domaines de places de marché prises en charge. Chaque chemin doit contenir /zgbs/ ou /gp/bestsellers/. Tout schéma associé à un nom d’hôte analysé, ainsi que les références relatives au protocole, sont acceptés. |
results_limit | Facultatif | Entier facultatif de 1 à 2 000. La valeur par défaut est 100 ; il plafonne le nombre total de fiches produit uniques enregistrées pour l’ensemble des URL envoyées. |
Comment utiliser la Amazon Best Sellers API
Envoyez des URL Best Sellers publiques que vous connaissez, suivez la tâche asynchrone, puis parcourez page par page les fiches produit normalisées.
- Préparez une ou plusieurs URL publiques de Best Sellers ou de listes de catégories Amazon, hébergées sur une place de marché prise en charge.
- Envoyez urls et, si vous le souhaitez, results_limit (de 1 à 2 000) à /v1/amazon/best-sellers, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- Lisez data.results.items et demandez next_cursor tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/Best-Sellers-Books/zgbs/books"],"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 Best Sellers API
- Instantanés d’assortiment par catégorie : Transformez des pages Best Sellers choisies en inventaire de produits borné, avec liens sources et dates de collecte, pour alimenter un jeu de données d’étude défini.
- Comparaison des prix et de la réputation : Comparez les prix, notes, nombres d’avis et de ventes disponibles entre les produits renvoyés, sans devoir extraire ensuite un balisage de page hétérogène.
- Enrichissement de la découverte de produits : Ajoutez titres, contexte vendeur, descriptions, médias et URL publiques de produits aux présélections repérées sur des pages de catégories.
Conseils d’expert pour la Amazon Best Sellers API
- Utilisez des références sur des hôtes Amazon régionaux pris en charge dont le chemin contient /zgbs/ ou /gp/bestsellers/. Les autres chemins Amazon sont rejetés avant la création de la tâche.
- Définissez results_limit pour la tâche entière, et non pour chaque URL envoyée, en le dimensionnant selon le lot total dont vous avez besoin.
- Suivez next_cursor jusqu’à ce que has_more passe à false, car les résultats de la tâche sont servis par une vue distincte paginée par curseur.
- Considérez les ID, descriptions, données vendeur, prix, notes, compteurs, médias, URL et dates de publication comme des valeurs nullables, plutôt que de remplacer une valeur manquante par zéro ou par un objet vide.
- Stockez collected_at avec chaque enregistrement et planifiez des exécutions distinctes pour comparer des instants différents ; l’endpoint ne crée pas de flux continu.
API associées
En complément de la Amazon Best Sellers API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Amazon.
- 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 Reviews API — Collectez les avis publics sur des produits à partir d’URL Amazon prises en charge, avec texte, notes, informations sur les auteurs, références produit, horodatages et médias.
- 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.