IKEA
IKEA Search API
Pretraživanje IKEA proizvoda po ključnoj riječi na bilo kojem od 55 tržišta: 50 tržišta ikea.com i Kina (ikea.cn) vraćaju cijelu mrežu, zadano 24 proizvoda po stranici (do 100), sa sedam načina sortiranja i filtrima po boji, cjenovnom rasponu, kategoriji, novitetima, posljednjoj prilici, cijeni IKEA Family, najprodavanijima, dostupnosti u robnoj kući ili bilo kojem facetu. Svaki proizvod ima broj artikla, naziv, vrstu, dizajn, cijenu i prethodnu cijenu u valuti tržišta, cjenovnu oznaku (nova niža cijena, cijena IKEA Family ...), ocjenu, varijante i putanju kategorija, uz facete, did_you_mean, povezana pretraživanja i kartice sadržaja. Franšizne stranice (Portoriko, Dominikanska Republika, Kanarski i Balearski otoci, Island) primaju samo query i page. Košta 1 kredit po zahtjevu.
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 pretraživanje, 1-200 znakova, na bilo kojem jeziku tržišta. Radi i broj artikla.
Example: kallax
countrystringdefault:usTržište IKEA kao kôd malim slovima (hr za IKEA Hrvatska). Ovaj endpoint poslužuje 55 tržišta: 50 tržišta ikea.com, Kinu (ikea.cn), Portoriko, Dominikansku Republiku, Kanarske i Balearske otoke te Island. Nazivi, opisi i oznake stižu na jeziku tržišta, a cijene u njegovoj valuti, nikad preračunate; odgovor vraća country, language i currency. Tržište izvan ovog popisa odgovara s 400 prije bilo kakve naplate.
Example: hr
us— Sjedinjene Američke Države, USD, jezici en, es. Zadana vrijednost.ca— Kanada, CAD, jezici en, fr.gb— Ujedinjeno Kraljevstvo, GBP, jezik en.ie— Irska, EUR, jezik en.de— Njemačka, EUR, jezici de, en.at— Austrija, EUR, jezici de, en.ch— Švicarska, CHF, jezici de, fr, it, en.fr— Francuska, EUR, jezik fr.be— Belgija, EUR, jezici nl, fr, en.nl— Nizozemska, 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— Latvija, EUR, jezici lv, ru, en.lt— Litva, 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— Rumunjska, RON, jezik ro.pt— Portugal, EUR, jezici pt, en.es— Španjolska, 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— Kanarski i Balearski otoci (pošaljite island), EUR, jezici es, en.is— Island, ISK, jezici en, is.
languagestringJezik odgovora, jedan od jezika koje nudi stranica tržišta; zadan je prvi jezik tržišta (hr na hr, de na de). IKEA Hrvatska ima jedan jezik, hrvatski. 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 odgovara s 400.
Example: fr
islandenum<string>Obavezno uz country es_islands (trgovine Kanarskih i Balearskih otoka), inače nije dopušteno: koji otok.
Example: tenerife
tenerife— Tenerife (Kanarski otoci).grancanaria— Gran Canaria (Kanarski otoci).lanzarote— Lanzarote (Kanarski otoci).fuerteventura— Fuerteventura (Kanarski otoci).lapalma— La Palma (Kanarski otoci).lagomera— La Gomera (Kanarski otoci).elhierro— El Hierro (Kanarski otoci).mallorca— Mallorca (Balearski otoci).menorca— Menorca (Balearski otoci).ibiza— Ibiza (Balearski otoci).
category_idstring | string[]Sužavanje na ID kategorije iz facets (parametar f-subcategories), npr. st002 = Biblioteke i regali na hr.
Example: st002
pageintegerdefault:1Stranica rezultata, od 1. IKEA daje prvih 2.000 rezultata popisa i još jednu stranicu, pa (page - 1) x page_size ne smije prijeći 2.000.
Example: 2
page_sizeintegerdefault:24Proizvoda po stranici, 1-100.
Example: 48
sortenum<string>default:relevanceRedoslijed rezultata.
Example: price_asc
relevance— Redoslijed same stranice. Zadano.price_asc— Najjeftinije prvo.price_desc— Najskuplje prvo.newest— Najnoviji proizvodi prvo.rating— Najbolje ocijenjeni prvo.name_asc— Naziv od A do Ž.most_popular— Najpopularniji prvo.
colorstring | string[]ID boje iz facets (parametar f-colors), npr. 10156 = bijela.
Example: 10156
price_bucketstringID cjenovnog raspona iz facets (parametar f-price-buckets), npr. PRICE_0_2000 = 0,00 - 19,99 € na hr.
Example: PRICE_0_5000
new_onlybooleanSamo novi proizvodi.
Example: true
last_chancebooleanSamo proizvodi posljednje prilike (izlaze iz ponude).
Example: true
family_pricebooleanSamo proizvodi s cijenom 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 (razina zalihe, dostava na kućnu adresu) i uključuje availability.
Example: 399
availabilityenum<string>Uz store_id: in_store (na zalihi u robnoj kući, zadano), click_collect ili online.
Example: in_store
in_store— Na zalihi u robnoj kući.click_collect— Dostupno za Click & Collect u robnoj kući.online— Dostupno online.
filtersobjectBilo koji drugi facet prema facets[].parameter, npr. {"f-materials": ["47350"]}. Facete 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 Hrvatska, od najjeftinijeg. Cijene su u EUR; previous_price
# postavljen je na proizvodima s novom nižom cijenom.
r = client.ikea.search(query="kallax", country="hr", 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