IKEA
IKEA Deals API - promosi dan tawaran
Salah satu senarai tawaran IKEA pasaran: harga rendah baharu, harga ahli IKEA Family, peluang terakhir (produk yang akan dihentikan), produk baharu, julat harga terendah, terlaris, edisi terhad, tawaran terhad masa, harga di kedai sahaja dan tawaran harga dikurangkan. Setiap produk membawa harga dan harga sebelumnya dalam mata wang pasaran, tag harga dan tarikh sah harga, dengan isihan dan penapis yang sama seperti carian. Di 50 pasaran ikea.com dan China (ikea.cn). Kos 1 kredit setiap permintaan.
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>requiredSenarai tawaran yang mana.
Example: new_lower_price
new_products— Produk baharu.family_price— Harga ahli IKEA Family: price ialah harga ahli, previous_price harga biasa.new_lower_price— Harga rendah baharu: previous_price ialah harga sebelum potongan, dengan tarikh sah harga baharu.last_chance— Peluang terakhir: produk yang akan dihentikan.lowest_price— Julat harga terendah.top_seller— Terlaris.limited_edition— Edisi terhad.time_restricted— Tawaran terhad masa.in_store_price_only— Harga yang terpakai di kedai sahaja.reduced_price_offer— Tawaran harga dikurangkan.
countrystringdefault:usPasaran IKEA, sebagai kod huruf kecil. Endpoint ini menyokong 51 pasaran: 50 pasaran ikea.com dan China (ikea.cn). Nama, penerangan dan label dipulangkan dalam bahasa pasaran dan harga dalam mata wangnya, tidak pernah ditukar; respons mengulang country, language dan currency. Pasaran di luar senarai ini menjawab 400 sebelum sebarang caj. Malaysia: my, dalam bahasa Melayu (ms) atau Inggeris (en) dan dalam ringgit (MYR).
Example: my
us— Amerika Syarikat, USD, bahasa en, es. Lalai.ca— Kanada, CAD, bahasa en, fr.gb— United Kingdom, GBP, bahasa en.ie— Ireland, EUR, bahasa en.de— Jerman, EUR, bahasa de, en.at— Austria, EUR, bahasa de, en.ch— Switzerland, CHF, bahasa de, fr, it, en.fr— Perancis, EUR, bahasa fr.be— Belgium, EUR, bahasa nl, fr, en.nl— Belanda, EUR, bahasa nl, en.dk— Denmark, DKK, bahasa da.se— Sweden, SEK, bahasa sv, en.no— Norway, NOK, bahasa no, en.fi— Finland, EUR, bahasa fi, sv, en.ee— Estonia, EUR, bahasa et, ru, en.lv— Latvia, EUR, bahasa lv, ru, en.lt— Lithuania, EUR, bahasa lt, ru, en.pl— Poland, PLN, bahasa pl.cz— Republik Czech, CZK, bahasa cs, en.sk— Slovakia, EUR, bahasa sk.hu— Hungary, HUF, bahasa hu.hr— Croatia, EUR, bahasa hr.si— Slovenia, EUR, bahasa sl.rs— Serbia, RSD, bahasa sr.ro— Romania, RON, bahasa ro.pt— Portugal, EUR, bahasa pt, en.es— Sepanyol, EUR, bahasa es, en, ca, eu, gl.it— Itali, EUR, bahasa it.il— Israel, ILS, bahasa he.ae— Emiriah Arab Bersatu, AED, bahasa ar, en.sa— Arab Saudi, SAR, bahasa ar, en.kw— Kuwait, KWD, bahasa ar, en.qa— Qatar, QAR, bahasa ar, en.bh— Bahrain, BHD, bahasa ar, en.om— Oman, OMR, bahasa ar, en.jo— Jordan, JOD, bahasa ar, en.eg— Mesir, EGP, bahasa ar, en.ma— Maghribi, MAD, bahasa ar, fr, en.in— India, INR, bahasa en.my— Malaysia, MYR, bahasa ms, en.sg— Singapura, SGD, bahasa en.ph— Filipina, PHP, bahasa en.th— Thailand, THB, bahasa th, en.jp— Jepun, JPY, bahasa ja, en.kr— Korea Selatan, KRW, bahasa ko, en.au— Australia, AUD, bahasa en.nz— New Zealand, NZD, bahasa en.mx— Mexico, MXN, bahasa es, en.cl— Chile, CLP, bahasa es.co— Colombia, COP, bahasa es.cn— China (ikea.cn), CNY, bahasa zh, en.
languagestringBahasa respons, salah satu yang disediakan oleh laman pasaran; lalai ialah yang pertama (ms di my, en di us dan sg). my menerima ms atau en. Pasaran berbilang bahasa lain: us en/es, ca en/fr, de dan at de/en, ch de/fr/it/en, be nl/fr/en, es es/en/ca/eu/gl, pasaran Teluk dan Arab ar/en (ma ar/fr/en), th th/en, jp ja/en, kr ko/en, cn zh/en, is en/is. Kod lain menjawab 400. Harga dan mata wang tidak berubah mengikut bahasa.
Example: ms
pageintegerdefault:1Halaman hasil, bermula dari 1. IKEA menyediakan 2,000 hasil pertama sesuatu senarai serta satu halaman lagi, jadi (page - 1) x page_size tidak boleh melebihi 2,000.
Example: 2
page_sizeintegerdefault:24Produk setiap halaman, 1-100.
Example: 48
sortenum<string>default:relevanceSusunan hasil.
Example: price_asc
relevance— Susunan laman itu sendiri. Lalai.price_asc— Paling murah dahulu.price_desc— Paling mahal dahulu.newest— Produk terbaharu dahulu.rating— Penarafan tertinggi dahulu.name_asc— Nama A hingga Z.most_popular— Paling popular dahulu.
colorstring | string[]ID warna daripada facets (parameter f-colors), contohnya 10156 = putih.
Example: 10156
price_bucketstringID julat harga daripada facets (parameter f-price-buckets), contohnya PRICE_0_5000 = 0 hingga 49.99 dalam mata wang pasaran.
Example: PRICE_0_5000
new_onlybooleanProduk baharu sahaja.
Example: true
last_chancebooleanProduk peluang terakhir sahaja (yang akan dihentikan).
Example: true
family_pricebooleanProduk dengan harga ahli IKEA Family sahaja.
Example: true
top_sellerbooleanProduk terlaris sahaja.
Example: true
store_idstring | integerID kedai (stores[].store_id daripada endpoint stores). Menambah ketersediaan setiap produk di kedai itu (tahap stok, penghantaran ke rumah) dan mengaktifkan availability.
Example: 399
availabilityenum<string>Dengan store_id: in_store (ada stok di kedai, lalai), click_collect atau online.
Example: in_store
in_store— Ada stok di kedai.click_collect— Tersedia untuk klik dan ambil di kedai.online— Tersedia dalam talian.
filtersobjectSebarang facet lain, dengan kunci facets[].parameter, contohnya {"f-materials": ["47350"]}. Facet boolean menerima true.
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# Harga rendah baharu di IKEA Malaysia, paling mahal dahulu, 100 setiap halaman.
r = client.ikea.deals(type="new_lower_price", country="my", language="ms", 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_from"])Response