Zum Hauptinhalt springen
Durchsuchen Sie den Shop Yahoo! Shopping (shopping.yahoo.co.jp) und lesen Sie seine Produktseiten über die asynchrone Task-API. Senden Sie COMMERCE_SERP mit site yahoo_shopping, 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 0.5 Credits.

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. yahoo_shopping.
  • query: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
  • limit: Optionale Ganzzahl von 1 bis 40, Standard 20.
  • country: Optional. Standard ist JP, 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 eigene Produkt-ID des Shops. rank folgt der Standardreihenfolge des Shops, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen.
  • price, rating, reviewCount, imageUrl und brand 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.
  • rating nutzt eine Fünf-Punkte-Skala. Abgekürzte Bewertungszahlen wie 999+ werden ausgelassen.
  • Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops, die bis zu 30 Produkte zeigt.

Produktseite

Parameter

  • url: Erforderlich. Eine Produktseite im Shop Yahoo! Shopping, höchstens 2.048 Zeichen: store.shopping.yahoo.co.jp/{store}/{item}.html. Produkt-url aus einer Suche funktionieren unverändert. Parameter ohne Einfluss auf das Ergebnis, etwa Tracking-Codes, werden vor dem Lesen entfernt. LOHACO-Seiten auf lohaco.yahoo.co.jp werden nicht gelesen.
  • country: Optional. Standard ist JP, das Land der Seite. 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, currency, inStock, rating, reviewCount, images, description, descriptionImages, 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). inStock ist die Verfügbarkeit 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. Banner oder Hinweise, die der Verkäufer in diese Galerie setzt, sind dabei.
  • 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.
  • 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: 0.5 Credits pro Suche oder Produktseite.

Siehe auch