amazon/
best-sellers

Produkte aus öffentlichen Amazon-Best-Sellers-URLs erfassen – mit Titeln, Verkäuferkontext, Preisen, sichtbaren Reputationssignalen und Medien als normalisierte Datensätze.

Amazon Best Sellers API

Eingabe per Kategorie-URL
Produktdatensätze
0,15 Credits pro Ergebnis
0,15 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche 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_limitOptionalOptionale 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.

  1. Bereiten Sie eine oder mehrere öffentliche Amazon-URLs von Best-Sellers- oder Kategorielisten auf einem unterstützten Marktplatz-Host vor.
  2. Senden Sie urls und optional results_limit (1 bis 2.000) an /v1/amazon/best-sellers und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
  4. 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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie Amazon-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Amazon Best Sellers API — FAQ

Amazon Best Sellers API ist eine Schnittstelle, die Produkte aus öffentlichen Amazon-Best-Sellers- oder Kategorielisten-URLs als normalisierte SocQ-Produktdatensätze erfasst.

Das Array urls akzeptiert Verweise, deren geparster Hostname ein unterstützter Amazon-Marktplatz oder eine Subdomain davon ist und deren Pfad /zgbs/ oder /gp/bestsellers/ enthält. Jedes Schema mit Hostnamen sowie protokollrelative Verweise werden akzeptiert.

Ein Rangfeld gehört nicht zur stabilen Produktantwort. Der normalisierte Datensatz konzentriert sich auf Produktidentität, Inhalt, Verkäufer, Preis, Sternebewertung, Bewertungs- und Verkaufszahlen, Medien, URLs und Zeitstempel, sofern verfügbar.

results_limit hat den Standardwert 100, akzeptiert ganze Zahlen von 1 bis 2.000 und begrenzt die Gesamtzahl der eindeutigen Datensätze, die für die Aufgabe über alle Eingabe-URLs hinweg gespeichert werden. Es ist kein separates Kontingent pro URL.

Fragen Sie /v1/tasks/{task_id} ab, lesen Sie nach dem Erfolg data.results.items und fordern Sie den zurückgegebenen next_cursor so lange an, wie has_more den Wert true hat. Das Limit pro Ergebnisseite steuert die Paginierung beim Abruf, nicht die Menge der Erfassung.

Öffentliche Verfügbarkeit, Seiteninhalt, die Ausgabe des Anbieters, Normalisierung, Deduplizierung und das aufgabenweite results_limit können die endgültige Anzahl der Ergebnisse verringern. Eine erfolgreiche Aufgabe kann auch ganz ohne Produktdatensätze bleiben.

Jeder erfolgreich zurückgegebene Standard-Produktdatensatz kostet 0,15 SocQ-Credits. Die Aufgabe reserviert Credits anhand von results_limit (oder 100, wenn der Parameter fehlt), rechnet dann gegen die tatsächlich zurückgegebene Anzahl ab und erstattet nicht genutzte reservierte Credits; ein leeres Ergebnis verursacht keine Ergebnisgebühr.