Amazon Product Details
Amazon-Produkte sind öffentliche Katalogartikel, die durch Kennungen, Titel, Beschreibungen, Verkäuferkontext, Preise, Sternebewertungen, Bewertungsanzahlen, Verkaufszahlen und Medien beschrieben werden. Diese Felder unterstützen Kataloganreicherung, Artikelvergleiche, Quellenprüfung und stichtagsbezogene Produktberichte.
Funktionen der Amazon Product Details API
- Stapelabfrage per bekannter Produkt-URLÜbergeben Sie in einer einzigen Aufgabe eine oder mehrere Amazon-URLs und erhalten Sie höchstens so viele normalisierte Produktdatensätze, wie gültige URLs übermittelt wurden.
- Produktidentität, Text und MedienJeder Datensatz kann die Produktkennung und URL, den Titel, die Beschreibung, den Zeitstempel der Erfassung sowie verfügbare Bild- oder Videoverweise enthalten.
- Verkäufer, Preis und sichtbare ProduktsignaleVerschachtelte Verkäufer- und Preisobjekte stehen neben Sternebewertung, Bewertungsanzahl und gemeldeter Verkaufszahl, damit sich die Felder einheitlich weiterverarbeiten lassen.
- Unterstützte Amazon-Marktplatz-HostsDie URL-Validierung akzeptiert Amazon-Hosts für die USA, das Vereinigte Königreich, Deutschland, Frankreich, Spanien, Italien, Kanada, Australien, Indien und Japan, einschließlich ihrer Subdomains.
Parameter der Amazon Product Details API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches, nicht leeres Array bekannter Amazon-Produktverweise. Der geparste Hostname muss amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp oder eine Subdomain davon sein. Jedes Schema mit Hostnamen sowie protokollrelative Verweise werden akzeptiert. |
So verwenden Sie die Amazon Product Details API
Senden Sie bekannte Produkt-URLs, speichern Sie die ID der asynchronen Aufgabe und lesen Sie die normalisierten Produktdatensätze, sobald die Aufgabe erfolgreich war.
- Senden Sie ein Array urls per POST an /v1/amazon/product-detail, mit einem Bearer-Token oder API-Schlüssel.
- Speichern Sie die zurückgegebene task_id und fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- Lesen Sie nach einem Erfolg data.results.items; ist has_more true, fordern Sie mit next_cursor die nächste Ergebnisseite an, ohne eine weitere Produktaufgabe zu senden.
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueAnwendungsfälle der Amazon Product Details API
- Kataloganreicherung für bekannte Artikel: Ergänzen Sie einen bestehenden Satz von Amazon-URLs um Produkttitel, Beschreibungen, Verkäuferkontext, Preise, Medien, Sternebewertungen und Zahlen.
- Produktvergleich zu einem Stichtag: Vergleichen Sie normalisierte Felder zu Preis, Währung, Sternebewertung, Bewertungsanzahl, Verkaufszahl und Verkäufer über ausgewählte Produktdatensätze hinweg, die zum selben Zeitpunkt erfasst wurden.
- Prüfung der Produktquellen: Gleichen Sie gespeicherte Katalogverweise mithilfe von Kennungen, kanonischen URLs, Titeln, Beschreibungen, Medienverweisen und Erfassungszeitstempeln mit den öffentlichen Produktseiten ab.
Profi-Tipps zur Amazon Product Details API
- Verwenden Sie Produktverweise, deren geparster Hostname zu einem unterstützten Amazon-Marktplatz gehört; ein gültiger Host allein garantiert nicht, dass das Ziel auf einen öffentlichen Produktdatensatz führt.
- Senden Sie kein results_limit, denn dieser Endpunkt setzt das Ergebnislimit des Anbieters fest auf die Anzahl der übermittelten URLs.
- Behandeln Sie die Felder zu Verkäufer, Preis, Sternebewertung, Bewertungsanzahl, Verkaufszahl, Medien, URL und Veröffentlichungszeit als nullable und behalten Sie eine erfolgreiche Aufgabe mit null Elementen bei, statt Platzhalterdaten zu erzeugen.
- Nutzen Sie next_cursor nur zum Blättern in gespeicherten Aufgabenergebnissen; setzen Sie die GET-Anfragen für dieselbe Aufgabe fort, statt den kostenpflichtigen POST zu wiederholen.
Verwandte APIs
Ergänzend zur Amazon Product Details 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 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.