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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé ou expression de produit obligatoire et non vide. |
domain | Obligatoire | Ré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_limit | Facultatif | Plafond 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.
- Renseignez une query non vide, indiquez l’URL d’un domaine Amazon pris en charge et choisissez un results_limit de 1 à 2 000.
- Envoyez la requête en POST à /v1/amazon/product-search et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche atteigne succeeded ou failed.
- 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 trueCas 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.
API associées
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.