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
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 istIN, das Land des Shops. Jedes andere Land wird mit422 REGION_UNSUPPORTEDabgelehnt.
include weg: Auch include: {} führt vor der Credit-Reservierung zu 422 VALIDATION_ERROR für payload.include.
Antwortbeispiel
Ergebnisfelder
site,queryundcountrygeben die Anfrage wieder.returnedCountist die Anzahl der Einträge inproducts.- Jedes Produkt enthält
rank,productId,titleundurl.productIdist die eigene Produkt-ID des Shops.rankfolgt der Standardreihenfolge des Shops, und Einträge, die der Shop als gesponsert kennzeichnet, werden ausgelassen. price,rating,reviewCount,imageUrlundbranderscheinen, wenn die Ergebnisseite sie zeigt.priceist eine Zahl in dercurrencydes Produkts (ISO 4217); haben Größen eigene Preise, ist es der niedrigste.ratingnutzt 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-urlaus einer Suche funktionieren unverändert. Parameter ohne Einfluss auf das Ergebnis, etwa Tracking-Codes, werden vor dem Lesen entfernt.country: Optional. Standard istIN, das Land der Seite. Jedes andere Land wird mit422 REGION_UNSUPPORTEDabgelehnt.
include weg: Auch include: {} führt vor der Credit-Reservierung zu 422 VALIDATION_ERROR für payload.include.
Antwortbeispiel
Ergebnisfelder
site,country,urlundproductIdkennzeichnen die Seite.urlist die gelesene Seite, undproductIdentspricht der ID aus einer Suche.titleist immer vorhanden.brand,price,currency,inStock,rating,reviewCount,imagesunddescriptionerscheinen, wenn die Seite sie zeigt.priceist, was ein Käufer laut der Seite beim Öffnen zahlt, vor Gutscheinen und Versand, incurrency(ISO 4217).inStockist die Verfügbarkeit des Produkts.ratingnutzt eine Fünf-Punkte-Skala mit zwei Nachkommastellen.reviewCountist die Anzahl der Bewertungen.imageslistet bis zu 30 Fotos aus der Produktgalerie in Seitenreihenfolge.descriptionist reiner Text mit einer Zeile pro Absatz, bis zu 10.000 Zeichen; Text, der nur in Bildern steht, ist nicht enthalten.descriptionist 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 mitENGINE_NO_RESULT. - Abgerechnet werden nur abgeschlossene Tasks: 0.5 Credits pro Suche oder Produktseite.