Retour aux API
Données publiques de commerce Amazon

Amazon Public Data API

Recherchez des produits Amazon publics et collectez des détails de produits, Best Sellers, avis, profils de vendeurs et vitrines de créateurs normalisés sur les places de marché prises en charge.

API Amazon disponibles

Utilisez Product Search, Product Detail, Best Sellers, Reviews, Seller Info et Storefront selon le workflow Amazon public concerné.

Quelles données Amazon pouvez-vous récupérer ?

SocQ renvoie des enregistrements normalisés de produits, d’avis, de vendeurs et de vitrines de créateurs à partir d’entrées Amazon publiques prises en charge, et conserve les champs nullables lorsque la source n’expose aucune valeur exploitable.

Identité et contenu du produit

Récupérez les ID de produit, titres, descriptions, URL publiques, libellés de plateforme et de ressource, ainsi que les horodatages de collecte disponibles.

Contexte vendeur et prix

Conservez les objets vendeur normalisés et les valeurs de prix avec chaque produit découvert, lorsqu’elles sont disponibles.

Signaux de réputation visibles

Exploitez les notes, nombres d’avis et nombres de ventes disponibles comme observations publiques à un instant donné, sans traiter les valeurs manquantes comme des zéros.

Médias du produit

Obtenez des objets média normalisés utilisables pour des catalogues de produits, des files d’audit et des traitements visuels en aval.

Vitrines de créateurs

Lisez le profil, les comptes sociaux liés, les listes d’idées avec leur nombre d’articles, les posts curatés et les produits tendance avec leur prix de la vitrine d’un créateur Amazon.

SocQ vs traitement direct des pages

SocQ fournit des workflows de tâches authentifiés et des schémas de résultats standard pour les données Amazon publiques prises en charge. Avec le traitement direct des pages, l’orchestration des requêtes, l’analyse, le stockage, la pagination et la maintenance du schéma restent à la charge de votre application.

FonctionnalitéSocQTraitement direct des pages
Entrée de départTermes de recherche ou URL Amazon publiques prises en chargeURL de pages et logique de récupération propre à l’application
Modèle d’exécutionTâche asynchrone avec interrogation de l’étatDéfini et exploité par votre application
Forme du produitEnregistrements de produits normalisésBalisage propre à chaque page et analyse sur mesure
Accès aux résultats stockésÉléments paginés par curseurStockage et pagination gérés par l’application

Fonctionnement de l’API Amazon

Les endpoints Amazon utilisent une tâche asynchrone, suivie d’une récupération des résultats paginée par curseur.

  1. 1. Envoyer l’entrée d’un endpoint

    Envoyez les termes de recherche, URL de produits, URL de catégories, URL de vendeurs ou URL de vitrine requis par l’endpoint choisi, et conservez le task_id.

  2. 2. Suivre le traitement

    Interrogez /v1/tasks/{task_id} jusqu’à la réussite du traitement ou jusqu’à ce que la tâche signale un échec.

  3. 3. Récupérer les produits

    Lisez data.results.items et suivez next_cursor tant que has_more vaut true pour récupérer tous les enregistrements sauvegardés.

Collecter des produits depuis une page Best Sellers

Authentifiez-vous avec une clé API SocQ, envoyez l’URL publique d’une liste de catégorie et suivez la tâche asynchrone jusqu’à ses résultats produits.

curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics"],"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 courants de l’API Amazon

Étude de l’assortiment par catégorie

Créez des instantanés bornés des produits visibles sur des pages Best Sellers choisies, pour un ensemble d’étude de catégories défini.

Enrichissement d’une présélection de produits

Ajoutez titres, descriptions, contexte vendeur, prix, médias et liens publics aux produits découverts sur des pages de catégories choisies.

Comparaison des signaux commerciaux

Comparez les prix, notes, nombres d’avis et nombres de ventes disponibles entre produits normalisés, en conservant l’heure de collecte.

Repérage de créateurs affiliés

Comparez des vitrines de créateurs selon le statut de top créateur, les listes d’idées, le nombre d’articles et les produits tendance pour présélectionner des partenaires d’affiliation.

