amazon/
product-detail

Öffentliche Amazon-Produktdetails zu bekannten URLs erfassen – mit Titeln, Beschreibungen, Verkäufern, Preisen, Sternebewertungen, Bewertungs- und Verkaufszahlen sowie Medien als normalisierte Datensätze.

Amazon Product Details API

Bekannte Produkt-URLs
Eingabe für mehrere Marktplätze
Normalisierte Produktdatensä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 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

ParameterErforderlichBeschreibung
urlsErforderlichErforderliches, 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.

  1. Senden Sie ein Array urls per POST an /v1/amazon/product-detail, mit einem Bearer-Token oder API-Schlüssel.
  2. Speichern Sie die zurückgegebene task_id und fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
  3. 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 true

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

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.

Weitere Plattformen entdecken

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

Amazon Product Details API — FAQ

Amazon Product Details API ist eine Schnittstelle, die öffentliche Produktdetails aus bekannten Amazon-Verweisen erfasst. Sie liefert normalisierte Kennungen, Titel, Beschreibungen, Verkäufer- und Preisobjekte, Sternebewertungen, Bewertungs- und Verkaufszahlen, Medien sowie Metadaten der Erfassung.

Übergeben Sie ein nicht leeres Array urls mit Amazon-Produkt-URLs. Die Laufzeit akzeptiert Amazon-Hosts für die USA, das Vereinigte Königreich, Deutschland, Frankreich, Spanien, Italien, Kanada, Australien, Indien und Japan, einschließlich Subdomains.

Ja. Fügen Sie dem Array urls mehrere bekannte URLs hinzu. Das Ergebnislimit des Anbieters entspricht der Anzahl der übermittelten URLs; ungültige, nicht verfügbare oder fehlerhafte Zeilen können die Zahl der erfolgreichen Ergebnisse verringern.

Das stabile Produktschema umfasst Identitäts- und Quellfelder, Titel, Beschreibung, verschachtelte Verkäufer- und Preisobjekte, Sternebewertung, Bewertungsanzahl, gemeldete Verkaufszahl, Medien und Zeitstempel. Optionale Quellwerte bleiben null, wenn sie nicht verfügbar sind.

Die Paginierung gilt beim Lesen der gespeicherten Ergebnisse nach dem Erfolg der Aufgabe, nicht beim Senden der Produkt-URLs. Folgen Sie next_cursor mit GET /v1/tasks/{task_id} nur, solange has_more den Wert true hat.

Die Anfrage reserviert eine Schätzung von 0,15 Credits pro übermittelter URL und rechnet mit 0,15 Credits pro erfolgreich zurückgegebenem Produktdatensatz ab. Bei einer Grundgebühr von null Credits und einer Regel für leere Ergebnisse, die nur die Grundgebühr berechnet, wird eine Aufgabe ohne zurückgegebene Datensätze mit null abgerechnet.