amazon/
product-search

Recherchez une boutique Amazon prise en charge à partir d’une expression de produit et recevez des champs normalisés pour le produit, le vendeur, le prix, la note, les avis, le nombre de ventes et les médias.

Amazon Product Search API

Recherche de produits
Périmètre de boutique
Enregistrements normalisés
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 Search

Amazon Product Search convertit une expression de produit et l’URL d’une boutique en enregistrements de produits publics normalisés. Chaque élément peut comprendre une URL source, un titre, une description, un vendeur, un prix, une note, un nombre d’avis, un nombre de ventes, des médias, une date de publication et une date de collecte, dès lors que ces valeurs sont disponibles.

Fonctionnalités de la Amazon Product Search API

  • Requêtes limitées à une boutiqueAssociez une requête de produit non vide à un seul domaine Amazon pris en charge, afin que la boutique visée soit toujours explicite.
  • Volume de résultats maîtriséDéfinissez un results_limit entier de 1 à 2 000 ; la collecte s’arrête au plafond demandé ou lorsque la source n’a plus d’enregistrements à fournir.
  • Identité produit normaliséeObtenez des champs de produit stables pour l’ID, le type, l’URL source, le titre, la description, la date de publication et la date de collecte.
  • Contexte commercialExploitez les champs vendeur, prix, note, nombre d’avis, nombre de ventes et médias lorsqu’ils sont disponibles, sans analyser les formats de résultats propres à chaque boutique.

Paramètres de la Amazon Product Search API

ParamètresObligatoireDescription
queryObligatoireMot-clé ou expression de produit obligatoire et non vide.
domainObligatoireRéférence obligatoire d’une boutique Amazon. Son 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.
results_limitFacultatifPlafond de résultats demandé, de 1 à 2 000. La valeur par défaut est 100 si le paramètre est omis.

Comment utiliser la Amazon Product Search API

Choisissez la boutique visée et une expression de produit précise, puis envoyez une requête asynchrone.

  1. Renseignez une query non vide, indiquez l’URL d’un domaine Amazon pris en charge et choisissez un results_limit de 1 à 2 000.
  2. Envoyez la requête en POST à /v1/amazon/product-search et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
  4. Après un succès, lisez data.results.items et transmettez next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"wireless earbuds","domain":"https://www.amazon.com","results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Amazon Product Search API

  • Découverte de produits en boutique : Trouvez les produits publics qui correspondent à une catégorie, une caractéristique, une marque ou une expression d’intention d’achat dans une boutique Amazon prise en charge.
  • Comparaison d’offres : Comparez les montants, devises et prix formatés disponibles, ainsi que l’identité des vendeurs, entre les produits renvoyés.
  • Premier tri selon la réputation : Passez en revue les notes, nombres d’avis et nombres de ventes disponibles, en conservant les signaux manquants comme indisponibles.
  • Enrichissement de catalogue : Complétez vos produits candidats avec des titres, descriptions, URL sources, médias, vendeurs et horodatages de collecte normalisés.

Conseils d’expert pour la Amazon Product Search API

  • Stockez la requête et le domaine envoyés avec chaque tâche, car une même expression peut donner des résultats différents selon la boutique.
  • Choisissez results_limit selon le volume dont vous avez besoin : il détermine l’estimation de résultats réservée, tandis que la facturation finale se règle sur les enregistrements renvoyés.
  • Suivez next_cursor jusqu’à ce que has_more passe à false lorsqu’une tâche réussie contient plus d’une page de résultats stockée.
  • Considérez un vendeur, un prix, une note, un nombre d’avis, un nombre de ventes ou un média manquants comme indisponibles, et non comme un zéro ou une identité vide.

En complément de la Amazon Product Search 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 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 Search API — FAQ

Amazon Product Search API interroge une boutique Amazon prise en charge à partir d’une requête de produit et renvoie des enregistrements de produits publics normalisés, au sein d’un workflow de tâche asynchrone.

Le service vérifie le nom d’hôte analysé et accepte amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in et amazon.co.jp, sous-domaines compris. Tout schéma associé à un nom d’hôte, ainsi que les références relatives au protocole, sont acceptés.

query et domain sont des chaînes obligatoires et non vides. results_limit est facultatif, vaut 100 par défaut et doit être un entier de 1 à 2 000.

Un produit peut contenir l’ID, la plateforme, la ressource, le type, l’URL source, les dates de publication et de collecte, le titre, la description, le vendeur, le prix, la note, le nombre d’avis, le nombre de ventes et les médias. Les champs nullables ne sont présents que lorsque la source fournit des valeurs exploitables.

results_limit est un maximum. La collecte peut se terminer plus tôt lorsque la source publique n’a plus d’enregistrements correspondants, si bien qu’une tâche réussie peut contenir moins de produits, voire aucun.

Interrogez /v1/tasks/{task_id}, lisez data.results.items après le succès, puis demandez la page de résultats suivante avec next_cursor tant que has_more vaut true.

Chaque produit normalisé renvoyé avec succès coûte 0,15 crédit SocQ. La requête réserve des crédits d’après results_limit (ou 100 s’il est omis), puis règle selon le nombre réel de résultats et rembourse le crédit inutilisé ; un résultat vide n’entraîne aucun frais de résultat.