IKEA
IKEA tarjoukset API
Yksi markkinan IKEA-tarjouslistoista: uudet alemmat hinnat, IKEA Family -jäsenhinnat, viimeinen mahdollisuus (valikoimasta poistuvat), uutuudet, edullisimpien hintojen valikoima, myydyimmät, rajoitetut erät, määräaikaiset, vain myymälässä voimassa olevat ja alennushintaiset tarjoukset. Jokaisella tuotteella on hinta ja aiempi hinta markkinan valuutassa, hintamerkintä ja hinnan voimassaolopäivät, ja käytössä ovat haun lajittelut ja suodattimet. 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/jsontypeenum<string>requiredMikä tarjouslista.
Example: new_lower_price
new_products— Uutuudet.family_price— IKEA Family -jäsenhinnat: price on jäsenhinta, previous_price normaalihinta.new_lower_price— Uusi alempi hinta: previous_price on hinta ennen laskua, uuden hinnan voimassaolopäivien kanssa.last_chance— Viimeinen mahdollisuus: valikoimasta poistuvat tuotteet.lowest_price— Edullisimpien hintojen valikoima.top_seller— Myydyimmät.limited_edition— Rajoitetut erät.time_restricted— Määräaikaiset tarjoukset.in_store_price_only— Hinnat, jotka ovat voimassa vain myymälässä.reduced_price_offer— Alennushintaiset tarjoukset.
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")
# Suomen uudet alemmat hinnat kalleimmasta alkaen, 100 sivulla.
r = client.ikea.deals(type="new_lower_price", country="fi", page_size=100, sort="price_desc")["data"]
print(r["total"], "tuotetta, joilla uusi alempi hinta,", r["currency"])
for i in r["items"][:10]:
print(i["name"], i["type_name"], i["previous_price"], "->", i["price"], i["price_valid_from"])Response