IKEA
IKEA Deals API
Egy piac IKEA akciós listáinak egyike: új, alacsonyabb árak, IKEA Family tagsági árak, utolsó esély (kifutó termékek), újdonságok, a legalacsonyabb árú termékcsalád, legnépszerűbb termékek, limitált kiadások, időben korlátozott, csak áruházban érvényes és árengedményes ajánlatok. Minden termék tartalmazza az árat és a korábbi árat a piac pénznemében, az árcímkét és az ár érvényességi dátumait, a kereséssel azonos rendezéssel és szűrőkkel. Az 50 ikea.com piacon és Kínában (ikea.cn). 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/jsontypeenum<string>requiredMelyik akciós lista.
Example: new_lower_price
new_products— Újdonságok.family_price— IKEA Family tagsági árak: a price a tagsági ár, a previous_price a normál ár.new_lower_price— Új, alacsonyabb ár: a previous_price a csökkentés előtti ár, az új ár érvényességi dátumaival.last_chance— Utolsó esély: kifutó termékek.lowest_price— A legalacsonyabb árú termékcsalád.top_seller— Legnépszerűbb termékek.limited_edition— Limitált kiadások.time_restricted— Időben korlátozott ajánlatok.in_store_price_only— Csak az áruházban érvényes árak.reduced_price_offer— Árengedményes ajánlatok.
countrystringdefault:usAz IKEA-piac kisbetűs kóddal (hu az IKEA Magyarországhoz). Ez a végpont ezeket szolgálja ki: 51 piac: az 50 ikea.com piac és Kína (ikea.cn). 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.
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
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")
# Új, alacsonyabb árak az IKEA Magyarországon, a legdrágábbtól, oldalanként 100.
r = client.ikea.deals(type="new_lower_price", country="hu", page_size=100, sort="price_desc")["data"]
print(r["total"], r["currency"])
for i in r["items"][:10]:
print(i["name"], i["type_name"], i["previous_price"], "->", i["price"], i["price_valid_to"])Response