IKEA
IKEA Search API - carian produk
Cari produk IKEA dengan kata kunci di mana-mana 55 pasaran: 50 pasaran ikea.com dan China (ikea.cn) memulangkan grid penuh, 24 produk setiap halaman secara lalai (hingga 100), dengan tujuh isihan dan penapis untuk warna, julat harga, kategori, baharu, peluang terakhir, harga IKEA Family, terlaris, ketersediaan di kedai atau sebarang facet. Setiap produk mempunyai nombor artikel, nama, jenis, reka bentuk, harga dan harga sebelumnya dalam mata wang pasaran, tag harga (harga rendah baharu, harga IKEA Family ...), penarafan, varian dan laluan kategori, serta facets, did-you-mean, carian berkaitan dan kad kandungan. Laman francais (Puerto Rico, Republik Dominika, Kepulauan Canary dan Balearic, Iceland) menerima query dan page sahaja. 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/jsonquerystringrequiredKata kunci carian, 1-200 aksara, dalam mana-mana bahasa yang disediakan pasaran ("kallax" atau "rak buku"). Nombor artikel juga boleh.
Example: kallax
countrystringdefault:usPasaran IKEA, sebagai kod huruf kecil. Endpoint ini menyokong 55 pasaran: 50 pasaran ikea.com, China (ikea.cn), Puerto Rico, Republik Dominika, Kepulauan Canary dan Balearic serta Iceland. 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.pr— Puerto Rico, USD, bahasa en, es.do— Republik Dominika, DOP, bahasa es, en.es_islands— Kepulauan Canary dan Balearic (hantar island), EUR, bahasa es, en.is— Iceland, ISK, bahasa en, is.
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
islandenum<string>Wajib dengan country es_islands sahaja (kedai Kepulauan Canary dan Balearic), tidak dibenarkan di pasaran lain: kedai pulau yang mana.
Example: tenerife
tenerife— Tenerife (Kepulauan Canary).grancanaria— Gran Canaria (Kepulauan Canary).lanzarote— Lanzarote (Kepulauan Canary).fuerteventura— Fuerteventura (Kepulauan Canary).lapalma— La Palma (Kepulauan Canary).lagomera— La Gomera (Kepulauan Canary).elhierro— El Hierro (Kepulauan Canary).mallorca— Mallorca (Kepulauan Balearic).menorca— Menorca (Kepulauan Balearic).ibiza— Ibiza (Kepulauan Balearic).
category_idstring | string[]Hadkan kepada ID kategori daripada facets (parameter f-subcategories), contohnya st002.
Example: st002
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")
# KALLAX di IKEA Malaysia dalam bahasa Melayu, paling murah dahulu. Harga dalam ringgit; previous_price ada apabila terdapat harga rendah baharu.
r = client.ikea.search(query="kallax", country="my", language="ms", 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