amazon/
product-search

Einen unterstützten Amazon-Storefront per Produktbegriff durchsuchen und normalisierte Felder zu Produkt, Verkäufer, Preis, Sternebewertung, Bewertungen, Verkaufszahl und Medien erhalten.

Amazon Product Search API

Produktsuche
Bezogen auf einen Storefront
Normalisierte Datensä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 Search

Amazon Product Search wandelt einen Produktbegriff und eine Storefront-URL in normalisierte öffentliche Produktdatensätze um. Jeder Eintrag kann – sofern verfügbar – Quell-URL, Titel, Beschreibung, Verkäufer, Preis, Sternebewertung, Bewertungsanzahl, Verkaufszahl, Medien, Veröffentlichungszeit und Erfassungszeit enthalten.

Funktionen der Amazon Product Search API

  • Abfragen pro StorefrontKombinieren Sie einen nicht leeren Produktbegriff mit genau einer unterstützten Amazon-Domain, damit der gewünschte Storefront eindeutig festgelegt ist.
  • Steuerbare ErgebnismengeLegen Sie ein results_limit als ganze Zahl von 1 bis 2.000 fest; der Collector stoppt am angeforderten Limit oder wenn keine weiteren Quelldatensätze verfügbar sind.
  • Normalisierte ProduktidentitätErhalten Sie stabile Produktfelder für ID, Typ, Quell-URL, Titel, Beschreibung, Veröffentlichungszeit und Erfassungszeit.
  • HandelskontextNutzen Sie die verfügbaren Felder zu Verkäufer, Preis, Sternebewertung, Bewertungsanzahl, Verkaufszahl und Medien, ohne storefrontspezifische Ergebnisformen auswerten zu müssen.

Parameter der Amazon Product Search API

ParameterErforderlichBeschreibung
queryErforderlichErforderliches, nicht leeres Produkt-Keyword oder -Suchbegriff.
domainErforderlichErforderlicher Verweis auf einen Amazon-Storefront. 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.
results_limitOptionalGewünschtes Ergebnislimit von 1 bis 2.000. Ohne Angabe gilt der Standardwert 100.

So verwenden Sie die Amazon Product Search API

Wählen Sie den gewünschten Storefront und einen konkreten Produktbegriff und senden Sie dann eine asynchrone Anfrage.

  1. Legen Sie einen nicht leeren query fest, geben Sie die URL einer unterstützten Amazon-Domain an und wählen Sie ein results_limit von 1 bis 2.000.
  2. Senden Sie die Anfrage per POST an /v1/amazon/product-search und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe den Status succeeded oder failed erreicht.
  4. Lesen Sie nach einem Erfolg data.results.items und übergeben Sie next_cursor, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/amazon/product-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"wireless earbuds","domain":"https://www.amazon.com","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 Product Search API

  • Produktentdeckung im Storefront: Finden Sie öffentliche Produkte, die zu einer Kategorie, einem Merkmal, einer Marke oder einem kaufnahen Suchbegriff passen, in einem unterstützten Amazon-Storefront.
  • Angebotsvergleich: Vergleichen Sie die verfügbaren Preisbeträge, Währungen, formatierten Preise und Verkäuferidentitäten über die zurückgegebenen Produkte hinweg.
  • Prüfung der Reputation: Sehen Sie sich die verfügbaren Sternebewertungen, Bewertungsanzahlen und Verkaufszahlen an und behalten Sie fehlende Signale als nicht verfügbar bei.
  • Kataloganreicherung: Reichern Sie Produktkandidaten mit normalisierten Titeln, Beschreibungen, Quell-URLs, Medien, Verkäufern und Erfassungszeitstempeln an.

Profi-Tipps zur Amazon Product Search API

  • Speichern Sie den gesendeten query und die domain zu jeder Aufgabe, denn derselbe Suchbegriff kann je nach Storefront unterschiedliche Ergebnisse liefern.
  • Wählen Sie results_limit passend zur benötigten Menge: Der Wert bestimmt die reservierte Ergebnisschätzung, während die endgültige Abrechnung gegen die zurückgegebenen Datensätze erfolgt.
  • Folgen Sie next_cursor, bis has_more den Wert false hat, wenn eine erfolgreiche Aufgabe mehr als eine gespeicherte Ergebnisseite enthält.
  • Behandeln Sie fehlende Werte zu Verkäufer, Preis, Sternebewertung, Bewertungsanzahl, Verkaufszahl oder Medien als nicht verfügbar und nicht als null oder leere Identität.

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

Amazon Product Search API durchsucht einen unterstützten Amazon-Storefront anhand eines Produktbegriffs und liefert normalisierte öffentliche Produktdatensätze über einen asynchronen Aufgaben-Workflow.

Die Laufzeit prüft den geparsten Hostnamen und akzeptiert amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in und amazon.co.jp, einschließlich Subdomains. Jedes Schema mit Hostnamen sowie protokollrelative Verweise werden akzeptiert.

query und domain sind erforderliche, nicht leere Zeichenfolgen. results_limit ist optional, hat den Standardwert 100 und muss eine ganze Zahl von 1 bis 2.000 sein.

Ein Produkt kann ID, Plattform, Ressource, Typ, Quell-URL, Veröffentlichungs- und Erfassungszeit, Titel, Beschreibung, Verkäufer, Preis, Sternebewertung, Bewertungsanzahl, Verkaufszahl und Medien enthalten. Nullable Felder sind nur vorhanden, wenn die Quelle verwertbare Werte liefert.

results_limit ist ein Höchstwert. Die Erfassung kann früher enden, wenn die öffentliche Quelle keine weiteren passenden Datensätze mehr hat; eine erfolgreiche Aufgabe kann daher weniger oder auch gar keine Produkte enthalten.

Fragen Sie /v1/tasks/{task_id} ab, lesen Sie nach dem Erfolg data.results.items und fordern Sie mit next_cursor die nächste Ergebnisseite der Aufgabe an, solange has_more den Wert true hat.

Jedes erfolgreich zurückgegebene normalisierte Produkt kostet 0,15 SocQ-Credits. Die Anfrage reserviert Credits anhand von results_limit (oder 100, wenn der Parameter fehlt), rechnet dann gegen die tatsächliche Ergebnisanzahl ab und erstattet nicht genutzte Credits; ein leeres Ergebnis verursacht keine Ergebnisgebühr.