Amazon Seller Info
Amazon-Verkäuferprofilseiten können Verkäufernamen, öffentliche Beschreibung, Bewertung, Gesamtzahl der Feedbacks, Website und Standortkontext offenlegen. SocQ erfasst die verfügbaren öffentlichen Felder zu bekannten Verkäufer-URLs in einem stabilen Verkäuferschema, während private, fehlende, marktplatzspezifische oder nicht verfügbare Werte null bleiben, statt abgeleitet zu werden.
Funktionen der Amazon Seller Info API
- Erfassung bekannter Verkäufer-URLsÜbergeben Sie eine oder mehrere öffentliche Verkäuferprofil-URLs aus zehn unterstützten Amazon-Marktplätzen, darunter die USA, das Vereinigte Königreich, die EU, Kanada, Australien, Indien und Japan.
- Stabile VerkäuferidentitätErhalten Sie Verkäufer-ID, öffentliche URL, Verkäufer- oder Firmenname, Beschreibung, zugehörige Website und den Zeitstempel der Erfassung in einer festen Ergebnisstruktur.
- Öffentliche ReputationssignaleBehält die von der Quelle gemeldeten Werte rating und feedback_count bei, sofern Amazon sie bereitstellt, ohne fehlende Messwerte zu berechnen oder aufzufüllen.
- Standortkontext des MarktplatzesSpeichert die verfügbaren Felder zu Standortname, Stadt, Region, Land, Breiten- und Längengrad; jeder optionale Standortwert darf null bleiben.
Parameter der Amazon Seller Info API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches, nicht leeres Array öffentlicher Amazon-Verkäuferverweise. Der geparste Hostname muss zu einem unterstützten Marktplatz oder einer Subdomain gehören; jedes Schema mit Hostnamen sowie protokollrelative Verweise werden akzeptiert. Verwenden Sie für diesen Detailabruf Pfade von Verkäuferprofilen. |
So verwenden Sie die Amazon Seller Info API
Senden Sie öffentliche Amazon-Verkäuferprofil-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Verkäuferdatensätze aus dem paginierten Aufgabenergebnis.
- Kopieren Sie eine oder mehrere öffentliche Amazon-Verkäuferprofil-URLs eines unterstützten Marktplatzes.
- Senden Sie das Array urls per POST an /v1/amazon/seller-info und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder fehlschlägt.
- Lesen Sie data.results.items und folgen Sie next_cursor nur, wenn has_more den Wert true hat.
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.itemsAnwendungsfälle der Amazon Seller Info API
- Zuordnung von Verkäuferidentitäten: Lösen Sie eine vorbereitete Liste von Verkäuferprofil-URLs in einheitliche Verkäufer-IDs, Namen, öffentliche URLs, Websites und Marktplatzkontext auf.
- Momentaufnahmen der Reputation: Halten Sie öffentliche Bewertung, Feedback-Gesamtzahl und die Zeit collected_at für einen wiederholbaren Stichtagsvergleich fest, ohne die Werte als Live-Feed zu behandeln.
- Prüfung von Marktplatzlieferanten: Bauen Sie eine Prüfwarteschlange auf, in der öffentliche Verkäuferbeschreibung, Website, Standort und Feedback-Signale mit der Quell-URL des Profils verknüpft bleiben.
Profi-Tipps zur Amazon Seller Info API
- Senden Sie kanonische Verkäuferprofil-Links wie /sp?seller={seller_id}; Produktseiten und Suchseiten erfüllen zwar die Host-Regel, sind aber keine Eingaben für den Verkäuferdetailabruf.
- Senden Sie kein results_limit. Das Backend erzeugt pro URL eine Detaileingabe und begrenzt die gespeicherten Ergebnisse auf die Anzahl der übermittelten nicht leeren URLs.
- Eine akzeptierte URL kann null oder einen Verkäuferdatensatz liefern. Fehlende oder nicht verfügbare Seiten können deshalb dazu führen, dass result_count kleiner ist als die Anzahl der URLs.
- Behandeln Sie rating und feedback_count als von der Quelle gemeldete Momentaufnahmen und nutzen Sie collected_at, wenn Sie wiederholte Erfassungen vergleichen.
- Standortfelder und Website sind optional. Leiten Sie aus einem null-Wert oder einem öffentlichen Profilwert weder rechtliche Präsenz noch Eigentum oder Verifizierung ab.
Verwandte APIs
Ergänzend zur Amazon Seller Info API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Amazon-Daten benötigen.
- Amazon Best Sellers API — Produkte aus URLs öffentlicher Amazon-Bestseller-Kategorien erfassen – mit normalisierten Feldern zu Verkäufer, Preis, Reputation, Verkaufszahl, Medien, Quelle und Zeitstempel.
- Amazon Product Details API — Produktdetails aus bekannten Amazon-URLs erfassen – mit Feldern zu Titel, Beschreibung, Verkäufer, Preis, Sternebewertung, Bewertungsanzahl, Verkaufszahl und Medien.
- Amazon Product Search API — Einen unterstützten Amazon-Storefront per Produktbegriff durchsuchen und, sofern verfügbar, normalisierte Felder zu Produkt, Verkäufer, Preis, Sternebewertung, Bewertungen, Verkaufszahl, Medien und Quelle zurückgeben.
- Amazon Reviews API — Öffentliche Produktbewertungen aus unterstützten Amazon-URLs erfassen – mit Text, Sternebewertungen, Angaben zum Autor, Produktverweisen, Zeitstempeln und Medien.
- Amazon Storefront API — Den Storefront eines Amazon-Creators über seine Shop-URL auslesen – mit Profil, verknüpften Social-Media-Konten, Ideenlisten mit Artikelzahl, kuratierten Posts und Trend-Picks mit Preisen.