Amazon Best Sellers
Amazon Best Sellers sind öffentlich sichtbare Bestsellerlisten je Kategorie, die – sofern verfügbar – Produkttitel, Verkäuferkontext, Preise, Sternebewertungen, Bewertungsanzahlen, Verkaufszahlen, Medien, Quelllinks und Beobachtungszeitpunkte enthalten. SocQ wandelt ausgewählte Listen-URLs in normalisierte Produktdatensätze um, für Kategorierecherchen, Sortimentsvergleiche und wiederholbare Workflows mit Handelsdaten.
Funktionen der Amazon Best Sellers API
- Erfassung per regionaler Kategorie-URLÜbergeben Sie in einer einzigen asynchronen Aufgabe eine oder mehrere öffentliche Best-Sellers- oder Kategorielisten-URLs der unterstützten Amazon-Marktplätze.
- Normalisierte ProduktidentitätErhalten Sie stabile Produktdatensätze mit den verfügbaren IDs, Titeln, Beschreibungen, Quell-URLs, Plattform- und Ressourcenbezeichnungen sowie Zeitstempeln der Erfassung.
- Handels- und ReputationskontextVerfügbare Verkäuferangaben, Preiswerte, Sternebewertungen, Bewertungsanzahlen und Verkaufszahlen liegen in eigenen Feldern vor, sodass Sie kein Seiten-Markup auswerten müssen.
- Produktdatensätze mit MedienNutzen Sie die normalisierten Medienobjekte jedes Produkts für Kataloge, Prüfwarteschlangen, Anreicherungs-Pipelines und die nachgelagerte visuelle Analyse.
Parameter der Amazon Best Sellers API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste von Amazon-Verweisen auf unterstützten Marktplatz-Hosts oder deren Subdomains. Jeder Pfad muss /zgbs/ oder /gp/bestsellers/ enthalten. Jedes Schema mit geparstem Hostnamen sowie protokollrelative Verweise werden akzeptiert. |
results_limit | Optional | Optionale ganze Zahl von 1 bis 2.000. Standardwert ist 100; sie begrenzt die Gesamtzahl der eindeutigen Produktdatensätze, die über alle übergebenen URLs hinweg gespeichert werden. |
So verwenden Sie die Amazon Best Sellers API
Senden Sie bekannte öffentliche Best-Sellers-URLs, überwachen Sie die asynchrone Aufgabe und blättern Sie durch die normalisierten Produktdatensätze.
- Bereiten Sie eine oder mehrere öffentliche Amazon-URLs von Best-Sellers- oder Kategorielisten auf einem unterstützten Marktplatz-Host vor.
- Senden Sie urls und optional results_limit (1 bis 2.000) an /v1/amazon/best-sellers und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
- Lesen Sie data.results.items und fordern Sie next_cursor an, solange has_more den Wert true hat.
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-Books/zgbs/books"],"results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Amazon Best Sellers API
- Momentaufnahmen von Kategoriesortimenten: Machen Sie aus ausgewählten Best-Sellers-Seiten ein begrenztes Produktinventar mit Quelllinks und Erfassungszeiten für einen definierten Recherche-Datensatz.
- Vergleich von Preisen und Reputation: Vergleichen Sie die verfügbaren Preise, Sternebewertungen, Bewertungsanzahlen und Verkaufszahlen der zurückgegebenen Produkte, ohne nachgelagert uneinheitliches Seiten-Markup auszuwerten.
- Anreicherung bei der Produktsuche: Ergänzen Sie Shortlists, die Sie auf Kategorieseiten gefunden haben, um Titel, Verkäuferkontext, Beschreibungen, Medien und öffentliche Produkt-URLs.
Profi-Tipps zur Amazon Best Sellers API
- Verwenden Sie Verweise auf unterstützte regionale Amazon-Hosts, deren Pfade /zgbs/ oder /gp/bestsellers/ enthalten. Andere Amazon-Pfade werden abgelehnt, bevor die Aufgabe angelegt wird.
- Legen Sie results_limit für die gesamte Aufgabe fest, nicht für jede einzelne URL, und bemessen Sie den Wert nach dem gesamten Stapel, den Sie benötigen.
- Folgen Sie next_cursor, bis has_more den Wert false hat, denn die Aufgabenergebnisse werden über eine eigene, per Cursor paginierte Ergebnisansicht ausgeliefert.
- Behandeln Sie IDs, Beschreibungen, Verkäuferdaten, Preise, Sternebewertungen, Zahlen, Medien, URLs und Veröffentlichungszeiten als nullable und ersetzen Sie fehlende Werte nicht durch null oder ein leeres Objekt.
- Speichern Sie collected_at mit jedem Datensatz und planen Sie getrennte Läufe, wenn Sie Stichtagsvergleiche brauchen; der Endpunkt erzeugt keinen kontinuierlichen Feed.
Verwandte APIs
Ergänzend zur Amazon Best Sellers API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Amazon-Daten benötigen.
- 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 Seller Info API — Öffentliche Amazon-Verkäuferprofile aus bekannten Verkäufer-URLs erfassen – mit Identität, Beschreibung, Website, Bewertung, Feedback, Standort, Quelle und Erfassungszeit.
- 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.