IKEA
IKEA haku API
Hae IKEA-tuotteita hakusanalla millä tahansa 55 markkinasta: 50 ikea.com-markkinaa ja Kiina (ikea.cn) palauttavat koko ruudukon, oletuksena 24 tuotetta sivulla (enintään 100), seitsemällä lajittelulla ja suodattimilla värille, hintaluokalle, kategorialle, uutuuksille, viimeiselle mahdollisuudelle, IKEA Family -hinnalle, myydyimmille, myymäläsaatavuudelle tai mille tahansa fasetille. Jokaisella tuotteella on tuotenumero, nimi, tyyppi, design, hinta ja aiempi hinta markkinan valuutassa, hintamerkintä (uusi alempi hinta, IKEA Family -hinta ...), arvio, versiot ja kategoriapolku, ja lisäksi palautuvat fasetit, "tarkoititko"-ehdotukset, liittyvät haut ja sisältökortit. Franchise-sivustot (Puerto Rico, Dominikaaninen tasavalta, Kanariansaaret ja Baleaarit, Islanti) hyväksyvät vain query- ja page-parametrit. 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/jsonquerystringrequiredHakusanat, 1-200 merkkiä, millä tahansa markkinan kielellä. Myös tuotenumero toimii.
Example: kallax
countrystringdefault:usIKEA-markkina pienillä kirjaimilla kirjoitettuna koodina (oletus us). Tämä päätepiste kattaa 55 markkinaa: 50 ikea.com-markkinaa, Kiina (ikea.cn), Puerto Rico, Dominikaaninen tasavalta, Kanariansaaret ja Baleaarit sekä Islanti. 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.pr— Puerto Rico, USD, kielet en, es.do— Dominikaaninen tasavalta, DOP, kielet es, en.es_islands— Kanariansaaret ja Baleaarit (island pakollinen), EUR, kielet es, en.is— Islanti, ISK, kielet en, is.
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
islandenum<string>Pakollinen, kun country on es_islands (Kanariansaarten ja Baleaarien verkkokaupat), muuten ei sallittu: minkä saaren verkkokauppa.
Example: tenerife
tenerife— Tenerife (Kanariansaaret).grancanaria— Gran Canaria (Kanariansaaret).lanzarote— Lanzarote (Kanariansaaret).fuerteventura— Fuerteventura (Kanariansaaret).lapalma— La Palma (Kanariansaaret).lagomera— La Gomera (Kanariansaaret).elhierro— El Hierro (Kanariansaaret).mallorca— Mallorca (Baleaarit).menorca— Menorca (Baleaarit).ibiza— Ibiza (Baleaarit).
category_idstring | string[]Rajaa faseteista saatuihin kategoriatunnisteisiin (parametri f-subcategories), esim. st002.
Example: st002
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")
# KALLAX Suomessa halvimmasta alkaen. Hinnat euroina; previous_price on
# täytetty tuotteilla, joilla on uusi alempi hinta.
r = client.ikea.search(query="kallax", country="fi", sort="price_asc")["data"]
print(r["total"], "tulosta,", r["currency"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["price"], i["previous_price"], i["price_tag"])Response