amazon/
seller-info

Convertissez des URL publiques de profils vendeur Amazon connues en champs normalisés : identité du vendeur, description, site web, note, avis, localisation, source et date de collecte.

Amazon Seller Info API

Détails du profil vendeur
Places de marché prises en charge
Un enregistrement par URL
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 Seller Info

Les pages de profil vendeur Amazon peuvent révéler le nom d’un vendeur, sa description publique, sa note, son total d’avis, son site web et des éléments de localisation. SocQ collecte les champs publics disponibles pour des URL de vendeurs connues dans un schéma de vendeur stable, tandis que les valeurs privées, absentes, propres à une place de marché ou indisponibles restent à null au lieu d’être déduites.

Fonctionnalités de la Amazon Seller Info API

  • Collecte à partir d’URL de vendeurs connuesEnvoyez une ou plusieurs URL publiques de profils vendeur issues de dix places de marché Amazon prises en charge, dont les États-Unis, le Royaume-Uni, l’UE, le Canada, l’Australie, l’Inde et le Japon.
  • Identité de vendeur stableRecevez l’ID du vendeur, son URL publique, le nom du vendeur ou de l’entreprise, sa description, son site web associé et l’horodatage de collecte dans une structure de résultat fixe.
  • Signaux publics de réputationConservez les valeurs rating et feedback_count telles que déclarées par la source lorsqu’Amazon les expose, sans calculer ni compléter les mesures manquantes.
  • Contexte de localisation sur la place de marchéStockez le nom du lieu, la ville, la région, le pays, la latitude et la longitude lorsqu’ils sont disponibles, chaque valeur de localisation facultative pouvant rester à null.

Paramètres de la Amazon Seller Info API

ParamètresObligatoireDescription
urlsObligatoireTableau obligatoire et non vide de références publiques de vendeurs Amazon. Le nom d’hôte analysé doit appartenir à une place de marché prise en charge ou à l’un de ses sous-domaines ; tout schéma associé à un nom d’hôte, ainsi que les références relatives au protocole, sont acceptés. Utilisez des chemins de profil vendeur pour cette opération de détail.

Comment utiliser la Amazon Seller Info API

Envoyez des URL publiques de profils vendeur Amazon, suivez la tâche asynchrone, puis lisez les enregistrements de vendeurs normalisés dans le résultat paginé de la tâche.

  1. Copiez une ou plusieurs URL publiques de profils vendeur Amazon provenant d’une place de marché prise en charge.
  2. Envoyez le tableau urls en POST à /v1/amazon/seller-info et conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
  4. Lisez data.results.items et suivez next_cursor uniquement lorsque has_more vaut true.
curl -X POST "https://api.socq.ai/v1/amazon/seller-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'

# Poll GET /v1/tasks/{task_id}
# Read normalized sellers from data.results.items

Cas d’usage de la Amazon Seller Info API

  • Cartographie de l’identité des vendeurs : Transformez une liste préparée d’URL de profils vendeur en ID de vendeur, noms, URL publiques, sites web et contexte de place de marché cohérents.
  • Instantanés de réputation : Enregistrez la note publique, le total d’avis et l’heure collected_at pour comparer des instants successifs, sans considérer ces valeurs comme un flux en direct.
  • Revue des fournisseurs de la place de marché : Constituez une file de revue qui garde la description publique, le site web, la localisation et les signaux d’avis du vendeur rattachés à l’URL du profil d’origine.

Conseils d’expert pour la Amazon Seller Info API

  • Envoyez des liens canoniques de profils vendeur, comme /sp?seller={seller_id} ; les pages produit et les pages de recherche respectent la règle d’hôte, mais ne sont pas des entrées valides pour le détail d’un vendeur.
  • N’envoyez pas results_limit. Le backend crée une entrée de détail par URL et plafonne les résultats stockés au nombre d’URL non vides envoyées.
  • Une URL acceptée peut renvoyer zéro ou un enregistrement de vendeur. Des pages manquantes ou indisponibles peuvent donc rendre result_count inférieur au nombre d’URL.
  • Considérez rating et feedback_count comme des instantanés déclarés par la source, et servez-vous de collected_at pour comparer des collectes répétées.
  • Les champs de localisation et website sont facultatifs. Ne déduisez ni présence juridique, ni propriété, ni vérification à partir d’une valeur null ou d’un profil public.

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

Amazon Seller Info API est une interface fondée sur des URL qui collecte les champs publics de profils vendeur Amazon dans un schéma de vendeur normalisé. Elle n’accède pas aux données privées des comptes Seller Central.

La validation à l’exécution 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.

Non. Chaque URL non vide envoyée devient une entrée de détail et peut produire au plus un enregistrement de vendeur, mais des pages indisponibles, refusées par le fournisseur ou vides peuvent ne renvoyer aucun enregistrement.

Non. results_limit n’est pas un champ de requête accepté, et le fournisseur reçoit une ligne de détail par URL. L’endpoint de résultats de la tâche peut toutefois paginer les éléments stockés avec limit et next_cursor.

Chaque enregistrement de vendeur renvoyé avec succès coûte 0,15 crédit SocQ. La requête réserve 0,15 crédit par URL envoyée, puis règle selon le result_count réel. Un résultat vide réussi entraîne seulement la base à zéro crédit et rembourse la réservation inutilisée.