IKEA
IKEA Search API
Otsi IKEA tooteid märksõna järgi ükskõik millisel 55 turust: 50 ikea.com turgu ja Hiina (ikea.cn) tagastavad täieliku tulemuste ruudustiku, vaikimisi 24 toodet lehel (kuni 100), seitsme sortimise ning värvi, hinnavahemiku, kategooria, uute toodete, viimase võimaluse, IKEA Family hinna, enimmüüdud toodete, kaupluse saadavuse või mis tahes tahu filtriga. Igal tootel on artiklinumber, nimi, tüüp, kujundus, hind ja varasem hind turu valuutas, hinnasilt (uus madalam hind, IKEA Family hind ...), hinnang, variandid ja kategooriarada, lisaks tahud, did-you-mean, seotud otsingud ja sisukaardid. Frantsiisisaidid (Puerto Rico, Dominikaani Vabariik, Kanaari ja Baleaari saared, Island) võtavad ainult query ja page väärtust. Maksab 1 krediidi päringu kohta.
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/jsonquerystringrequiredOtsingusõnad, 1-200 märki, mis tahes keeles, mida turg pakub. Toimib ka artiklinumber.
Example: kallax
countrystringdefault:usIKEA turg väiketähtedega koodina. See endpoint teenindab 55 turgu: 50 ikea.com turgu, Hiina (ikea.cn), Puerto Rico, Dominikaani Vabariik, Kanaari ja Baleaari saared ning Island. Nimed, kirjeldused ja sildid tulevad turu keeles ja hinnad turu valuutas, alati konverteerimata; vastus kordab country, language ja currency väärtust. Turg, mida loendis pole, vastab 400 enne, kui midagi arvestatakse.
Example: ee
us— Ameerika Ühendriigid, USD, keeled en, es. Vaikimisi.ca— Kanada, CAD, keeled en, fr.gb— Ühendkuningriik, GBP, keel en.ie— Iirimaa, EUR, keel en.de— Saksamaa, EUR, keeled de, en.at— Austria, EUR, keeled de, en.ch— Šveits, CHF, keeled de, fr, it, en.fr— Prantsusmaa, EUR, keel fr.be— Belgia, EUR, keeled nl, fr, en.nl— Madalmaad, EUR, keeled nl, en.dk— Taani, DKK, keel da.se— Rootsi, SEK, keeled sv, en.no— Norra, NOK, keeled no, en.fi— Soome, EUR, keeled fi, sv, en.ee— Eesti, EUR, keeled et, ru, en.lv— Läti, EUR, keeled lv, ru, en.lt— Leedu, EUR, keeled lt, ru, en.pl— Poola, PLN, keel pl.cz— Tšehhi, CZK, keeled cs, en.sk— Slovakkia, EUR, keel sk.hu— Ungari, HUF, keel hu.hr— Horvaatia, EUR, keel hr.si— Sloveenia, EUR, keel sl.rs— Serbia, RSD, keel sr.ro— Rumeenia, RON, keel ro.pt— Portugal, EUR, keeled pt, en.es— Hispaania, EUR, keeled es, en, ca, eu, gl.it— Itaalia, EUR, keel it.il— Iisrael, ILS, keel he.ae— Araabia Ühendemiraadid, AED, keeled ar, en.sa— Saudi Araabia, SAR, keeled ar, en.kw— Kuveit, KWD, keeled ar, en.qa— Katar, QAR, keeled ar, en.bh— Bahrein, BHD, keeled ar, en.om— Omaan, OMR, keeled ar, en.jo— Jordaania, JOD, keeled ar, en.eg— Egiptus, EGP, keeled ar, en.ma— Maroko, MAD, keeled ar, fr, en.in— India, INR, keel en.my— Malaisia, MYR, keeled ms, en.sg— Singapur, SGD, keel en.ph— Filipiinid, PHP, keel en.th— Tai, THB, keeled th, en.jp— Jaapan, JPY, keeled ja, en.kr— Lõuna-Korea, KRW, keeled ko, en.au— Austraalia, AUD, keel en.nz— Uus-Meremaa, NZD, keel en.mx— Mehhiko, MXN, keeled es, en.cl— Tšiili, CLP, keel es.co— Colombia, COP, keel es.cn— Hiina (ikea.cn), CNY, keeled zh, en.pr— Puerto Rico, USD, keeled en, es.do— Dominikaani Vabariik, DOP, keeled es, en.es_islands— Kanaari ja Baleaari saared (saada island), EUR, keeled es, en.is— Island, ISK, keeled en, is.
languagestringVastuse keel, üks neist, mida turu sait pakub; vaikimisi turu esimene keel (ee puhul et, us puhul en, de puhul de). ikea.ee pakub et, ru ja en, ikea.lv lv, ru ja en, ikea.lt lt, ru ja en. Teised mitmekeelsed turud: 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, cz cs/en, pt pt/en, es es/en/ca/eu/gl, Pärsia lahe ja araabia turud 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. Ülejäänud turgudel on üks keel. Muu kood vastab 400.
Example: et
islandenum<string>Kohustuslik koos country es_islands väärtusega (Kanaari ja Baleaari saarte poed), muul juhul keelatud: millise saare poodi päritakse.
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[]Kitsenda kategooria id(de)ga tahkudest (parameeter f-subcategories), nt st002.
Example: st002
pageintegerdefault:1Tulemuste leht, alates 1-st. IKEA serveerib loendi esimesed 2000 tulemust pluss ühe lehe, seega (page - 1) x page_size ei tohi ületada 2000.
Example: 2
page_sizeintegerdefault:24Tooteid lehel, 1-100.
Example: 48
sortenum<string>default:relevanceTulemuste järjestus.
Example: price_asc
relevance— Saidi enda järjestus. Vaikimisi.price_asc— Odavaimad enne.price_desc— Kalleimad enne.newest— Uusimad tooted enne.rating— Parima hinnanguga enne.name_asc— Nimi A-st Z-ni.most_popular— Populaarseimad enne.
colorstring | string[]Värvi id(d) tahkudest (parameeter f-colors), nt 10156 = valge.
Example: 10156
price_bucketstringHinnavahemiku id tahkudest (parameeter f-price-buckets), nt PRICE_0_5000 = 0 kuni 49.99 turu valuutas.
Example: PRICE_0_5000
new_onlybooleanAinult uued tooted.
Example: true
last_chancebooleanAinult viimase võimaluse tooted (müügist kaduvad).
Example: true
family_pricebooleanAinult IKEA Family liikmehinnaga tooted.
Example: true
top_sellerbooleanAinult enimmüüdud tooted.
Example: true
store_idstring | integerKaupluse id (stores endpointi stores[].store_id). Lisab iga toote saadavuse selles kaupluses (laoseisu tase, kojuvedu) ja lubab availability filtri.
Example: 399
availabilityenum<string>Koos store_id-ga: in_store (kaupluses laos, vaikimisi), click_collect või online.
Example: in_store
in_store— Kaupluses laos.click_collect— Saadaval kauplusest järeletulemiseks (click and collect).online— Saadaval veebis.
filtersobjectMis tahes muu tahk, võtmeks facets[].parameter, nt {"f-materials": ["47350"]}. Tõeväärtusega tahud võtavad true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX ikea.ee-s, odavaimad enne. Hinnad on eurodes.
r = client.ikea.search(query="kallax", country="ee", language="et", sort="price_asc")["data"]
print(r["total"], "tulemust,", r["currency"])
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["measure_text"], i["price"])Response