COMMERCE_SERP mit site ulta, 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.ulta.query: Erforderlich. Suchbegriff mit 1 bis 500 Zeichen.limit: Optionale Ganzzahl von 1 bis 40, Standard 20.country: Optional. Standard istUS, 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. Ulta leitet manche Markennamen auf die Markenseite um, und die Produkte stammen dann von dieser Seite.
Produktseite
Parameter
url: Erforderlich. Eine Produktseite im Shop Ulta, höchstens 2.048 Zeichen:ulta.com/p/{name}-{id}. Produkt-urlaus einer Suche funktionieren unverändert. Parameter ohne Einfluss auf das Ergebnis, etwa Tracking-Codes, werden vor dem Lesen entfernt.country: Optional. Standard istUS, 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,images,description,descriptionImages,specs,options,categoriesundgtinerscheinen, 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.descriptionImageslistet 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.specslistet bis zu 100 Paare{ name, value }aus den Produktdetails.optionslistet bis zu 20 Auswahlmöglichkeiten wie Größe oder Farbe, jede mit bis zu 100values; die übrigen Felder beschreiben die Auswahl, mit der die Seite öffnet.categoriesreicht von der breitesten bis zur engsten Kategorie, bis zu 10 Ebenen.gtinist 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 mitENGINE_NO_RESULT. - Abgerechnet werden nur abgeschlossene Tasks: 0.5 Credits pro Suche oder Produktseite.