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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderliches, nicht leeres Produkt-Keyword oder -Suchbegriff. |
domain | Erforderlich | Erforderlicher 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_limit | Optional | Gewü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.
- 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.
- Senden Sie die Anfrage per POST an /v1/amazon/product-search und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe den Status succeeded oder failed erreicht.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.