Zum Hauptinhalt springen
Durchsuchen Sie die Produkte eines Shops und erhalten Sie die gerankte Liste als JSON über die asynchrone Task-API. Wählen Sie den Shop mit site; alle Shops liefern dieselben Produktfelder. Eine abgeschlossene Suche kostet 3 Credits.

Anfrage

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. Der zu durchsuchende Shop aus der Tabelle unten.
  • query: Suchbegriff mit 1 bis 500 Zeichen. Erforderlich, wenn Sie kein url senden.
  • url: Eine Listenseite, die statt einer Suche gelesen wird. Senden Sie query oder url, nicht beides. Mit site qoo10 eine Qoo10-Shopseite wie https://www.qoo10.jp/shop/LG-BEAUTY; ihr Query-String wird verworfen.
  • country: Optional. Standard ist das Land des Shops. Jedes andere Land wird mit 422 REGION_UNSUPPORTED abgelehnt.
  • limit: Optionale Ganzzahl von 1 bis 40, Standard 20. Mit url von 1 bis 200, Standard 200.
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.
  • Eine Aufgabe mit url liefert statt query die gelesene Listenseite als url. products enthält jedes Produkt der Seite in Seitenreihenfolge bis limit, jedes nur einmal. Eine Qoo10-Shopseite zeigt die Produkte, die der Verkäufer in den Bereichen des Shops platziert; price ist der Preis, den die jeweilige Karte zeigt, mit dem Shop-Gutschein, wenn die Karte ihn anwendet.
  • Jedes Produkt enthält rank, productId, title und url. productId ist die shopeigene Produkt-ID, etwa die ASIN bei Amazon, die Artikelnummer bei eBay oder shop:item bei Rakuten. rank folgt der Standardsortierung des Shops. Außer bei Coupang überspringt es Einträge, die der Shop als gesponsert kennzeichnet.
  • price, rating, reviewCount, imageUrl und brand erscheinen, wenn die Ergebnisseite sie zeigt. price ist eine Zahl in der currency (ISO 4217) des jeweiligen Produkts: Eine Amazon-Suche kann mehrere Währungen zeigen. Haben Größen unterschiedliche Preise, ist price der niedrigste. Target-Preise sind die des Standard-Onlineshops von Target. AliExpress-Preise sind die Verkaufspreise, die ein nicht angemeldeter Käufer in den USA sieht.
  • rating nutzt eine Fünf-Sterne-Skala. Kurly und Zalando zeigen keine Bewertungen, AliExpress zeigt Sterne ohne Anzahl der Bewertungen, und abgekürzte Zahlen wie 999+ entfallen. brand liefern Target, Sephora, Ulta, Olive Young, Lotte ON, Musinsa, Yahoo! Shopping, Qoo10, Flipkart, Myntra, Nykaa und Zalando, die die Marke getrennt vom Titel zeigen.
  • Bei google_shopping ist productId die Produkt-ID von Google oder die Angebots-ID, wenn Google das Angebot keinem Produkt zugeordnet hat. Googles Seite verlinkt weder Produkt- noch Händlerseiten, daher ist url die Google-Shopping-Ergebnisseite, auf der das Produkt gelistet ist, mit #product={productId}&title={title} am Ende. Übergeben Sie diese url an Commerce Product, um Shops, Spezifikationen und Beschreibung des Produkts zu lesen. seller ist der Shop, den Google zuerst nennt, und reviewCount erscheint nur, wenn Google die genaue Zahl zeigt (unter 1.000).
  • Jede Suche liefert Produkte von der ersten Ergebnisseite des Shops. Diese Seite zeigt bei Yahoo! Shopping bis zu 30 Produkte, bei Myntra 32 und bei Zalando 24. Bei Flipkart hat sie 40 Plätze und bei Nykaa 20, gesponserte Einträge eingeschlossen.
  • Leitet ein Shop die Suche auf eine andere Seite um, stammen die Produkte von dieser Seite: Ulta leitet manche Markennamen auf die Markenseite um, Target manche Suchen auf eine verwandte Suche, und Nykaa zeigt für Suchen nach einer Kategorie die Kategorieseite.
  • Eine Suche ohne Produkte endet als fehlgeschlagener Task. Abgerechnet wird pro abgeschlossener Suche.

Siehe auch