amazon/
reviews

Öffentliche Amazon-Produktbewertungen aus unterstützten URLs erfassen – mit Texten, Sternebewertungen, Angaben zu Autoren, Produktverweisen, Zeitstempeln und Medien als normalisierte Datensätze.

Amazon Reviews API

Mehrere Produkt-URLs
Bewertungstexte und Sternebewertungen
Autoren- und Produktkontext
Normalisierte Bewertungsdatensätze
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 Reviews

Amazon-Produktbewertungen sind öffentliche Kundenrückmeldungen mit Bewertungstext, Sternebewertungen, Angaben zu den Autoren, Veröffentlichungszeiten, Produktverweisen und angehängten Medien. Diese Datensätze unterstützen die Recherche zu Produktfeedback, den Vergleich von Sternebewertungen, die Beobachtung von Bewertungen und die Anreicherung von Daten mit Quellverweisen.

Funktionen der Amazon Reviews API

  • Eingabe mehrerer Produkt-URLsÜbergeben Sie in einer einzigen Aufgabe eine oder mehrere unterstützte Amazon-Produkt-URLs und wenden Sie ein gemeinsames Ergebnislimit auf die gespeicherten normalisierten Bewertungen an.
  • Bewertungsinhalte und AutorenJeder Datensatz kann den öffentlichen Bewertungstext, die numerische Sternebewertung, die Identität des Autors, die Veröffentlichungszeit sowie angehängte Bilder oder Videos enthalten.
  • Datensätze mit ProduktbezugNormalisierte Ergebnisse enthalten neben Bewertungsidentität und Quelllinks auch Produktkennungen und Produkt-URLs, sodass jeder Datensatz dem bewerteten Artikel zugeordnet bleibt.

Parameter der Amazon Reviews API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche Liste nicht leerer Amazon-Produktverweise. Der geparste Hostname jedes Eintrags muss zu einem unterstützten Marktplatz oder einer Subdomain gehören; jedes Schema mit Hostnamen sowie protokollrelative Verweise werden akzeptiert. Jeder Eintrag wird zu einer Eingabezeile für den Anbieter.
results_limitOptionalMaximale Anzahl normalisierter Bewertungen, die für die gesamte Aufgabe gespeichert werden; Standardwert ist 100, erlaubt sind ganze Zahlen von 1 bis 2.000.

So verwenden Sie die Amazon Reviews API

Senden Sie unterstützte Produkt-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Bewertungsdatensätze per Cursor-Paginierung aus.

  1. Bereiten Sie eine oder mehrere unterstützte Amazon-Produkt-URLs vor und wählen Sie ein results_limit von 1 bis 2.000.
  2. Senden Sie die Anfrage per POST an /v1/amazon/reviews und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie GET /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
  4. Lesen Sie data.results.items und fordern Sie den zurückgegebenen next_cursor an, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"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 Reviews API

  • Recherche zu Produktfeedback: Werten Sie Bewertungstexte, Sternebewertungen, Autoren und Veröffentlichungszeiten aus, um das öffentliche Feedback zu bekannten Produkten zu untersuchen.
  • Produktübergreifender Vergleich von Sternebewertungen: Senden Sie mehrere Produkt-URLs und gruppieren Sie die zurückgegebenen Sternebewertungen nach subject_id oder subject_url, um die erfassten Bewertungsdatensätze zu vergleichen.
  • Anreicherung mit Bewertungsbelegen: Ergänzen Sie bestehende Produktdatensätze oder Beobachtungsdaten um Quelllinks, Produktverweise, Angaben zu Autoren, Zeitstempel und Bewertungsmedien.

Profi-Tipps zur Amazon Reviews API

  • Verwenden Sie Produktverweise, deren geparster Hostname zu einem unterstützten Amazon-Marktplatz gehört; verkürzte Links auf fremden Hosts und nicht unterstützte regionale Hosts bestehen die Validierung nicht.
  • Legen Sie results_limit auf die Gesamtzahl der Bewertungen fest, die Sie über alle übermittelten URLs hinweg speichern möchten, und folgen Sie next_cursor, bis has_more den Wert false hat, um jede gespeicherte Seite zu lesen.
  • Verwenden Sie die id der Bewertung als Schlüssel für Datensätze, sofern vorhanden, und behalten Sie subject_id oder subject_url, wenn Sie Bewertungen nach Produkt gruppieren.
  • Behandeln Sie fehlende Texte, Autorenfelder, Sternebewertungen, Zeitstempel, Produktverweise und Medien als unbekannt, statt Ersatzwerte zu erfinden.

Ergänzend zur Amazon Reviews 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 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 Reviews API — FAQ

Amazon Reviews API ist eine Schnittstelle, die öffentliche Produktbewertungen aus unterstützten Amazon-Produkt-URLs erfasst. Sie liefert normalisierte Bewertungstexte, Sternebewertungen, Angaben zu Autoren, Zeitstempel, Produktverweise, Quelllinks und Medien.

Senden Sie ein nicht leeres Array urls, dessen geparste Hostnamen amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp oder deren Subdomains sind. Jedes Schema mit Hostnamen sowie protokollrelative Verweise werden akzeptiert.

results_limit ist die maximale Anzahl normalisierter Bewertungen, die für die gesamte Aufgabe gespeichert werden, und keine garantierte Anzahl pro URL. Die Aufgabe kann mit weniger Datensätzen enden, wenn weniger öffentliche Bewertungen zurückkommen oder doppelte Datensätze entfernt werden.

Lesen Sie nach dem Erfolg der Aufgabe data.results.items und übergeben Sie next_cursor an den Aufgaben-Endpunkt, solange has_more den Wert true hat. Der Endpunkt für Aufgabenergebnisse akzeptiert ein Seitenlimit von 1 bis 500.

Jede erfolgreich gespeicherte Bewertung kostet 0,15 SocQ-Credits. Die Anfrage wird anhand von results_limit reserviert und danach gegen die tatsächliche Ergebnisanzahl abgerechnet; ein leeres Ergebnis verursacht keine Ergebnisgebühr.