IKEA
IKEA Search API
Vyhľadávanie produktov IKEA podľa kľúčového slova na ktoromkoľvek z 55 trhov: 50 trhov ikea.com a Čína (ikea.cn) vracajú celú mriežku, predvolene 24 produktov na stranu (až 100), so siedmimi spôsobmi triedenia a filtrami podľa farby, cenového rozpätia, kategórie, noviniek, poslednej šance, ceny IKEA Family, najpredávanejších produktov, dostupnosti v obchode alebo ľubovoľného facetu. Každý produkt má číslo artiklu, názov, typ, dizajn, cenu a predchádzajúcu cenu v mene trhu, cenový štítok (nová nižšia cena, cena IKEA Family ...), hodnotenie, varianty a cestu v kategóriách, k tomu facety, did_you_mean, súvisiace vyhľadávania a obsahové karty. Franšízové stránky (Portoriko, Dominikánska republika, Kanárske a Baleárske ostrovy, Island) berú iba query a page. Stojí 1 kredit za požiadavku.
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/jsonquerystringrequiredHľadané slová, 1-200 znakov, v ktoromkoľvek jazyku trhu. Funguje aj číslo artiklu.
Example: kallax
countrystringdefault:usTrh IKEA ako kód malými písmenami (sk pre IKEA Slovensko). Tento endpoint obsluhuje 55 trhov: 50 trhov ikea.com, Čína (ikea.cn), Portoriko, Dominikánska republika, Kanárske a Baleárske ostrovy a Island. Názvy, popisy a štítky prichádzajú v jazyku trhu a ceny v jeho mene, nikdy neprepočítané; odpoveď vracia country, language a currency. Trh mimo tohto zoznamu odpovie 400 skôr, než sa čokoľvek účtuje.
Example: sk
us— Spojené štáty, USD, jazyky en, es. Predvolená hodnota.ca— Kanada, CAD, jazyky en, fr.gb— Spojené kráľovstvo, GBP, jazyk en.ie— Írsko, EUR, jazyk en.de— Nemecko, EUR, jazyky de, en.at— Rakúsko, EUR, jazyky de, en.ch— Švajčiarsko, CHF, jazyky de, fr, it, en.fr— Francúzsko, EUR, jazyk fr.be— Belgicko, EUR, jazyky nl, fr, en.nl— Holandsko, EUR, jazyky nl, en.dk— Dánsko, DKK, jazyk da.se— Švédsko, SEK, jazyky sv, en.no— Nórsko, NOK, jazyky no, en.fi— Fínsko, EUR, jazyky fi, sv, en.ee— Estónsko, EUR, jazyky et, ru, en.lv— Lotyšsko, EUR, jazyky lv, ru, en.lt— Litva, EUR, jazyky lt, ru, en.pl— Poľsko, PLN, jazyk pl.cz— Česko, CZK, jazyky cs, en.sk— Slovensko, EUR, jazyk sk.hu— Maďarsko, HUF, jazyk hu.hr— Chorvátsko, EUR, jazyk hr.si— Slovinsko, EUR, jazyk sl.rs— Srbsko, RSD, jazyk sr.ro— Rumunsko, RON, jazyk ro.pt— Portugalsko, EUR, jazyky pt, en.es— Španielsko, EUR, jazyky es, en, ca, eu, gl.it— Taliansko, EUR, jazyk it.il— Izrael, ILS, jazyk he.ae— Spojené arabské emiráty, AED, jazyky ar, en.sa— Saudská Arábia, SAR, jazyky ar, en.kw— Kuvajt, KWD, jazyky ar, en.qa— Katar, QAR, jazyky ar, en.bh— Bahrajn, BHD, jazyky ar, en.om— Omán, OMR, jazyky ar, en.jo— Jordánsko, JOD, jazyky ar, en.eg— Egypt, EGP, jazyky ar, en.ma— Maroko, MAD, jazyky ar, fr, en.in— India, INR, jazyk en.my— Malajzia, MYR, jazyky ms, en.sg— Singapur, SGD, jazyk en.ph— Filipíny, PHP, jazyk en.th— Thajsko, THB, jazyky th, en.jp— Japonsko, JPY, jazyky ja, en.kr— Južná Kórea, KRW, jazyky ko, en.au— Austrália, AUD, jazyk en.nz— Nový Zéland, NZD, jazyk en.mx— Mexiko, MXN, jazyky es, en.cl— Čile, CLP, jazyk es.co— Kolumbia, COP, jazyk es.cn— Čína (ikea.cn), CNY, jazyky zh, en.pr— Portoriko, USD, jazyky en, es.do— Dominikánska republika, DOP, jazyky es, en.es_islands— Kanárske a Baleárske ostrovy (pošlite island), EUR, jazyky es, en.is— Island, ISK, jazyky en, is.
languagestringJazyk odpovede, jeden z jazykov, ktoré stránka trhu ponúka; predvolený je prvý jazyk trhu (sk na sk, de na de). IKEA Slovensko má jeden jazyk, slovenčinu. Viacjazyčné trhy: us en/es, ca en/fr, de a 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, arabské trhy 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 a es_islands es/en, is en/is. Iný kód odpovie 400.
Example: fr
islandenum<string>Povinné s country es_islands (obchody Kanárskych a Baleárskych ostrovov), inak nepovolené: ktorý ostrov.
Example: tenerife
tenerife— Tenerife (Kanárske ostrovy).grancanaria— Gran Canaria (Kanárske ostrovy).lanzarote— Lanzarote (Kanárske ostrovy).fuerteventura— Fuerteventura (Kanárske ostrovy).lapalma— La Palma (Kanárske ostrovy).lagomera— La Gomera (Kanárske ostrovy).elhierro— El Hierro (Kanárske ostrovy).mallorca— Mallorca (Baleárske ostrovy).menorca— Menorca (Baleárske ostrovy).ibiza— Ibiza (Baleárske ostrovy).
category_idstring | string[]Zúženie na ID kategórie z facets (parameter f-subcategories), napr. st002 = Knižnice a policové diely na sk.
Example: st002
pageintegerdefault:1Strana výsledkov od 1. IKEA sprístupní prvých 2 000 výsledkov zoznamu a jednu stranu navyše, takže (page - 1) x page_size nesmie prekročiť 2 000.
Example: 2
page_sizeintegerdefault:24Produktov na stranu, 1-100.
Example: 48
sortenum<string>default:relevancePoradie výsledkov.
Example: price_asc
relevance— Vlastné poradie stránky. Predvolené.price_asc— Najlacnejšie najprv.price_desc— Najdrahšie najprv.newest— Najnovšie produkty najprv.rating— Najlepšie hodnotené najprv.name_asc— Názov od A po Z.most_popular— Najobľúbenejšie najprv.
colorstring | string[]ID farby z facets (parameter f-colors), napr. 10156 = biela.
Example: 10156
price_bucketstringID cenového rozpätia z facets (parameter f-price-buckets), napr. PRICE_0_2000 = 0,00 - 19,99 € na sk.
Example: PRICE_0_5000
new_onlybooleanIba nové produkty.
Example: true
last_chancebooleanIba produkty s poslednou šancou (končia v sortimente).
Example: true
family_pricebooleanIba produkty s cenou pre členov IKEA Family.
Example: true
top_sellerbooleanIba najpredávanejšie produkty.
Example: true
store_idstring | integerID obchodu (stores[].store_id z endpointu stores). Pridá dostupnosť každého produktu v danom obchode (úroveň zásob, doručenie domov) a zapne availability.
Example: 399
availabilityenum<string>So store_id: in_store (skladom v obchode, predvolené), click_collect alebo online.
Example: in_store
in_store— Skladom v obchode.click_collect— Dostupné na Click & Collect v obchode.online— Dostupné online.
filtersobjectĽubovoľný iný facet podľa facets[].parameter, napr. {"f-materials": ["47350"]}. Facety typu áno/nie berú true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX na IKEA Slovensko, od najlacnejšieho. Ceny sú v EUR; previous_price
# je vyplnená pri produktoch s novou nižšou cenou.
r = client.ikea.search(query="kallax", country="sk", sort="price_asc")["data"]
print(r["total"], 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