Amazon Product Details
Les produits Amazon sont des articles de catalogue publics décrits par des identifiants, des titres, des descriptions, un contexte vendeur, des prix, des notes, des nombres d’avis et de ventes ainsi que des médias. Ces champs servent à enrichir un catalogue, à comparer des articles, à vérifier des sources et à produire des rapports sur les produits à un instant donné.
Fonctionnalités de la Amazon Product Details API
- Recherche par lot à partir d’URL de produits connuesEnvoyez une ou plusieurs URL Amazon dans une seule tâche : vous recevez au plus autant de fiches produit normalisées que d’URL valides fournies.
- Identité, texte et médias du produitChaque enregistrement peut contenir l’identifiant et l’URL du produit, le titre, la description, l’horodatage de collecte et les références d’images ou de vidéos disponibles.
- Vendeur, prix et signaux produit visiblesDes objets imbriqués pour le vendeur et le prix côtoient les champs de note, de nombre d’avis et de nombre de ventes déclaré, pour un traitement cohérent champ par champ.
- Hôtes Amazon pris en chargeLe validateur d’URL accepte les hôtes Amazon des États-Unis, du Royaume-Uni, d’Allemagne, de France, d’Espagne, d’Italie, du Canada, d’Australie, d’Inde et du Japon, sous-domaines compris.
Paramètres de la Amazon Product Details API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau obligatoire et non vide de références de produits Amazon connues. Le nom d’hôte analysé doit être amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp, ou un sous-domaine. Tout schéma associé à un nom d’hôte, ainsi que les références relatives au protocole, sont acceptés. |
Comment utiliser la Amazon Product Details API
Envoyez des URL de produits connues, conservez l’ID de la tâche asynchrone, puis lisez les fiches produit normalisées une fois la tâche réussie.
- Envoyez un tableau urls en POST à /v1/amazon/product-detail avec un jeton Bearer ou une clé API.
- Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
- Lisez data.results.items après le succès ; si has_more vaut true, demandez la page suivante avec next_cursor sans soumettre une nouvelle tâche produit.
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueCas d’usage de la Amazon Product Details API
- Enrichissement de catalogue d’articles connus : Associez titres, descriptions, contexte vendeur, prix, médias, notes et compteurs à un ensemble existant d’URL Amazon.
- Comparaison de produits à un instant donné : Comparez prix, devise, note, nombre d’avis, nombre de ventes et champs vendeur normalisés entre des fiches produit sélectionnées et collectées au même moment.
- Vérification de la source d’un produit : Appuyez-vous sur les identifiants, URL canoniques, titres, descriptions, références média et horodatages de collecte pour confronter vos références de catalogue aux pages produit publiques.
Conseils d’expert pour la Amazon Product Details API
- Utilisez des références dont le nom d’hôte analysé appartient à une place de marché Amazon prise en charge ; un hôte valide ne garantit pas à lui seul que la cible mène à une fiche produit publique.
- N’envoyez pas results_limit : cet endpoint fixe le plafond de résultats du fournisseur au nombre d’URL envoyées.
- Considérez comme nullables les champs vendeur, prix, note, nombre d’avis, nombre de ventes, médias, URL et date de publication, et conservez une tâche réussie sans aucun élément plutôt que de créer des données fictives.
- N’utilisez next_cursor que pour parcourir les résultats stockés d’une tâche ; continuez les requêtes GET de la même tâche au lieu de répéter le POST payant.
API associées
En complément de la Amazon Product Details 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 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.