IKEA
IKEA kategoria API
Yhden IKEA-kategorian tuotteet kategoriatunnisteella tai kategorian URL-osoitteella, haun lajittelujen ja suodattimien kanssa: jokaisen tuotteen tuotenumero, nimi, tyyppi, design, hinta ja aiempi hinta markkinan valuutassa, hintamerkintä, arvio, versiot ja kategoriapolku, sekä kategoria (id, nimi, url, ylätasot), total ja fasetit. 50 ikea.com-markkinalla ja Kiinassa (ikea.cn). Maksaa 1 krediitin pyynnöltä.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsoncategory_idstringKategorian tunniste: categories-päätepisteen categories[].id tai haun category_path- / facets-tunniste, esim. 11465 = Hyllyt Suomessa. Lähetä category_id tai url.
Example: 11465
urlstringIKEA-kategoriasivu category_id:n sijaan.
Example: https://www.ikea.com/us/en/cat/bookcases-10382/
countrystringdefault:usIKEA-markkina pienillä kirjaimilla kirjoitettuna koodina (oletus us). Tämä päätepiste kattaa 51 markkinaa: 50 ikea.com-markkinaa ja Kiina (ikea.cn). Nimet, kuvaukset ja tunnisteet palautuvat markkinan kielellä ja hinnat sen valuutassa, koskaan muuntamatta; vastaus palauttaa country-, language- ja currency-kentät. Listan ulkopuolinen markkina vastaa 400 ennen veloitusta.
Example: fi
us— Yhdysvallat, USD, kielet en, es. Oletusarvo.ca— Kanada, CAD, kielet en, fr.gb— Iso-Britannia, GBP, kieli en.ie— Irlanti, EUR, kieli en.de— Saksa, EUR, kielet de, en.at— Itävalta, EUR, kielet de, en.ch— Sveitsi, CHF, kielet de, fr, it, en.fr— Ranska, EUR, kieli fr.be— Belgia, EUR, kielet nl, fr, en.nl— Alankomaat, EUR, kielet nl, en.dk— Tanska, DKK, kieli da.se— Ruotsi, SEK, kielet sv, en.no— Norja, NOK, kielet no, en.fi— Suomi, EUR, kielet fi, sv, en.ee— Viro, EUR, kielet et, ru, en.lv— Latvia, EUR, kielet lv, ru, en.lt— Liettua, EUR, kielet lt, ru, en.pl— Puola, PLN, kieli pl.cz— Tšekki, CZK, kielet cs, en.sk— Slovakia, EUR, kieli sk.hu— Unkari, HUF, kieli hu.hr— Kroatia, EUR, kieli hr.si— Slovenia, EUR, kieli sl.rs— Serbia, RSD, kieli sr.ro— Romania, RON, kieli ro.pt— Portugali, EUR, kielet pt, en.es— Espanja, EUR, kielet es, en, ca, eu, gl.it— Italia, EUR, kieli it.il— Israel, ILS, kieli he.ae— Arabiemiirikunnat, AED, kielet ar, en.sa— Saudi-Arabia, SAR, kielet ar, en.kw— Kuwait, KWD, kielet ar, en.qa— Qatar, QAR, kielet ar, en.bh— Bahrain, BHD, kielet ar, en.om— Oman, OMR, kielet ar, en.jo— Jordania, JOD, kielet ar, en.eg— Egypti, EGP, kielet ar, en.ma— Marokko, MAD, kielet ar, fr, en.in— Intia, INR, kieli en.my— Malesia, MYR, kielet ms, en.sg— Singapore, SGD, kieli en.ph— Filippiinit, PHP, kieli en.th— Thaimaa, THB, kielet th, en.jp— Japani, JPY, kielet ja, en.kr— Etelä-Korea, KRW, kielet ko, en.au— Australia, AUD, kieli en.nz— Uusi-Seelanti, NZD, kieli en.mx— Meksiko, MXN, kielet es, en.cl— Chile, CLP, kieli es.co— Kolumbia, COP, kieli es.cn— Kiina (ikea.cn), CNY, kielet zh, en.
languagestringVastauksen kieli, jokin markkinan sivuston kielistä; oletuksena ensimmäinen (en markkinalla us, de markkinalla de, fi markkinalla fi). Monikieliset markkinat: us en/es, ca en/fr, de ja at de/en, ch de/fr/it/en, be nl/fr/en, nl nl/en, se sv/en, no no/en, fi fi/sv/en, ee et/ru/en, lv lv/ru/en, lt lt/ru/en, cz cs/en, pt pt/en, es es/en/ca/eu/gl, Persianlahden ja arabimaiden markkinat ar/en (ma ar/fr/en), my ms/en, th th/en, jp ja/en, kr ko/en, mx es/en, cn zh/en, pr en/es, do ja es_islands es/en, is en/is. Muilla markkinoilla on yksi kieli. Muu koodi vastaa 400. Suomessa "language": "sv" palauttaa vastauksen ruotsiksi ja "en" englanniksi.
Example: fr
pageintegerdefault:1Tulossivu, alkaen 1:stä. IKEA tarjoaa listan 2 000 ensimmäistä tulosta ja yhden sivun lisää, joten (page - 1) x page_size saa olla enintään 2 000.
Example: 2
page_sizeintegerdefault:24Tuotteita sivulla, 1-100.
Example: 48
sortenum<string>default:relevanceTulosten järjestys.
Example: price_asc
relevance— Sivuston oma järjestys. Oletus.price_asc— Halvin ensin.price_desc— Kallein ensin.newest— Uusimmat tuotteet ensin.rating— Parhaiten arvioidut ensin.name_asc— Nimi A-Ö.most_popular— Suosituimmat ensin.
colorstring | string[]Värin tunniste(et) faseteista (parametri f-colors), esim. 10156 = valkoinen.
Example: 10156
price_bucketstringHintaluokan tunniste faseteista (parametri f-price-buckets), esim. PRICE_0_2000 = 0-19 € markkinalla fi.
Example: PRICE_0_5000
new_onlybooleanVain uutuudet.
Example: true
last_chancebooleanVain viimeisen mahdollisuuden tuotteet (poistumassa valikoimasta).
Example: true
family_pricebooleanVain tuotteet, joilla on IKEA Family -hinta.
Example: true
top_sellerbooleanVain myydyimmät.
Example: true
store_idstring | integerMyymälän tunniste (stores-päätepisteen stores[].store_id). Lisää jokaisen tuotteen saatavuuden kyseisessä myymälässä (saatavuustaso, kotiinkuljetus) ja ottaa availability-parametrin käyttöön.
Example: 399
availabilityenum<string>store_id:n kanssa: in_store (varastossa myymälässä, oletus), click_collect tai online.
Example: in_store
in_store— Varastossa myymälässä.click_collect— Saatavilla Click & Collect -noutona myymälästä.online— Saatavilla verkossa.
filtersobjectMikä tahansa muu fasetti avaimella facets[].parameter, esim. {"f-materials": ["47350"]}. Totuusarvofasetit saavat arvon true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Hyllyt Suomessa (kategoria 11465), halvin ensin, 48 sivulla.
r = client.ikea.category(category_id="11465", country="fi", sort="price_asc", page_size=48)["data"]
print(r["category"]["name"], r["total"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["price"])Response