AmazonAmazon StorefrontAmazon InfluencerMarketing d’affiliationGuide API

API Amazon Storefront : lire les boutiques de créateurs, les listes d’idées et les tendances

Lisez la vitrine Amazon d’un créateur en un seul appel d’API : profil, réseaux sociaux liés, listes d’idées avec nombre d’articles, publications sélectionnées et produits tendance avec prix, pour 0,5 crédit.

SocQMis à jour le 19 novembre 20266 min de lecture

Les créateurs du programme Amazon Influencer tiennent une vitrine à l’adresse amazon.com/shop/<name>. Ils y regroupent des produits en listes d’idées et en publications sélectionnées, y lient leurs comptes sociaux et y mettent en avant des produits tendance. Pour une équipe affiliation ou influence, cette page répond à des questions concrètes : qui est le créateur, où publie-t-il par ailleurs, que recommande-t-il cette saison et quelle est la taille de chaque liste.

Le 2026-11-17, SocQ a ajouté l’API Amazon Storefront, qui renvoie une vitrine sous la forme d’un seul enregistrement structuré. Ce guide présente la requête, les champs, le prix et la manière de l’intégrer à un workflow de recherche de créateurs.

Réponse rapide : envoyez l’URL d’une vitrine dans url à POST /v1/amazon/shop. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse, puis lisez la ligne unique de data.results.items avec le profil du créateur, social_urls, lists, curations et trending_picks. Chaque requête coûte 0,5 crédit ($0,0025).

Ce que renvoie l’endpoint

1 crédit SocQ = $0,005.

EndpointCe qu’il renvoiePrix
Amazon Storefront APIUne ligne par vitrine : nom du créateur, description, avatar, indicateur de top créateur, profils sociaux liés, listes d’idées avec nombre d’articles, publications sélectionnées avec nombre de produits et produits tendance avec prix0,5 crédit ($0,0025) par appel

La ligne couvre la première page des listes, publications sélectionnées et produits tendance de la vitrine. Une vitrine inexistante échoue avec remboursement : les URL mortes ne vous sont pas facturées.

Authentification et flux de tâches asynchrones

Toutes les requêtes SocQ s’authentifient avec une clé API, et le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chaque collecte s’exécute comme une tâche en arrière-plan :

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La réponse à l’envoi contient data.task_id et data.status. Interrogez la tâche avec cet ID :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Lorsque status vaut succeeded, la réponse inclut la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500 ; si has_more vaut true, passez results.next_cursor comme cursor. Tant qu’une tâche est queued, running ou failed, l’endpoint renvoie les métadonnées de la tâche sans results.

Un callback_url facultatif dans le corps de l’envoi fait que SocQ envoie un POST unique avec un résumé de la tâche quand elle se termine ; lisez ensuite les enregistrements avec GET /v1/tasks/{task_id}. Un délai d’expiration côté client n’annule pas la tâche : reprenez avec le même ID de tâche au lieu de payer un doublon. 402 signifie crédits insuffisants ; 429 signifie que la clé a atteint une limite de débit ou de crédits.

Demander une vitrine

La seule entrée est url, une vitrine au format amazon.com/shop/<name>. Les autres marketplaces Amazon fonctionnent de la même façon.

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"
  }'

L’endpoint accepte une URL par requête. Pour lire une liste de vitrines, envoyez une tâche par URL, conservez chaque task_id avec son entrée et interrogez-les indépendamment.

Comprendre l’enregistrement d’une vitrine

Un résultat abrégé, tiré de l’exemple de la documentation, se présente ainsi :

{
  "id": "sydneydelrey",
  "platform": "amazon",
  "resource": "shop",
  "type": "storefront",
  "url": "https://www.amazon.com/shop/sydneydelrey",
  "name": "sydney del rey",
  "is_top_creator": true,
  "social_urls": [
    "https://vm.tiktok.com/ZTFrowSpg/",
    "https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA",
    "https://www.pinterest.com/sydneydelrey"
  ],
  "lists": [
    {
      "title": "Holiday home goods",
      "url": "https://www.amazon.com/shop/sydneydelrey/list/XYAIGEFWJGML?tag=sydneybertonc-20",
      "items_count": 107
    }
  ],
  "curations": [
    {
      "title": "f/w fit try ons",
      "url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae",
      "posts_count": 109
    }
  ],
  "trending_picks": [
    {
      "url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FCLQD6BN?showRelatedPost=true&tag_override=sydneybertonc-20",
      "price": 24.99,
      "discount": null
    }
  ]
}

