IKEA
IKEA Search API
Ieškokite IKEA prekių pagal raktažodį bet kurioje iš 55 rinkų: 50 ikea.com rinkų ir Kinija (ikea.cn) grąžina visą rezultatų tinklelį, numatytai 24 prekes puslapyje (iki 100), su septyniais rikiavimo būdais ir filtrais pagal spalvą, kainų intervalą, kategoriją, naujas prekes, paskutinę progą, IKEA Family kainą, perkamiausias prekes, prieinamumą parduotuvėje ar bet kurį facetą. Kiekviena prekė turi prekės numerį, pavadinimą, tipą, dizainą, kainą ir ankstesnę kainą rinkos valiuta, kainos žymą (nauja mažesnė kaina, IKEA Family kaina ...), įvertinimą, variantus ir kategorijų kelią, taip pat facetus, did-you-mean, susijusias paieškas ir turinio korteles. Franšizės svetainės (Puerto Rikas, Dominikos Respublika, Kanarų ir Balearų salos, Islandija) priima tik query ir page. Kainuoja 1 kreditą už užklausą.
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/jsonquerystringrequiredPaieškos žodžiai, 1-200 simbolių, bet kuria rinkos siūloma kalba. Tinka ir prekės numeris.
Example: kallax
countrystringdefault:usIKEA rinka, nurodoma mažosiomis raidėmis. Šis endpoint aptarnauja 55 rinkas: 50 ikea.com rinkų, Kiniją (ikea.cn), Puerto Riką, Dominikos Respubliką, Kanarų ir Balearų salas bei Islandiją. Pavadinimai, aprašymai ir etiketės grąžinami rinkos kalba, o kainos rinkos valiuta, niekada nekonvertuojamos; atsakyme pakartojami country, language ir currency. Rinka, kurios nėra sąraše, grąžina 400 prieš bet kokį apmokestinimą.
Example: lt
us— JAV, USD, kalbos en, es. Numatytoji.ca— Kanada, CAD, kalbos en, fr.gb— Jungtinė Karalystė, GBP, kalba en.ie— Airija, EUR, kalba en.de— Vokietija, EUR, kalbos de, en.at— Austrija, EUR, kalbos de, en.ch— Šveicarija, CHF, kalbos de, fr, it, en.fr— Prancūzija, EUR, kalba fr.be— Belgija, EUR, kalbos nl, fr, en.nl— Nyderlandai, EUR, kalbos nl, en.dk— Danija, DKK, kalba da.se— Švedija, SEK, kalbos sv, en.no— Norvegija, NOK, kalbos no, en.fi— Suomija, EUR, kalbos fi, sv, en.ee— Estija, EUR, kalbos et, ru, en.lv— Latvija, EUR, kalbos lv, ru, en.lt— Lietuva, EUR, kalbos lt, ru, en.pl— Lenkija, PLN, kalba pl.cz— Čekija, CZK, kalbos cs, en.sk— Slovakija, EUR, kalba sk.hu— Vengrija, HUF, kalba hu.hr— Kroatija, EUR, kalba hr.si— Slovėnija, EUR, kalba sl.rs— Serbija, RSD, kalba sr.ro— Rumunija, RON, kalba ro.pt— Portugalija, EUR, kalbos pt, en.es— Ispanija, EUR, kalbos es, en, ca, eu, gl.it— Italija, EUR, kalba it.il— Izraelis, ILS, kalba he.ae— Jungtiniai Arabų Emyratai, AED, kalbos ar, en.sa— Saudo Arabija, SAR, kalbos ar, en.kw— Kuveitas, KWD, kalbos ar, en.qa— Kataras, QAR, kalbos ar, en.bh— Bahreinas, BHD, kalbos ar, en.om— Omanas, OMR, kalbos ar, en.jo— Jordanija, JOD, kalbos ar, en.eg— Egiptas, EGP, kalbos ar, en.ma— Marokas, MAD, kalbos ar, fr, en.in— Indija, INR, kalba en.my— Malaizija, MYR, kalbos ms, en.sg— Singapūras, SGD, kalba en.ph— Filipinai, PHP, kalba en.th— Tailandas, THB, kalbos th, en.jp— Japonija, JPY, kalbos ja, en.kr— Pietų Korėja, KRW, kalbos ko, en.au— Australija, AUD, kalba en.nz— Naujoji Zelandija, NZD, kalba en.mx— Meksika, MXN, kalbos es, en.cl— Čilė, CLP, kalba es.co— Kolumbija, COP, kalba es.cn— Kinija (ikea.cn), CNY, kalbos zh, en.pr— Puerto Rikas, USD, kalbos en, es.do— Dominikos Respublika, DOP, kalbos es, en.es_islands— Kanarų ir Balearų salos (siųskite island), EUR, kalbos es, en.is— Islandija, ISK, kalbos en, is.
languagestringAtsakymo kalba, viena iš tų, kurias siūlo rinkos svetainė; numatytoji yra pirmoji rinkos kalba (lt rinkoje lt, us rinkoje en, de rinkoje de). ikea.lt siūlo lt, ru ir en, ikea.lv lv, ru ir en, ikea.ee et, ru ir en. Kitos daugiakalbės rinkos: us en/es, ca en/fr, de ir 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, cz cs/en, pt pt/en, es es/en/ca/eu/gl, Persijos įlankos ir arabų rinkos 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 ir es_islands es/en, is en/is. Visos kitos rinkos turi vieną kalbą. Kitas kodas grąžina 400.
Example: lt
islandenum<string>Privalomas su country es_islands (Kanarų ir Balearų salų parduotuvės), kitais atvejais neleidžiamas: kurios salos parduotuvė.
Example: tenerife
tenerife— Tenerife (Canary Islands).grancanaria— Gran Canaria (Canary Islands).lanzarote— Lanzarote (Canary Islands).fuerteventura— Fuerteventura (Canary Islands).lapalma— La Palma (Canary Islands).lagomera— La Gomera (Canary Islands).elhierro— El Hierro (Canary Islands).mallorca— Mallorca (Balearic Islands).menorca— Menorca (Balearic Islands).ibiza— Ibiza (Balearic Islands).
category_idstring | string[]Susiaurinkite pagal kategorijos id iš facetų (parametras f-subcategories), pvz. st002.
Example: st002
pageintegerdefault:1Rezultatų puslapis, nuo 1. IKEA pateikia pirmus 2 000 sąrašo rezultatų ir dar vieną puslapį, todėl (page - 1) x page_size negali viršyti 2 000.
Example: 2
page_sizeintegerdefault:24Prekių puslapyje, 1-100.
Example: 48
sortenum<string>default:relevanceRezultatų tvarka.
Example: price_asc
relevance— Pačios svetainės tvarka. Numatytoji.price_asc— Pigiausios pirmiau.price_desc— Brangiausios pirmiau.newest— Naujausios prekės pirmiau.rating— Geriausiai įvertintos pirmiau.name_asc— Pavadinimas nuo A iki Z.most_popular— Populiariausios pirmiau.
colorstring | string[]Spalvos id iš facetų (parametras f-colors), pvz. 10156 = balta.
Example: 10156
price_bucketstringKainų intervalo id iš facetų (parametras f-price-buckets), pvz. PRICE_0_5000 = nuo 0 iki 49.99 rinkos valiuta.
Example: PRICE_0_5000
new_onlybooleanTik naujos prekės.
Example: true
last_chancebooleanTik paskutinės progos prekės (išimamos iš prekybos).
Example: true
family_pricebooleanTik prekės su IKEA Family nario kaina.
Example: true
top_sellerbooleanTik perkamiausios prekės.
Example: true
store_idstring | integerParduotuvės id (stores endpoint stores[].store_id). Prideda kiekvienos prekės prieinamumą toje parduotuvėje (likučio lygis, pristatymas į namus) ir įjungia availability.
Example: 399
availabilityenum<string>Su store_id: in_store (yra parduotuvėje, numatytoji), click_collect arba online.
Example: in_store
in_store— Yra parduotuvėje.click_collect— Galima atsiimti parduotuvėje (click and collect).online— Galima įsigyti internetu.
filtersobjectBet kuris kitas facetas, raktas yra facets[].parameter, pvz. {"f-materials": ["47350"]}. Loginiai facetai priima true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX ikea.lt, pigiausios pirmiau. Kainos eurais.
r = client.ikea.search(query="kallax", country="lt", language="lt", sort="price_asc")["data"]
print(r["total"], "rezultatų,", r["currency"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["measure_text"], i["price"])Response