IKEA
宜家商品详情 API
按商品编号或商品页面网址获取一件宜家商品,支持 55 个市场:名称、类型、描述、价格和降价前价格及其有效期、IKEA Family 会员价、货币、颜色、材料、品类、尺寸、图片、评分、评分数和分项评分、测量数据、材料明细、保养说明、须知、安全提示、包装(包裹数及每个包裹的尺寸和重量)、组装说明书和使用手册的 PDF 链接、设计师、颜色和尺寸变体及其价格、最新 3 条评价和退货政策。宜家中国(ikea.cn)返回中文的测量数据、材料、保养、包装、组装说明书和系列。单次商品请求最长可能需要约 100 秒。每次请求消耗 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/jsonitem_nostring | integer宜家商品编号:8 位数字,可带点(595.452.97)。item_no 和 url 二选一。
Example: 59545297
urlstring受支持市场的宜家商品页面,可替代 item_no;市场和语言从网址中读取,宜家中国为 www.ikea.cn/cn/zh/p/...。
Example: https://www.ikea.cn/cn/zh/p/billy-bi-li-shu-gui-dai-chou-ti-bai-se-s59545297/
countrystringdefault:us宜家市场,小写代码。本接口支持55 个市场(ikea.com 的 50 个市场、中国 ikea.cn、波多黎各、多米尼加共和国、加那利群岛和巴利阿里群岛、冰岛)。默认值是 us,查询宜家中国(ikea.cn)请务必传 "country": "cn"。名称、描述和标签以该市场的语言返回,价格以该市场的货币返回,不做换算;响应会回显 country、language 和 currency。不在列表中的市场在扣费前返回 400。
Example: cn
us— 美国,USD,语言 en, es。默认值。ca— 加拿大,CAD,语言 en, fr。gb— 英国,GBP,语言 en。ie— 爱尔兰,EUR,语言 en。de— 德国,EUR,语言 de, en。at— 奥地利,EUR,语言 de, en。ch— 瑞士,CHF,语言 de, fr, it, en。fr— 法国,EUR,语言 fr。be— 比利时,EUR,语言 nl, fr, en。nl— 荷兰,EUR,语言 nl, en。dk— 丹麦,DKK,语言 da。se— 瑞典,SEK,语言 sv, en。no— 挪威,NOK,语言 no, en。fi— 芬兰,EUR,语言 fi, sv, en。ee— 爱沙尼亚,EUR,语言 et, ru, en。lv— 拉脱维亚,EUR,语言 lv, ru, en。lt— 立陶宛,EUR,语言 lt, ru, en。pl— 波兰,PLN,语言 pl。cz— 捷克,CZK,语言 cs, en。sk— 斯洛伐克,EUR,语言 sk。hu— 匈牙利,HUF,语言 hu。hr— 克罗地亚,EUR,语言 hr。si— 斯洛文尼亚,EUR,语言 sl。rs— 塞尔维亚,RSD,语言 sr。ro— 罗马尼亚,RON,语言 ro。pt— 葡萄牙,EUR,语言 pt, en。es— 西班牙,EUR,语言 es, en, ca, eu, gl。it— 意大利,EUR,语言 it。il— 以色列,ILS,语言 he。ae— 阿联酋,AED,语言 ar, en。sa— 沙特阿拉伯,SAR,语言 ar, en。kw— 科威特,KWD,语言 ar, en。qa— 卡塔尔,QAR,语言 ar, en。bh— 巴林,BHD,语言 ar, en。om— 阿曼,OMR,语言 ar, en。jo— 约旦,JOD,语言 ar, en。eg— 埃及,EGP,语言 ar, en。ma— 摩洛哥,MAD,语言 ar, fr, en。in— 印度,INR,语言 en。my— 马来西亚,MYR,语言 ms, en。sg— 新加坡,SGD,语言 en。ph— 菲律宾,PHP,语言 en。th— 泰国,THB,语言 th, en。jp— 日本,JPY,语言 ja, en。kr— 韩国,KRW,语言 ko, en。au— 澳大利亚,AUD,语言 en。nz— 新西兰,NZD,语言 en。mx— 墨西哥,MXN,语言 es, en。cl— 智利,CLP,语言 es。co— 哥伦比亚,COP,语言 es。cn— 中国(ikea.cn),CNY,语言 zh, en。pr— 波多黎各,USD,语言 en, es。do— 多米尼加共和国,DOP,语言 es, en。es_islands— 加那利群岛和巴利阿里群岛(需传 island),EUR,语言 es, en。is— 冰岛,ISK,语言 en, is。
languagestring响应语言,须为该市场网站提供的语言;默认是市场的第一种语言(cn 为 zh,us 为 en,de 为 de)。多语言市场:cn zh/en、jp ja/en、kr ko/en、th th/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)、my ms/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— 伊维萨岛(巴利阿里群岛)。
Request
from scavio import ScavioClient
# 商品请求最长可能需要约 100 秒:超时设为 120 秒。
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# 宜家中国 BILLY 毕利 书柜,带抽屉(59545297)
p = client.ikea.product(item_no="59545297", country="cn")["data"]
print(p["full_name"], p["price"], p["currency"])
for m in p["measurements"]:
print(m["name"], m["value"])
print(p["packaging"]["number_of_packages"], "个包裹")Response