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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche 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_limit | Optional | Maximale 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.
- Bereiten Sie eine oder mehrere unterstützte Amazon-Produkt-URLs vor und wählen Sie ein results_limit von 1 bis 2.000.
- Senden Sie die Anfrage per POST an /v1/amazon/reviews und speichern Sie die zurückgegebene task_id.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen ist oder einen Fehler meldet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.