amazon/
best-sellers

Collectez les produits d’URL Amazon Best Sellers publiques et obtenez titres, contexte vendeur, prix, signaux de réputation visibles et médias sous forme d’enregistrements normalisés.

Amazon Best Sellers API

Entrée par URL de catégorie
Fiches produit
0,15 crédit par résultat
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 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ètresObligatoireDescription
urlsObligatoireListe 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_limitFacultatifEntier 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.

  1. 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.
  2. Envoyez urls et, si vous le souhaitez, results_limit (de 1 à 2 000) à /v1/amazon/best-sellers, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. 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 true

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

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.

Explorer d’autres plateformes

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

Amazon Best Sellers API — FAQ

Amazon Best Sellers API est une interface programmatique qui collecte les produits d’URL Amazon Best Sellers ou de listes de catégories publiques et les restitue sous forme de fiches produit SocQ normalisées.

Le tableau urls accepte les références dont le nom d’hôte analysé correspond à une place de marché Amazon prise en charge ou à l’un de ses sous-domaines, et dont le chemin contient /zgbs/ ou /gp/bestsellers/. Tout schéma associé à un nom d’hôte, ainsi que les références relatives au protocole, sont acceptés.

Aucun champ de rang ne fait partie de la réponse produit stable. La fiche normalisée porte sur l’identité du produit, son contenu, le vendeur, le prix, la note, les nombres d’avis et de ventes, les médias, les URL et les horodatages, lorsqu’ils sont disponibles.

results_limit vaut 100 par défaut, accepte les entiers de 1 à 2 000 et plafonne le nombre total de fiches uniques enregistrées pour la tâche, toutes URL confondues. Ce n’est pas une enveloppe distincte pour chaque URL.

Interrogez /v1/tasks/{task_id}, lisez data.results.items une fois la tâche réussie, puis redemandez le next_cursor renvoyé tant que has_more vaut true. La limite par page de résultats règle la pagination de lecture, pas le volume collecté.

La disponibilité publique, le contenu des pages, la sortie du fournisseur, la normalisation, la déduplication et le results_limit commun à toute la tâche peuvent tous réduire le nombre final de résultats. Une tâche réussie peut aussi ne contenir aucune fiche produit.

Chaque fiche produit standard renvoyée avec succès coûte 0,15 crédit SocQ. La tâche réserve des crédits d’après results_limit (ou 100 s’il est omis), puis règle le montant d’après le nombre réel de résultats et rembourse les crédits réservés non utilisés ; un résultat vide n’entraîne aucun frais de résultat.