Zum Hauptinhalt springen
Durchsuchen Sie den Shop Flipkart (flipkart.com) und lesen Sie seine Produktseiten über die asynchrone Task-API. Senden Sie COMMERCE_SERP mit site flipkart, 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. flipkart.
  • query: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.
  • limit: Optionale Ganzzahl von 1 bis 40, Standard 20.
  • country: Optional. Standard ist IN, 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 40 Plätze hat, gesponserte Einträge eingeschlossen.

Produktseite

Parameter

  • url: Erforderlich. Eine Produktseite im Shop Flipkart, höchstens 2.048 Zeichen: flipkart.com/{name}/p/{itm}?pid={pid}. 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 IN, 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 und description 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.
  • 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.

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