Limites et politique sur les données publiques

Les résultats Amazon sont des enregistrements à un instant donné issus de pages publiques prises en charge. L’API n’accède ni aux comptes clients, ni aux données privées, paniers, commandes, systèmes d’inventaire ou fonctions de gestion vendeur.

  • Les hôtes pris en charge sont 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.
  • Utilisez des pages publiques Best Sellers ou de listes de catégories. La validation de l’hôte ne garantit pas qu’une page Amazon sans rapport contienne une liste de produits prise en charge.
  • results_limit vaut 100 par défaut, accepte de 1 à 2 000 et plafonne le total des résultats uniques sauvegardés pour l’ensemble des URL d’une tâche.
  • La réponse stable ne comprend pas de champ de rang Best Sellers.
  • Les ID de produit, contenus, vendeurs, prix, notes, nombres, médias, URL et dates de publication peuvent valoir null lorsqu’aucune valeur publique exploitable n’est disponible.

Questions fréquentes sur l’API Amazon

Qu’est-ce que l’API Amazon ?

Les API Amazon recherchent des produits et collectent des enregistrements normalisés de produits, d’avis, de vendeurs et de vitrines de créateurs à partir d’entrées Amazon publiques prises en charge.

Quels endpoints Amazon sont disponibles ?

Product Search, Product Detail, Best Sellers, Reviews, Seller Info et Storefront sont disponibles via le même workflow de tâche asynchrone.

Puis-je collecter plus d’une URL de catégorie ?

Oui. Envoyez plusieurs URL dans une même tâche, mais n’oubliez pas que results_limit est un plafond total partagé par la tâche et non une limite par URL.

SocQ renvoie-t-il le rang du produit ?

Non. Le rang ne fait pas partie du schéma de produit stable ; utilisez les champs disponibles d’identité, de vendeur, de prix, de réputation, de nombre de ventes, de médias, de source et d’horodatage.

Des champs peuvent-ils manquer sur un produit Amazon ?

Oui. Les champs de produit standard peuvent valoir null et doivent rester absents lorsque l’enregistrement public n’expose aucune valeur exploitable.

Comment l’endpoint Best Sellers est-il tarifé ?

Chaque produit standard renvoyé avec succès coûte 0,15 crédit. Un résultat vide n’entraîne aucun frais de résultat, et les crédits préfacturés non utilisés sont remboursés à la clôture de la tâche.

Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.

Apple App Store API

Collectez les détails d’applications, les classements par catégorie et les avis publics de l’Apple App Store à partir d’URL connues de la boutique, sous forme d’enregistrements d’applications et d’avis normalisés.

SEO API

Interrogez en direct les résultats organiques de Google, comparez la demande et la difficulté de classement des mots-clés, développez des termes de départ, repérez les mots-clés et les pages qui assurent la visibilité d’un site dans la recherche, classez l’intention de recherche et collectez les résultats de Google News, Google Images, Google Autocomplete, Bing et YouTube. Chaque endpoint utilise la même clé API SocQ, le même flux de tâche asynchrone et le même format de résultat normalisé.

Telegram API

Lisez les chaînes Telegram publiques à partir de leurs liens t.me : profils de chaîne avec nombre d’abonnés, publications avec vues et réactions, publications isolées, commentaires des groupes de discussion, chaînes similaires et recherche dans tout l’historique.

Link in Bio API

Transformez l’unique lien de la bio Instagram, TikTok ou YouTube d’un créateur en données structurées : nom affiché, bio, avatar, e-mail de contact indiqué, profils sociaux liés et chaque bouton de la page avec son titre et sa destination.

Creator API

Partez d’un profil Instagram, TikTok, YouTube, X, Facebook ou Threads pour trouver les e-mails professionnels publics d’un créateur, ses comptes sur d’autres réseaux ou une estimation de son âge et de son genre d’après sa photo de profil.

Google Hotels API

Recherchez des hôtels par destination, ouvrez la fiche complète de n’importe quel hôtel sur Google Hotels et récupérez son calendrier de prix par nuit, le tout relié par un même identifiant.