IKEA
IKEA Search API
Iskanje izdelkov IKEA po ključni besedi na katerem koli od 55 trgov: 50 trgov ikea.com in Kitajska (ikea.cn) vrnejo celotno mrežo, privzeto 24 izdelkov na stran (do 100), s sedmimi načini razvrščanja in filtri po barvi, cenovnem razponu, kategoriji, novostih, zadnji priložnosti, ceni IKEA Family, najbolje prodajanih, razpoložljivosti v trgovini ali katerem koli facetu. Vsak izdelek ima številko artikla, ime, vrsto, dizajn, ceno in prejšnjo ceno v valuti trga, cenovno oznako (nova nižja cena, cena IKEA Family ...), oceno, različice in pot kategorij, poleg tega facete, did_you_mean, sorodna iskanja in vsebinske kartice. Franšizna spletna mesta (Portoriko, Dominikanska republika, Kanarski in Balearski otoki, Islandija) sprejmejo samo query in page. Stane 1 kredit na zahtevo.
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/jsonquerystringrequiredIskalni izrazi, 1-200 znakov, v katerem koli jeziku trga. Deluje tudi številka artikla.
Example: kallax
countrystringdefault:usTrg IKEA kot koda z malimi črkami (si za IKEA Slovenija). Ta endpoint streže 55 trgov: 50 trgov ikea.com, Kitajsko (ikea.cn), Portoriko, Dominikansko republiko, Kanarske in Balearske otoke ter Islandijo. Imena, opisi in oznake prihajajo v jeziku trga, cene pa v njegovi valuti, nikoli preračunane; odgovor vrne country, language in currency. Trg zunaj tega seznama vrne 400, preden se karkoli zaračuna.
Example: si
us— Združene države Amerike, USD, jeziki en, es. Privzeta vrednost.ca— Kanada, CAD, jeziki en, fr.gb— Združeno kraljestvo, GBP, jezik en.ie— Irska, EUR, jezik en.de— Nemčija, EUR, jeziki de, en.at— Avstrija, EUR, jeziki de, en.ch— Švica, CHF, jeziki de, fr, it, en.fr— Francija, EUR, jezik fr.be— Belgija, EUR, jeziki nl, fr, en.nl— Nizozemska, EUR, jeziki nl, en.dk— Danska, DKK, jezik da.se— Švedska, SEK, jeziki sv, en.no— Norveška, NOK, jeziki no, en.fi— Finska, EUR, jeziki fi, sv, en.ee— Estonija, EUR, jeziki et, ru, en.lv— Latvija, EUR, jeziki lv, ru, en.lt— Litva, EUR, jeziki lt, ru, en.pl— Poljska, PLN, jezik pl.cz— Češka, CZK, jeziki cs, en.sk— Slovaška, EUR, jezik sk.hu— Madžarska, HUF, jezik hu.hr— Hrvaška, EUR, jezik hr.si— Slovenija, EUR, jezik sl.rs— Srbija, RSD, jezik sr.ro— Romunija, RON, jezik ro.pt— Portugalska, EUR, jeziki pt, en.es— Španija, EUR, jeziki es, en, ca, eu, gl.it— Italija, EUR, jezik it.il— Izrael, ILS, jezik he.ae— Združeni arabski emirati, AED, jeziki ar, en.sa— Savdska Arabija, SAR, jeziki ar, en.kw— Kuvajt, KWD, jeziki ar, en.qa— Katar, QAR, jeziki ar, en.bh— Bahrajn, BHD, jeziki ar, en.om— Oman, OMR, jeziki ar, en.jo— Jordanija, JOD, jeziki ar, en.eg— Egipt, EGP, jeziki ar, en.ma— Maroko, MAD, jeziki ar, fr, en.in— Indija, INR, jezik en.my— Malezija, MYR, jeziki ms, en.sg— Singapur, SGD, jezik en.ph— Filipini, PHP, jezik en.th— Tajska, THB, jeziki th, en.jp— Japonska, JPY, jeziki ja, en.kr— Južna Koreja, KRW, jeziki ko, en.au— Avstralija, AUD, jezik en.nz— Nova Zelandija, NZD, jezik en.mx— Mehika, MXN, jeziki es, en.cl— Čile, CLP, jezik es.co— Kolumbija, COP, jezik es.cn— Kitajska (ikea.cn), CNY, jeziki zh, en.pr— Portoriko, USD, jeziki en, es.do— Dominikanska republika, DOP, jeziki es, en.es_islands— Kanarski in Balearski otoki (pošljite island), EUR, jeziki es, en.is— Islandija, ISK, jeziki en, is.
languagestringJezik odgovora, eden od jezikov, ki jih ponuja spletno mesto trga; privzet je prvi jezik trga (sl na si, de na de). IKEA Slovenija ima en jezik, slovenščino. Večjezični trgi: us en/es, ca en/fr, de in 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, arabski trgi 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 in es_islands es/en, is en/is. Druga koda vrne 400.
Example: fr
islandenum<string>Obvezno s country es_islands (trgovine Kanarskih in Balearskih otokov), sicer ni dovoljeno: kateri otok.
Example: tenerife
tenerife— Tenerife (Kanarski otoki).grancanaria— Gran Canaria (Kanarski otoki).lanzarote— Lanzarote (Kanarski otoki).fuerteventura— Fuerteventura (Kanarski otoki).lapalma— La Palma (Kanarski otoki).lagomera— La Gomera (Kanarski otoki).elhierro— El Hierro (Kanarski otoki).mallorca— Mallorca (Balearski otoki).menorca— Menorca (Balearski otoki).ibiza— Ibiza (Balearski otoki).
category_idstring | string[]Zožitev na ID kategorije iz facets (parameter f-subcategories), npr. st002 = Knjižne omare in regali na si.
Example: st002
pageintegerdefault:1Stran rezultatov, od 1. IKEA ponudi prvih 2.000 rezultatov seznama in še eno stran, zato (page - 1) x page_size ne sme preseči 2.000.
Example: 2
page_sizeintegerdefault:24Izdelkov na stran, 1-100.
Example: 48
sortenum<string>default:relevanceVrstni red rezultatov.
Example: price_asc
relevance— Vrstni red spletnega mesta. Privzeto.price_asc— Najcenejši najprej.price_desc— Najdražji najprej.newest— Najnovejši izdelki najprej.rating— Najbolje ocenjeni najprej.name_asc— Ime od A do Ž.most_popular— Najbolj priljubljeni najprej.
colorstring | string[]ID barve iz facets (parameter f-colors), npr. 10156 = bela.
Example: 10156
price_bucketstringID cenovnega razpona iz facets (parameter f-price-buckets), npr. PRICE_0_2000 = 0,00 - 19,99 € na si.
Example: PRICE_0_5000
new_onlybooleanSamo novi izdelki.
Example: true
last_chancebooleanSamo izdelki zadnje priložnosti (izhajajo iz ponudbe).
Example: true
family_pricebooleanSamo izdelki s ceno za člane IKEA Family.
Example: true
top_sellerbooleanSamo najbolje prodajani izdelki.
Example: true
store_idstring | integerID trgovine (stores[].store_id iz endpointa stores). Doda razpoložljivost vsakega izdelka v tej trgovini (raven zaloge, dostava na dom) in vklopi availability.
Example: 399
availabilityenum<string>S store_id: in_store (na zalogi v trgovini, privzeto), click_collect ali online.
Example: in_store
in_store— Na zalogi v trgovini.click_collect— Na voljo za Click & Collect v trgovini.online— Na voljo na spletu.
filtersobjectKateri koli drug facet po facets[].parameter, npr. {"f-materials": ["47350"]}. Faceti tipa da/ne sprejmejo true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX na IKEA Slovenija, od najcenejšega. Cene so v EUR; previous_price
# je izpolnjen pri izdelkih z novo nižjo ceno.
r = client.ikea.search(query="kallax", country="si", 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