Les champs, regroupés selon leur usage :

  • Identité du créateur : id (le nom de la vitrine tiré de l’URL), name, text (la description rédigée par le créateur), avatar_url et is_top_creator, qui indique si Amazon classe le créateur parmi les top créateurs.
  • Audience multiplateforme : social_urls, les profils sociaux liés sur la vitrine.
  • Structure du catalogue : lists avec title, url, image_url et items_count ; curations avec title, url, image_url et posts_count (le nombre de produits de la publication sélectionnée).
  • Promotions en cours : trending_picks avec url, image_url, price dans la devise de la marketplace et discount lorsqu’une remise est affichée.

Chaque ligne comporte aussi collected_at, l’heure de collecte par SocQ. Les prix changent : conservez cet horodatage avec chaque prix que vous stockez. Le tableau complet des champs se trouve dans la documentation Amazon Storefront.

Quand l’utiliser

Repérer des partenaires d’affiliation. is_top_creator, le nombre de listes et l’items_count de chacune donnent une idée rapide de l’activité d’une vitrine avant que quiconque dans votre équipe ne l’ouvre.

Suivre ce que recommande un créateur. Relisez une vitrine à intervalles réguliers et comparez les titres de listes, les nombres et les produits tendance d’une exécution à l’autre pour voir ce que le créateur met en avant cette saison.

Relier une vitrine aux comptes sociaux du créateur. social_urls vous donne les profils TikTok, YouTube ou Pinterest liés par le créateur. Transmettez-les aux API Creator pour trouver des e-mails professionnels publics, ou aux endpoints de profil des plateformes pour obtenir le nombre d’abonnés.

Recherche de produits. Les produits tendance pointent vers des produits. Pour obtenir des données produit complètes, des avis ou des classements par catégorie, utilisez les autres endpoints Amazon de SocQ, comme l’API Amazon Product Details et l’API Amazon Best Sellers. Pour comparer ces options avec les API d’Amazon, consultez Alternatives à l’Amazon Product Advertising API.

Conseils pour la production

  1. Normalisez les URL. Gardez une seule forme canonique amazon.com/shop/<name> par créateur pour ne pas payer deux fois la même vitrine.
  2. Attendez-vous à un instantané de la première page. Les listes, publications sélectionnées et produits tendance sont ceux affichés sur la première page de la vitrine. Traitez les nombres comme un instantané à collected_at.
  3. Traitez les échecs à part. Une vitrine inexistante échoue avec remboursement. Marquez-la comme disparue plutôt que de relancer la requête.
  4. Budgétez simplement. À 0,5 crédit par vitrine, 1 000 vitrines coûtent 500 crédits, soit $2,50.

FAQ

Qu’est-ce que l’API Amazon Storefront ?

C’est un endpoint SocQ qui lit la vitrine d’un créateur Amazon (amazon.com/shop/<name>) et renvoie le profil du créateur, ses réseaux sociaux liés, ses listes d’idées, ses publications sélectionnées et ses produits tendance sous la forme d’un seul enregistrement structuré.

Fonctionne-t-elle en dehors d’amazon.com ?

Oui. La documentation indique que les autres marketplaces Amazon fonctionnent de la même façon : envoyez dans url l’URL de la vitrine sur cette marketplace. Les prix de trending_picks sont exprimés dans la devise de cette marketplace.

Renvoie-t-elle chaque produit de chaque liste ?

Non. La ligne couvre la première page de la vitrine : le titre, l’URL, l’image de couverture et l’items_count de chaque liste, le nombre de produits de chaque publication sélectionnée et les produits tendance du moment. Elle ne détaille pas chaque article des listes.

Suis-je facturé si la vitrine n’existe pas ?

Non. Une vitrine inexistante échoue avec remboursement. Une requête réussie coûte 0,5 crédit ($0,0025).

Puis-je envoyer plusieurs vitrines dans une seule requête ?

La requête accepte une seule url. Envoyez une tâche par vitrine et suivez chaque task_id.

AMAZON API

Tester le workflow avec une URL publique Amazon

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API Amazon