Amazon Storefront
Un Amazon storefront est la vitrine qu’un membre du programme Amazon Influencer tient sous son propre nom de boutique, avec des produits regroupés en listes d’idées et en posts curatés, une description, une photo de profil, des liens vers ses réseaux et une rangée de produits tendance. La lire permet de savoir qui est le créateur, où il publie par ailleurs, comment ses recommandations sont organisées et quels produits il met en avant en ce moment, à quel prix.
Fonctionnalités de la Amazon Storefront API
- Profil et badge de top créateurname, text et avatar_url donnent le nom affiché, la description de la vitrine et la photo de profil, tandis que is_top_creator indique si Amazon signale la personne comme top créateur.
- Comptes sociaux liéssocial_urls liste les profils TikTok, YouTube, Pinterest et autres que le créateur relie depuis l’en-tête de sa vitrine.
- Listes d’idées et nombre d’articleslists renvoie chaque liste d’idées de la première page de la vitrine avec son titre, son lien, son image de couverture et items_count, le nombre de produits qu’elle contient.
- Posts curatéscurations renvoie les posts curatés du créateur avec leur titre, leur lien, leur image de couverture et posts_count, le nombre de produits réunis dans chacun.
- Produits tendance avec prixtrending_picks renvoie les produits que la vitrine met en avant, chacun avec son lien dans la vitrine, son image, son prix actuel dans la devise de la place de marché et la remise affichée.
Paramètres de la Amazon Storefront API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | L’URL de la vitrine d’un créateur Amazon, au format https://www.amazon.com/shop/<name> ; les URL de vitrine des autres places de marché Amazon fonctionnent de la même façon. |
Comment utiliser la Amazon Storefront API
Envoyez l’URL d’une vitrine et lisez-la sous forme d’une ligne unique.
- Envoyez {"url": "https://www.amazon.com/shop/sydneydelrey"} en POST à /v1/amazon/shop.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez la vitrine dans results.items ; has_more et results.next_cursor suivent les règles de pagination habituelles et restent vides pour cette ligne unique.
curl -X POST "https://api.socq.ai/v1/amazon/shop" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.amazon.com/shop/sydneydelrey"}'Cas d’usage de la Amazon Storefront API
- Repérer des créateurs affiliés : Comparez is_top_creator, le nombre de listes d’idées et leur items_count d’une vitrine à l’autre pour retenir les créateurs qui sélectionnent activement des produits de votre catégorie.
- Suivre ce que recommande un créateur : Relisez une vitrine chaque semaine et comparez les titres de listes, items_count et trending_picks pour voir quelles listes saisonnières grossissent et quels produits passent au premier plan.
- Relier une vitrine aux réseaux sociaux : Servez-vous de social_urls pour rattacher chaque vitrine aux profils TikTok, YouTube ou Pinterest du créateur et réunir activité commerciale et audience sociale dans un même enregistrement.
Conseils d’expert pour la Amazon Storefront API
- Enregistrez le domaine de la place de marché avec chaque résultat, car trending_picks.price est exprimé dans la devise de cette place de marché.
- Indexez les vitrines sur id, le nom de boutique tiré de l’URL, afin que les lectures successives d’un même créateur s’alignent.
- Pour obtenir les produits un par un, ouvrez une liste ou un post curaté via son url ; items_count et posts_count vous en donnent la taille au préalable.
API associées
En complément de la Amazon Storefront 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 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.