IKEA
宜家商品批量查询 API
在一个市场中一次查询最多 100 个宜家商品编号,每件商品返回与搜索相同的字段:名称、类型、设计、以该市场货币计的价格和降价前价格、价格标签及有效期、评分、变体和品类路径。该市场不销售的编号列在 not_found 中。这是重新获取关注列表价格最快的方式。支持 ikea.com 的 50 个市场和中国(ikea.cn)。每次请求消耗 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_nosstring[] | stringrequired1 到 100 个商品编号,数组或逗号分隔的字符串。
Example: ["59545297", "90522038"]
countrystringdefault:us宜家市场,小写代码。本接口支持51 个市场(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。
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
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# 重新获取宜家中国关注列表的价格:最多 100 个编号只需 1 积分。
r = client.ikea.items(item_nos=["59545297", "90522038", "00522047"], country="cn")["data"]
for i in r["items"]:
print(i["item_no"], i["name"], i["type_name"], i["measure_text"], i["price"], r["currency"])
print("宜家中国未销售:", r["not_found"])Response