Zum Hauptinhalt springen
Durchsuchen Sie den Shop Zalando (zalando.de) und lesen Sie seine Produktseiten über die asynchrone Task-API. Senden Sie COMMERCE_SERP mit site zalando, 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. zalando.
  • query: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
  • limit: Optionale Ganzzahl von 1 bis 40, Standard 20.
  • country: Optional. Standard ist DE, 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, 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.
  • Zalando zeigt weder Bewertungen noch Bewertungsanzahlen.
  • Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops, die bis zu 24 Produkte zeigt.

Produktseite

Parameter

  • url: Erforderlich. Eine Produktseite im Shop Zalando, höchstens 2.048 Zeichen: zalando.de/{name}-{sku}.html. Produkt-url aus einer Suche funktionieren unverändert. Parameter ohne Einfluss auf das Ergebnis, etwa Tracking-Codes, werden vor dem Lesen entfernt.
  • country: Optional. Standard ist DE, 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, images, description, options und categories 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.
  • 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. description ist die kurze Zusammenfassung, die der Shop für Suchmaschinen veröffentlicht.
  • 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.

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