IKEA
IKEA Search API
IKEA termékek keresése kulcsszóra az 55 piac bármelyikén: az 50 ikea.com piac és Kína (ikea.cn) a teljes rácsot adja, alapértelmezés szerint oldalanként 24 terméket (legfeljebb 100), hétféle rendezéssel és szűrőkkel szín, ársáv, kategória, újdonság, utolsó esély, IKEA Family ár, legnépszerűbb, áruházi elérhetőség vagy bármely facet szerint. Minden termék tartalmazza a cikkszámot, nevet, típust, dizájnt, az árat és a korábbi árat a piac pénznemében, az árcímkét (új, alacsonyabb ár, IKEA Family ár ...), az értékelést, a változatokat és a kategóriautat, mellette facetek, did_you_mean, kapcsolódó keresések és tartalomkártyák. A franchise oldalak (Puerto Rico, Dominikai Köztársaság, Kanári- és Baleár-szigetek, Izland) csak query és page paramétert fogadnak. Kérésenként 1 kredit.
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/jsonquerystringrequiredKeresőszavak, 1-200 karakter, a piac bármely nyelvén. Cikkszám is működik.
Example: kallax
countrystringdefault:usAz IKEA-piac kisbetűs kóddal (hu az IKEA Magyarországhoz). Ez a végpont ezeket szolgálja ki: 55 piac: az 50 ikea.com piac, Kína (ikea.cn), Puerto Rico, a Dominikai Köztársaság, a Kanári- és Baleár-szigetek és Izland. A nevek, leírások és címkék a piac nyelvén, az árak a piac pénznemében érkeznek, soha nincsenek átváltva; a válasz visszaadja a country, language és currency mezőt. A listán kívüli piac 400-at ad, mielőtt bármit felszámolnánk.
Example: hu
us— Egyesült Államok, USD, nyelvek en, es. Az alapértelmezés.ca— Kanada, CAD, nyelvek en, fr.gb— Egyesült Királyság, GBP, nyelv en.ie— Írország, EUR, nyelv en.de— Németország, EUR, nyelvek de, en.at— Ausztria, EUR, nyelvek de, en.ch— Svájc, CHF, nyelvek de, fr, it, en.fr— Franciaország, EUR, nyelv fr.be— Belgium, EUR, nyelvek nl, fr, en.nl— Hollandia, EUR, nyelvek nl, en.dk— Dánia, DKK, nyelv da.se— Svédország, SEK, nyelvek sv, en.no— Norvégia, NOK, nyelvek no, en.fi— Finnország, EUR, nyelvek fi, sv, en.ee— Észtország, EUR, nyelvek et, ru, en.lv— Lettország, EUR, nyelvek lv, ru, en.lt— Litvánia, EUR, nyelvek lt, ru, en.pl— Lengyelország, PLN, nyelv pl.cz— Csehország, CZK, nyelvek cs, en.sk— Szlovákia, EUR, nyelv sk.hu— Magyarország, HUF, nyelv hu.hr— Horvátország, EUR, nyelv hr.si— Szlovénia, EUR, nyelv sl.rs— Szerbia, RSD, nyelv sr.ro— Románia, RON, nyelv ro.pt— Portugália, EUR, nyelvek pt, en.es— Spanyolország, EUR, nyelvek es, en, ca, eu, gl.it— Olaszország, EUR, nyelv it.il— Izrael, ILS, nyelv he.ae— Egyesült Arab Emírségek, AED, nyelvek ar, en.sa— Szaúd-Arábia, SAR, nyelvek ar, en.kw— Kuvait, KWD, nyelvek ar, en.qa— Katar, QAR, nyelvek ar, en.bh— Bahrein, BHD, nyelvek ar, en.om— Omán, OMR, nyelvek ar, en.jo— Jordánia, JOD, nyelvek ar, en.eg— Egyiptom, EGP, nyelvek ar, en.ma— Marokkó, MAD, nyelvek ar, fr, en.in— India, INR, nyelv en.my— Malajzia, MYR, nyelvek ms, en.sg— Szingapúr, SGD, nyelv en.ph— Fülöp-szigetek, PHP, nyelv en.th— Thaiföld, THB, nyelvek th, en.jp— Japán, JPY, nyelvek ja, en.kr— Dél-Korea, KRW, nyelvek ko, en.au— Ausztrália, AUD, nyelv en.nz— Új-Zéland, NZD, nyelv en.mx— Mexikó, MXN, nyelvek es, en.cl— Chile, CLP, nyelv es.co— Kolumbia, COP, nyelv es.cn— Kína (ikea.cn), CNY, nyelvek zh, en.pr— Puerto Rico, USD, nyelvek en, es.do— Dominikai Köztársaság, DOP, nyelvek es, en.es_islands— Kanári- és Baleár-szigetek (küldje az island mezőt), EUR, nyelvek es, en.is— Izland, ISK, nyelvek en, is.
languagestringA válasz nyelve, a piac oldala által kínált nyelvek egyike; az alapértelmezés a piac első nyelve (hu a hu piacon, de a de piacon). Az IKEA Magyarország egynyelvű: magyar. Többnyelvű piacok: us en/es, ca en/fr, de és 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, az arab piacok 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 és es_islands es/en, is en/is. Más kód 400-at ad.
Example: fr
islandenum<string>Kötelező a country es_islands mellett (a Kanári- és Baleár-szigetek áruházai), máshol nem engedélyezett: melyik sziget.
Example: tenerife
tenerife— Tenerife (Kanári-szigetek).grancanaria— Gran Canaria (Kanári-szigetek).lanzarote— Lanzarote (Kanári-szigetek).fuerteventura— Fuerteventura (Kanári-szigetek).lapalma— La Palma (Kanári-szigetek).lagomera— La Gomera (Kanári-szigetek).elhierro— El Hierro (Kanári-szigetek).mallorca— Mallorca (Baleár-szigetek).menorca— Menorca (Baleár-szigetek).ibiza— Ibiza (Baleár-szigetek).
category_idstring | string[]Szűkítés kategória azonosító(k)ra a facets mezőből (f-subcategories paraméter), pl. st002 = Könyvespolcok és polcos elemek a hu piacon.
Example: st002
pageintegerdefault:1Találati oldal, 1-től. Az IKEA egy lista első 2 000 találatát és még egy oldalt ad ki, így a (page - 1) x page_size nem lehet több 2 000-nél.
Example: 2
page_sizeintegerdefault:24Termék oldalanként, 1-100.
Example: 48
sortenum<string>default:relevanceA találatok sorrendje.
Example: price_asc
relevance— Az oldal saját sorrendje. Alapértelmezés.price_asc— Legolcsóbb elöl.price_desc— Legdrágább elöl.newest— Legújabb termékek elöl.rating— Legjobbra értékelt elöl.name_asc— Név szerint A-tól Z-ig.most_popular— Legnépszerűbb elöl.
colorstring | string[]Szín azonosító(k) a facets mezőből (f-colors paraméter), pl. 10156 = fehér.
Example: 10156
price_bucketstringÁrsáv azonosító a facets mezőből (f-price-buckets paraméter), pl. PRICE_0_1000000 = 0 - 9 999 Ft a hu piacon.
Example: PRICE_0_5000
new_onlybooleanCsak új termékek.
Example: true
last_chancebooleanCsak utolsó esély termékek (kifutó termékek).
Example: true
family_pricebooleanCsak IKEA Family tagsági árú termékek.
Example: true
top_sellerbooleanCsak a legnépszerűbb termékek.
Example: true
store_idstring | integerÁruház azonosító (a stores végpont stores[].store_id mezője). Hozzáadja minden termék elérhetőségét abban az áruházban (készletszint, házhozszállítás), és bekapcsolja az availability paramétert.
Example: 399
availabilityenum<string>store_id mellett: in_store (készleten az áruházban, alapértelmezés), click_collect vagy online.
Example: in_store
in_store— Készleten az áruházban.click_collect— Click & Collect átvétellel elérhető az áruházban.online— Online elérhető.
filtersobjectBármely más facet a facets[].parameter kulcsával, pl. {"f-materials": ["47350"]}. Az igen/nem facet true értéket kap.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# KALLAX az IKEA Magyarországon, a legolcsóbbtól. Az árak forintban vannak; a previous_price
# az új, alacsonyabb árú termékeknél van kitöltve.
r = client.ikea.search(query="kallax", country="hu", 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