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. InterrogezGET /v1/tasks/{task_id}jusqu’à ce que la tâche réussisse, puis lisez la ligne unique dedata.results.itemsavec le profil du créateur,social_urls,lists,curationsettrending_picks. Chaque requête coûte 0,5 crédit ($0,0025).
Ce que renvoie l’endpoint
1 crédit SocQ = $0,005.
| Endpoint | Ce qu’il renvoie | Prix |
|---|---|---|
| Amazon Storefront API | Une 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 prix | 0,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_urletis_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 :
listsavectitle,url,image_urletitems_count;curationsavectitle,url,image_urletposts_count(le nombre de produits de la publication sélectionnée). - Promotions en cours :
trending_picksavecurl,image_url,pricedans la devise de la marketplace etdiscountlorsqu’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
- 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. - 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. - Traitez les échecs à part. Une vitrine inexistante échoue avec remboursement. Marquez-la comme disparue plutôt que de relancer la requête.
- 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