IKEA
IKEA Search API
Pretraga IKEA proizvoda po ključnoj reči na bilo kom od 55 tržišta: 50 tržišta ikea.com i Kina (ikea.cn) vraćaju celu mrežu, podrazumevano 24 proizvoda po strani (do 100), sa sedam načina sortiranja i filterima po boji, cenovnom opsegu, kategoriji, novitetima, poslednjoj prilici, ceni IKEA Family, najprodavanijima, dostupnosti u robnoj kući ili bilo kom facetu. Svaki proizvod ima broj artikla, naziv, vrstu, dizajn, cenu i prethodnu cenu u valuti tržišta, oznaku cene (nova niža cena, cena IKEA Family ...), ocenu, varijante i putanju kategorija, uz facete, did_you_mean, povezane pretrage i kartice sadržaja. Franšizni sajtovi (Portoriko, Dominikanska Republika, Kanarska i Balearska ostrva, Island) primaju samo query i page. Košta 1 kredit po zahtevu.
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/jsonquerystringrequiredPojmovi za pretragu, 1-200 karaktera, na bilo kom jeziku tržišta. Radi i broj artikla.
Example: kallax
countrystringdefault:usIKEA tržište kao kôd malim slovima (rs za IKEA Srbija). Ovaj endpoint opslužuje 55 tržišta: 50 tržišta ikea.com, Kinu (ikea.cn), Portoriko, Dominikansku Republiku, Kanarska i Balearska ostrva i Island. Nazivi, opisi i oznake stižu na jeziku tržišta, a cene u njegovoj valuti, nikad preračunate; odgovor vraća country, language i currency. Tržište van ove liste vraća 400 pre bilo kakve naplate.
Example: rs
us— Sjedinjene Američke Države, USD, jezici en, es. Podrazumevana vrednost.ca— Kanada, CAD, jezici en, fr.gb— Ujedinjeno Kraljevstvo, GBP, jezik en.ie— Irska, EUR, jezik en.de— Nemačka, EUR, jezici de, en.at— Austrija, EUR, jezici de, en.ch— Švajcarska, CHF, jezici de, fr, it, en.fr— Francuska, EUR, jezik fr.be— Belgija, EUR, jezici nl, fr, en.nl— Holandija, EUR, jezici nl, en.dk— Danska, DKK, jezik da.se— Švedska, SEK, jezici sv, en.no— Norveška, NOK, jezici no, en.fi— Finska, EUR, jezici fi, sv, en.ee— Estonija, EUR, jezici et, ru, en.lv— Letonija, EUR, jezici lv, ru, en.lt— Litvanija, EUR, jezici lt, ru, en.pl— Poljska, PLN, jezik pl.cz— Češka, CZK, jezici cs, en.sk— Slovačka, EUR, jezik sk.hu— Mađarska, HUF, jezik hu.hr— Hrvatska, EUR, jezik hr.si— Slovenija, EUR, jezik sl.rs— Srbija, RSD, jezik sr.ro— Rumunija, RON, jezik ro.pt— Portugalija, EUR, jezici pt, en.es— Španija, EUR, jezici es, en, ca, eu, gl.it— Italija, EUR, jezik it.il— Izrael, ILS, jezik he.ae— Ujedinjeni Arapski Emirati, AED, jezici ar, en.sa— Saudijska Arabija, SAR, jezici ar, en.kw— Kuvajt, KWD, jezici ar, en.qa— Katar, QAR, jezici ar, en.bh— Bahrein, BHD, jezici ar, en.om— Oman, OMR, jezici ar, en.jo— Jordan, JOD, jezici ar, en.eg— Egipat, EGP, jezici ar, en.ma— Maroko, MAD, jezici ar, fr, en.in— Indija, INR, jezik en.my— Malezija, MYR, jezici ms, en.sg— Singapur, SGD, jezik en.ph— Filipini, PHP, jezik en.th— Tajland, THB, jezici th, en.jp— Japan, JPY, jezici ja, en.kr— Južna Koreja, KRW, jezici ko, en.au— Australija, AUD, jezik en.nz— Novi Zeland, NZD, jezik en.mx— Meksiko, MXN, jezici es, en.cl— Čile, CLP, jezik es.co— Kolumbija, COP, jezik es.cn— Kina (ikea.cn), CNY, jezici zh, en.pr— Portoriko, USD, jezici en, es.do— Dominikanska Republika, DOP, jezici es, en.es_islands— Kanarska i Balearska ostrva (pošaljite island), EUR, jezici es, en.is— Island, ISK, jezici en, is.
languagestringJezik odgovora, jedan od jezika koje nudi sajt tržišta; podrazumevan je prvi jezik tržišta (sr na rs, de na de). IKEA Srbija ima jedan jezik, srpski, i odgovara latinicom. Višejezična tržišta: us en/es, ca en/fr, de i 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, arapska tržišta 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 i es_islands es/en, is en/is. Drugi kôd vraća 400.
Example: fr
islandenum<string>Obavezno uz country es_islands (prodavnice Kanarskih i Balearskih ostrva), inače nije dozvoljeno: koje ostrvo.
Example: tenerife
tenerife— Tenerife (Kanarska ostrva).grancanaria— Gran Canaria (Kanarska ostrva).lanzarote— Lanzarote (Kanarska ostrva).fuerteventura— Fuerteventura (Kanarska ostrva).lapalma— La Palma (Kanarska ostrva).lagomera— La Gomera (Kanarska ostrva).elhierro— El Hierro (Kanarska ostrva).mallorca— Mallorca (Balearska ostrva).menorca— Menorca (Balearska ostrva).ibiza— Ibiza (Balearska ostrva).
category_idstring | string[]Sužavanje na ID kategorije iz facets (parametar f-subcategories), npr. st002 = Biblioteke i police na rs.
Example: st002
pageintegerdefault:1Strana rezultata, od 1. IKEA daje prvih 2.000 rezultata liste i još jednu stranu, pa (page - 1) x page_size ne sme da pređe 2.000.
Example: 2
page_sizeintegerdefault:24Proizvoda po strani, 1-100.
Example: 48
sortenum<string>default:relevanceRedosled rezultata.
Example: price_asc
relevance— Redosled samog sajta. Podrazumevano.price_asc— Najjeftinije prvo.price_desc— Najskuplje prvo.newest— Najnoviji proizvodi prvo.rating— Najbolje ocenjeni prvo.name_asc— Naziv od A do Ž.most_popular— Najpopularniji prvo.
colorstring | string[]ID boje iz facets (parametar f-colors), npr. 10156 = bela.
Example: 10156
price_bucketstringID cenovnog opsega iz facets (parametar f-price-buckets), npr. PRICE_0_200000 = 0 - 1.999 RSD na rs.
Example: PRICE_0_5000
new_onlybooleanSamo novi proizvodi.
Example: true
last_chancebooleanSamo proizvodi poslednje prilike (izlaze iz ponude).
Example: true
family_pricebooleanSamo proizvodi sa cenom za članove IKEA Family.
Example: true
top_sellerbooleanSamo najprodavaniji proizvodi.
Example: true
store_idstring | integerID robne kuće (stores[].store_id iz endpointa stores). Dodaje dostupnost svakog proizvoda u toj robnoj kući (nivo zaliha, dostava na kućnu adresu) i uključuje availability.
Example: 399
availabilityenum<string>Uz store_id: in_store (na zalihama u robnoj kući, podrazumevano), click_collect ili online.
Example: in_store
in_store— Na zalihama u robnoj kući.click_collect— Dostupno za Click & Collect u robnoj kući.online— Dostupno onlajn.
filtersobjectBilo koji drugi facet prema facets[].parameter, npr. {"f-materials": ["47350"]}. Faceti tipa da/ne primaju true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX na IKEA Srbija, od najjeftinijeg. Cene su u RSD; previous_price
# je popunjen kod proizvoda sa novom nižom cenom.
r = client.ikea.search(query="kallax", country="rs", 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