Zum Hauptinhalt springen
Durchsuchen Sie den Shop Amazon (amazon.com) und lesen Sie seine Produktseiten über die asynchrone Task-API. Senden Sie COMMERCE_SERP mit site amazon, um die Produkte einer Suche in der Reihenfolge des Shops zu erhalten, oder COMMERCE_PRODUCT mit der url eines Produkts, um dieses Produkt zu lesen. Eine abgeschlossene Suche oder Produktseite kostet 1 Credit.

Suche

Senden Sie den Task und fragen Sie dann GET /v1/async/task/{id} ab oder empfangen Sie den Webhook. Siehe Asynchrone Tasks.

Parameter

  • site: Erforderlich. amazon.
  • query: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
  • limit: Optionale Ganzzahl von 1 bis 40, Standard 20.
  • country: Optional. Standard ist US, das Land des Shops. Jedes andere Land wird mit 422 REGION_UNSUPPORTED abgelehnt.
Nur die oben aufgeführten Payload-Felder werden akzeptiert. Lassen Sie include weg: Auch include: {} führt vor der Credit-Reservierung zu 422 VALIDATION_ERROR für payload.include.

Antwortbeispiel

Ergebnisfelder

  • site, query und country geben die Anfrage wieder. returnedCount ist die Anzahl der Einträge in products.
  • Jedes Produkt enthält rank, productId, title und url. productId ist die ASIN. rank folgt der Standardreihenfolge des Shops, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen.
  • price, rating, reviewCount und imageUrl erscheinen, wenn die Ergebnisseite sie zeigt. price ist eine Zahl in der currency des Produkts (ISO 4217); haben Größen eigene Preise, ist es der niedrigste. Eine Amazon-Suche kann mehr als eine Währung enthalten.
  • rating nutzt eine Fünf-Punkte-Skala. Abgekürzte Bewertungszahlen wie 999+ werden ausgelassen.
  • Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops.

Produktseite

Parameter

  • url: Erforderlich. Eine Produktseite im Shop Amazon, höchstens 2.048 Zeichen: amazon.com/dp/{ASIN} oder amazon.co.jp/dp/{ASIN}. Produkt-url aus einer Suche funktionieren unverändert. Parameter ohne Einfluss auf das Ergebnis, etwa Tracking-Codes, werden vor dem Lesen entfernt. Andere Adressen derselben Seite funktionieren ebenfalls, etwa /gp/product/{ASIN}.
  • country: Optional. Standard ist das Land der Seite: US auf amazon.com und JP auf amazon.co.jp. Jedes andere Land wird mit 422 REGION_UNSUPPORTED abgelehnt.
Nur die oben aufgeführten Payload-Felder werden akzeptiert. Lassen Sie include weg: Auch include: {} führt vor der Credit-Reservierung zu 422 VALIDATION_ERROR für payload.include.

Antwortbeispiel

Ergebnisfelder

  • site, country, url und productId kennzeichnen die Seite. url ist die gelesene Seite, und productId entspricht der ID aus einer Suche.
  • title ist immer vorhanden. brand, price, listPrice, currency, inStock, seller, rating, reviewCount, images, description, descriptionImages, specs, options, categories und gtin erscheinen, wenn die Seite sie zeigt.
  • price ist, was ein Käufer laut der Seite beim Öffnen zahlt, vor Gutscheinen und Versand, in currency (ISO 4217). listPrice ist der reguläre Preis, den die Seite durchstreicht, vorhanden, wenn er über price liegt. inStock ist die Verfügbarkeit des Produkts. seller ist der Händler, der es verkauft. Seiten auf amazon.co.jp liefern country JP und Preise in JPY. Wählt Amazon für ein Produkt kein hervorgehobenes Angebot, zeigt die Seite keinen Preis; price, currency, seller und inStock stammen dann vom ersten Verkäufer mit Preis in der Angebotsliste des Produkts.
  • rating nutzt eine Fünf-Punkte-Skala mit zwei Nachkommastellen. reviewCount ist die Anzahl der Bewertungen.
  • images listet bis zu 30 Fotos aus der Produktgalerie in Seitenreihenfolge.
  • description ist reiner Text mit einer Zeile pro Absatz, bis zu 10.000 Zeichen; Text, der nur in Bildern steht, ist nicht enthalten.
  • descriptionImages listet bis zu 300 Bilder aus der Produktbeschreibung in Seitenreihenfolge. Banner und Hinweise, die Verkäufer in ihre Beschreibung setzen, sind dabei, und Text in den Bildern wird nicht gelesen.
  • specs listet bis zu 100 Paare { name, value } aus den Produktdetails. options listet bis zu 20 Auswahlmöglichkeiten wie Größe oder Farbe, jede mit bis zu 100 values; die übrigen Felder beschreiben die Auswahl, mit der die Seite öffnet. categories reicht von der breitesten bis zur engsten Kategorie, bis zu 10 Ebenen. gtin ist die UPC, EAN oder JAN, die die Seite angibt.

Fehler und Abrechnung

  • Eine Suche ohne Produkte endet als fehlgeschlagener Task.
  • Eine Produktseite, die der Shop mit 404 oder 410 beantwortet, etwa ein entferntes Produkt, beendet den Task mit PAGE_UNAVAILABLE, und die Meldung enthält die Antwort des Shops. Lehnt der Shop den Lesevorgang mit 403, 412, 429 oder 435 ab, wartet der Task und fragt bis zu 6 Minuten lang erneut. Andere fehlgeschlagene Lesevorgänge und eine länger andauernde Ablehnung enden mit ENGINE_NO_RESULT.
  • Abgerechnet werden nur abgeschlossene Tasks: 1 Credit pro Suche oder Produktseite.

Siehe auch