IKEA
API ค้นหาสินค้า IKEA
ค้นหาสินค้า IKEA ด้วยคีย์เวิร์ดใน 55 ตลาด ตลาด ikea.com 50 แห่งและจีน (ikea.cn) ให้ผลลัพธ์ครบ หน้าละ 24 รายการเป็นค่าเริ่มต้น (สูงสุด 100) พร้อมการเรียงลำดับ 7 แบบ และตัวกรองสี ช่วงราคา หมวดหมู่ สินค้าใหม่ โอกาสสุดท้าย ราคา IKEA Family สินค้าขายดี สถานะที่สาขา หรือ facet ใดก็ได้ สินค้าแต่ละรายการมีรหัสสินค้า ชื่อ ประเภท ดีไซน์ ราคาและราคาก่อนลดในสกุลเงินของตลาด ป้ายราคา คะแนน ตัวเลือกสินค้า และเส้นทางหมวดหมู่ พร้อม facets, did_you_mean, คำค้นที่เกี่ยวข้อง และการ์ดเนื้อหา เว็บไซต์แฟรนไชส์ (เปอร์โตริโก สาธารณรัฐโดมินิกัน หมู่เกาะคานารีและแบลีแอริก ไอซ์แลนด์) รองรับเฉพาะ query และ page ใช้ 1 เครดิตต่อคำขอ
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/jsonquerystringrequiredคีย์เวิร์ดค้นหา 1-200 ตัวอักษร เป็นภาษาใดก็ได้ที่ตลาดนั้นรองรับ ใช้รหัสสินค้าก็ได้
Example: kallax
countrystringdefault:usตลาด IKEA เป็นรหัสตัวพิมพ์เล็ก เอนด์พอยต์นี้รองรับ55 ตลาด (ตลาด ikea.com 50 แห่ง, จีน ikea.cn, เปอร์โตริโก, สาธารณรัฐโดมินิกัน, หมู่เกาะคานารีและแบลีแอริก และไอซ์แลนด์) ค่าเริ่มต้นคือ us ดังนั้นสำหรับ IKEA ประเทศไทยต้องส่ง "country": "th" ทุกครั้ง ชื่อสินค้า คำอธิบาย และป้ายกำกับจะส่งกลับเป็นภาษาของตลาดนั้น ราคาเป็นสกุลเงินของตลาดนั้นโดยไม่แปลงค่า และคำตอบจะระบุ country, language และ currency กลับมาด้วย ตลาดที่ไม่อยู่ในรายการจะได้ 400 ก่อนมีการคิดเครดิต
Example: th
us— สหรัฐอเมริกา, USD, ภาษา en, es ค่าเริ่มต้นca— แคนาดา, CAD, ภาษา en, frgb— สหราชอาณาจักร, GBP, ภาษา enie— ไอร์แลนด์, EUR, ภาษา ende— เยอรมนี, EUR, ภาษา de, enat— ออสเตรีย, EUR, ภาษา de, ench— สวิตเซอร์แลนด์, CHF, ภาษา de, fr, it, enfr— ฝรั่งเศส, EUR, ภาษา frbe— เบลเยียม, EUR, ภาษา nl, fr, ennl— เนเธอร์แลนด์, EUR, ภาษา nl, endk— เดนมาร์ก, DKK, ภาษา dase— สวีเดน, SEK, ภาษา sv, enno— นอร์เวย์, NOK, ภาษา no, enfi— ฟินแลนด์, EUR, ภาษา fi, sv, enee— เอสโตเนีย, EUR, ภาษา et, ru, enlv— ลัตเวีย, EUR, ภาษา lv, ru, enlt— ลิทัวเนีย, EUR, ภาษา lt, ru, enpl— โปแลนด์, PLN, ภาษา plcz— เช็กเกีย, CZK, ภาษา cs, ensk— สโลวาเกีย, EUR, ภาษา skhu— ฮังการี, HUF, ภาษา huhr— โครเอเชีย, EUR, ภาษา hrsi— สโลวีเนีย, EUR, ภาษา slrs— เซอร์เบีย, RSD, ภาษา srro— โรมาเนีย, RON, ภาษา ropt— โปรตุเกส, EUR, ภาษา pt, enes— สเปน, EUR, ภาษา es, en, ca, eu, glit— อิตาลี, EUR, ภาษา itil— อิสราเอล, ILS, ภาษา heae— สหรัฐอาหรับเอมิเรตส์, AED, ภาษา ar, ensa— ซาอุดีอาระเบีย, SAR, ภาษา ar, enkw— คูเวต, KWD, ภาษา ar, enqa— กาตาร์, QAR, ภาษา ar, enbh— บาห์เรน, BHD, ภาษา ar, enom— โอมาน, OMR, ภาษา ar, enjo— จอร์แดน, JOD, ภาษา ar, eneg— อียิปต์, EGP, ภาษา ar, enma— โมร็อกโก, MAD, ภาษา ar, fr, enin— อินเดีย, INR, ภาษา enmy— มาเลเซีย, MYR, ภาษา ms, ensg— สิงคโปร์, SGD, ภาษา enph— ฟิลิปปินส์, PHP, ภาษา enth— ไทย, THB, ภาษา th, enjp— ญี่ปุ่น, JPY, ภาษา ja, enkr— เกาหลีใต้, KRW, ภาษา ko, enau— ออสเตรเลีย, AUD, ภาษา ennz— นิวซีแลนด์, NZD, ภาษา enmx— เม็กซิโก, MXN, ภาษา es, encl— ชิลี, CLP, ภาษา esco— โคลอมเบีย, COP, ภาษา escn— จีน (ikea.cn), CNY, ภาษา zh, enpr— เปอร์โตริโก, USD, ภาษา en, esdo— สาธารณรัฐโดมินิกัน, DOP, ภาษา es, enes_islands— หมู่เกาะคานารีและหมู่เกาะแบลีแอริก (ต้องส่ง island), EUR, ภาษา es, enis— ไอซ์แลนด์, ISK, ภาษา en, is
languagestringภาษาของคำตอบ ต้องเป็นภาษาที่เว็บไซต์ของตลาดนั้นมีให้ ค่าเริ่มต้นคือภาษาแรกของตลาด (th ใช้ th, us ใช้ en, de ใช้ de) ตลาดที่มีหลายภาษา: th th/en, jp ja/en, kr ko/en, cn zh/en, my ms/en, us en/es, ca en/fr, de และ 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, ตลาดอ่าวอาหรับและอาหรับ ar/en (ma ar/fr/en), mx es/en, pr en/es, do และ es_islands es/en, is en/is ตลาดอื่นมีภาษาเดียว รหัสอื่นจะได้ 400
Example: en
islandenum<string>จำเป็นเฉพาะเมื่อ country เป็น es_islands (ร้านบนหมู่เกาะคานารีและแบลีแอริกของสเปน) และใช้กับตลาดอื่นไม่ได้ ใช้ระบุว่าเป็นร้านของเกาะใด
Example: tenerife
tenerife— เตเนริเฟ (หมู่เกาะคานารี)grancanaria— กรานคานาเรีย (หมู่เกาะคานารี)lanzarote— ลันซาโรเต (หมู่เกาะคานารี)fuerteventura— ฟวยร์เตเบนตูรา (หมู่เกาะคานารี)lapalma— ลาปัลมา (หมู่เกาะคานารี)lagomera— ลาโกเมรา (หมู่เกาะคานารี)elhierro— เอลเอียร์โร (หมู่เกาะคานารี)mallorca— มายอร์กา (หมู่เกาะแบลีแอริก)menorca— เมนอร์กา (หมู่เกาะแบลีแอริก)ibiza— อิบิซา (หมู่เกาะแบลีแอริก)
category_idstring | string[]จำกัดผลลัพธ์ด้วยรหัสหมวดหมู่จาก facets (parameter f-subcategories) เช่น st002
Example: st002
pageintegerdefault:1หน้าผลลัพธ์ เริ่มที่ 1 IKEA ให้ผลลัพธ์ 2,000 รายการแรกของรายการบวกอีกหนึ่งหน้า ดังนั้น (page - 1) x page_size ต้องไม่เกิน 2,000
Example: 2
page_sizeintegerdefault:24จำนวนสินค้าต่อหน้า 1-100
Example: 48
sortenum<string>default:relevanceลำดับผลลัพธ์
Example: price_asc
relevance— ลำดับตามเว็บไซต์ ค่าเริ่มต้นprice_asc— ราคาถูกไปแพงprice_desc— ราคาแพงไปถูกnewest— สินค้าใหม่ล่าสุดก่อนrating— คะแนนสูงสุดก่อนname_asc— ชื่อ A ถึง Zmost_popular— ยอดนิยมก่อน
colorstring | string[]รหัสสีจาก facets (parameter f-colors) เช่น 10156 = ขาว
Example: 10156
price_bucketstringรหัสช่วงราคาจาก facets (parameter f-price-buckets) เช่น ในไทย PRICE_100000_200000 = ฿1,000 - 1,999 (รหัสต่างกันในแต่ละตลาด ให้นำมาจาก facets)
Example: PRICE_100000_200000
new_onlybooleanเฉพาะสินค้าใหม่
Example: true
last_chancebooleanเฉพาะสินค้าโอกาสสุดท้าย (กำลังจะเลิกจำหน่าย)
Example: true
family_pricebooleanเฉพาะสินค้าที่มีราคาสมาชิก IKEA Family
Example: true
top_sellerbooleanเฉพาะสินค้าขายดี
Example: true
store_idstring | integerรหัสสาขา (stores[].store_id จากเอนด์พอยต์ stores) จะเพิ่มสถานะสินค้าของแต่ละรายการที่สาขานั้น (ระดับสต็อก การจัดส่ง) และเปิดใช้ availability
Example: STORE_ID
availabilityenum<string>ใช้คู่กับ store_id: in_store (มีสต็อกที่สาขา ค่าเริ่มต้น), click_collect หรือ online
Example: in_store
in_store— มีสต็อกที่สาขาclick_collect— สั่งออนไลน์แล้วรับที่สาขาได้online— ซื้อออนไลน์ได้
filtersobjectตัวกรอง facet อื่นๆ โดยใช้ facets[].parameter เป็นคีย์ เช่น {"f-materials": ["47350"]} facet แบบ boolean ใช้ค่า true
Example: {"f-materials": ["47350"]}
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# ค้นหา KALLAX ใน IKEA ประเทศไทย เรียงจากราคาถูกไปแพง ราคาเป็นบาท
# สินค้าที่มีโปรโมชั่นจะมี previous_price และ price_valid_to
r = client.ikea.search(query="kallax", country="th", 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"], i["price_valid_to"])Response