amazon/
product-detail

Collectez les détails publics de produits Amazon à partir d’URL connues et obtenez titres, descriptions, vendeurs, prix, notes, nombres d’avis et de ventes ainsi que médias sous forme d’enregistrements normalisés.

Amazon Product Details API

URL de produits connues
Entrée multi-places de marché
Fiches produit normalisées
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 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ètresObligatoireDescription
urlsObligatoireTableau 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.

  1. Envoyez un tableau urls en POST à /v1/amazon/product-detail avec un jeton Bearer ou une clé API.
  2. Conservez le task_id renvoyé et interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ou failed.
  3. 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 true

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

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.

Explorer d’autres plateformes

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

Amazon Product Details API — FAQ

Amazon Product Details API est une interface programmatique qui collecte les détails publics de produits à partir de références Amazon connues. Elle renvoie des identifiants, titres, descriptions, objets vendeur et prix, notes, nombres d’avis et de ventes, médias et métadonnées de collecte normalisés.

Envoyez un tableau urls non vide contenant des URL de produits Amazon. Le service 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.

Oui. Ajoutez plusieurs URL connues au tableau urls. Le plafond de résultats du fournisseur est égal au nombre d’URL envoyées, et des lignes invalides, indisponibles ou en erreur peuvent réduire le nombre de résultats réussis.

Le schéma produit stable comprend les champs d’identité et de source, le titre, la description, les objets imbriqués vendeur et prix, la note, le nombre d’avis, le nombre de ventes déclaré, les médias et les horodatages. Les valeurs sources facultatives restent à null lorsqu’elles sont indisponibles.

La pagination s’applique à la lecture des résultats stockés une fois la tâche réussie, et non à l’envoi des URL de produits. Suivez next_cursor avec GET /v1/tasks/{task_id} uniquement tant que has_more vaut true.

La requête réserve une estimation de 0,15 crédit par URL envoyée, puis règle 0,15 crédit pour chaque fiche produit renvoyée avec succès. Avec une base à zéro crédit et une politique de résultat vide limitée à la base, une tâche sans enregistrement renvoyé se règle à zéro.