要获取宜家中国（ikea.cn）的价格，在 Scavio 宜家 API 的请求里传 "country": "cn" 即可。先用 /api/v1/ikea/search 找到 8 位商品编号和人民币价格，再用 /api/v1/ikea/items 一次重新获取最多 100 个编号的价格，用 /api/v1/ikea/deals 获取新品和优惠列表。宜家中国可用 6 个接口，每次调用 1 积分。
以下响应全部来自 2026-11-13 对宜家中国的实际调用，省略了图片网址等部分字段，数值未做任何修改。价格是人民币数字，399 加 "currency": "CNY" 即 399 元。密钥在 Scavio 控制台注册后即可获取，注册送 50 积分。
第 1 步：找到商品编号
curl -s https://api.scavio.dev/api/v1/ikea/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "billy", "country": "cn", "language": "zh"}'宜家中国搜索 billy 共 129 件，每页 24 件。只保留第一件：
{
"query": "billy",
"total": 129,
"page": 1,
"count": 24,
"items": [
{
"item_no": "59545297",
"item_no_global": "29570373",
"is_combination": true,
"name": "BILLY 毕利",
"type_name": "书柜，带抽屉",
"design": "白色",
"measure_text": "80x30x106 厘米",
"url": "https://www.ikea.cn/cn/zh/p/billy-bi-li-shu-gui-dai-chou-ti-bai-se-s59545297/",
"price": 499,
"previous_price": null,
"price_tag": "none",
"rating": null,
"rating_count": null,
"online_sellable": true
}
],
"country": "cn",
"language": "zh",
"currency": "CNY"
}item_no 是宜家中国的编号，item_no_global 是全球编号。is_combination: true 表示这是一个有独立编号的组合。宜家中国的结果没有评分，rating 为 null。search 支持 page、page_size（最多 100）、7 种 sort，以及 color、price_bucket、new_only、last_chance、family_price、top_seller 筛选和 facets。1 积分，这次用时 8.2 秒。
第 2 步：读取商品详情
curl -s https://api.scavio.dev/api/v1/ikea/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"item_no": "59545297", "country": "cn"}'BILLY 毕利 书柜，带抽屉的详情，省略了描述、图片、材料、保养、须知，测量数据保留 3 项：
{
"item_no": "59545297",
"article_number": "595.452.97",
"name": "BILLY 毕利",
"full_name": "书柜，带抽屉, 白色, 80x30x106 厘米",
"type_name": "书柜，带抽屉",
"design": "白色",
"measure_text": "80x30x106 厘米",
"url": "https://www.ikea.cn/cn/zh/p/billy-bi-li-shu-gui-dai-chou-ti-bai-se-s59545297/",
"price": 499,
"previous_price": null,
"currency": "CNY",
"price_tag": "none",
"measurements": [
{
"name": "宽度",
"value": "80 厘米"
},
{
"name": "深度",
"value": "30 厘米"
},
{
"name": "高度",
"value": "106 厘米"
}
],
"packaging": {
"number_of_packages": 2,
"packages": [
{
"item_no": "70522044",
"name": "BILLY 毕利",
"type_name": "书架",
"quantity": 1,
"dimensions": [
{
"package_number": "1",
"length": "108 厘米",
"width": "29 厘米",
"height": "15 厘米",
"weight": "22.70 公斤"
}
]
},
{
"item_no": "00521694",
"name": "BILLY 毕利",
"type_name": "抽屉",
"quantity": 1,
"dimensions": [
{
"package_number": "1",
"length": "85 厘米",
"width": "35 厘米",
"height": "6 厘米",
"weight": "8.00 公斤"
}
]
}
]
},
"detail_level": "full",
"country": "cn",
"language": "zh"
}这个组合分 2 个包裹：书架 22.70 公斤，抽屉 8.00 公斤。详情还返回 7 项测量数据（如每块搁板最大可承重 30 公斤）、按部件列出的材料和保养说明。宜家中国的详情字段比 ikea.com 市场少，这个样本没有组装说明书和设计师。样本用时 6.5 秒，同日其他宜家中国详情用时约 40 秒，最长可能约 100 秒，请把超时设为 120 秒。也可以传商品页 url 代替 item_no。1 积分。
第 3 步：一次查询 100 个编号
curl -s https://api.scavio.dev/api/v1/ikea/items \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"item_nos": ["59545297", "90522038", "80275887"], "country": "cn"}'三个编号中两个找到，欧洲 KALLAX 的编号 80275887 宜家中国没有，列在 not_found。只保留第一件：
{
"count": 2,
"items": [
{
"item_no": "59545297",
"item_no_global": "29570373",
"is_combination": true,
"name": "BILLY 毕利",
"type_name": "书柜，带抽屉",
"design": "白色",
"measure_text": "80x30x106 厘米",
"url": "https://www.ikea.cn/cn/zh/p/billy-bi-li-shu-gui-dai-chou-ti-bai-se-s59545297/",
"price": 499,
"previous_price": null,
"price_tag": "none",
"rating": null,
"rating_count": null,
"online_sellable": true
}
],
"not_found": [
"80275887"
],
"country": "cn",
"language": "zh",
"currency": "CNY"
}item_nos 可传 1 到 100 个编号，列表或逗号分隔字符串都行，带点的写法（905.220.38）也可以。不管查几个都是 1 积分，所以每天监控价格时用 items 比逐个调用 product 更合适。宜家中国的 BILLY 书架 80x28x202 厘米（00522047）是 399 元；同日宜家日本用同一编号卖 8,999 日元，其全球编号 20522046 在宜家美国是 79 美元。API 不做汇率换算。
第 4 步：获取新品和优惠列表
curl -s https://api.scavio.dev/api/v1/ikea/deals \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type": "new_products", "country": "cn"}'宜家中国当天的新品列表共 1,756 件、74 页。保留前 3 件：
{
"type": "new_products",
"total": 1756,
"page": 1,
"total_pages": 74,
"items": [
{
"item_no": "00328229",
"name": "HALVED 哈尔维",
"type_name": "平织地毯",
"measure_text": "170x240 厘米",
"price": 1299,
"previous_price": null,
"price_tag": "new_product"
},
{
"item_no": "00477356",
"name": "BILLY 毕利",
"type_name": "搁板",
"measure_text": "76x26 厘米",
"price": 50,
"previous_price": null,
"price_tag": "new_product"
},
{
"item_no": "50561116",
"name": "STORKLINTA 斯图林塔",
"type_name": "三斗抽屉柜",
"measure_text": "70x50x75 厘米",
"price": 699,
"previous_price": null,
"price_tag": "new_product"
}
],
"country": "cn",
"currency": "CNY"
}type 可选 new_products、new_lower_price、family_price、last_chance、lowest_price、top_seller、limited_edition、time_restricted、in_store_price_only 和 reduced_price_offer 共 10 种。降价类列表会返回降价前价格（previous_price）和有效期（price_valid_from、price_valid_to）；family_price 中 price 是 IKEA Family 会员价，previous_price 是普通价格。page_size 最多 100。1 积分。
第 5 步：按品类浏览
curl -s https://api.scavio.dev/api/v1/ikea/category \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id": "10382", "country": "cn"}'书柜（10382）共 127 件、6 页。保留前 2 件：
{
"category": {
"id": "10382",
"name": "书柜",
"url": "https://www.ikea.cn/cn/zh/cat/shu-gui-10382/"
},
"total": 127,
"page": 1,
"total_pages": 6,
"items": [
{
"item_no": "90525273",
"name": "BILLY 毕利",
"type_name": "搁板",
"measure_text": "76x26 厘米",
"price": 50,
"previous_price": null,
"price_tag": "none"
},
{
"item_no": "90522038",
"name": "BILLY 毕利",
"type_name": "书架",
"measure_text": "40x28x106 厘米",
"price": 199,
"previous_price": null,
"price_tag": "none"
}
],
"country": "cn",
"currency": "CNY"
}也可以传品类页的 url，并使用与搜索相同的排序和筛选，例如 "sort": "price_asc"。品类 ID 来自搜索结果的 category_path（宜家中国的书柜路径是 st001 储物家具、st002 书柜和置物架、10382 书柜）。品类树接口不支持 cn。1 积分。
第 6 步：搜索建议
curl -s https://api.scavio.dev/api/v1/ikea/suggestions \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "bil", "country": "cn"}'输入 bil 返回 8 条建议，保留前 4 条：
{
"query": "bil",
"count": 8,
"suggestions": [
{
"text": "billy 毕 利",
"type": "completion",
"label": "搜索",
"category_id": null
},
{
"text": "bild 拜 尔 德",
"type": "completion",
"label": "搜索",
"category_id": null
},
{
"text": "billy 毕 利 黑色",
"type": "completion",
"label": "搜索",
"category_id": null
},
{
"text": "BILLY 毕利门板",
"type": "category",
"label": "分类筛选",
"category_id": "58290"
}
],
"country": "cn",
"language": "zh"
}type 为 completion 的是关键词补全，category 的带有 category_id，可直接传给第 5 步。1 积分。
第 7 步：每天记录人民币价格
import requests, json, datetime
API = "https://api.scavio.dev/api/v1/ikea"
HEADERS = {"Authorization": "Bearer YOUR_SCAVIO_API_KEY"}
WATCH = ["00522047", "90522038", "70522044", "59545297", "80579761"] # 宜家中国编号，最多 100 个
d = requests.post(f"{API}/items", headers=HEADERS, timeout=120,
json={"item_nos": WATCH, "country": "cn"}).json()["data"]
today = datetime.date.today().isoformat()
rows = [{"date": today, "item_no": it["item_no"], "name": it["name"], "type_name": it["type_name"],
"price": it["price"], "previous_price": it["previous_price"], "price_tag": it["price_tag"]}
for it in d["items"]]
rows += [{"date": today, "item_no": no, "price": None} for no in d["not_found"]]
with open(f"ikea-cn-prices-{today}.json", "w") as f:
json.dump(rows, f, ensure_ascii=False)每天一次，每月约 30 积分。降价前价格只在降价期间显示，所以按日期保存的文件才能告诉你价格何时变动。遇到 502 请稍等后重试；失败的调用不扣费，未找到会扣费。
宜家中国可用的全部接口
| 接口 | 返回内容 | 积分 | Growth 方案每 1,000 次 |
|---|---|---|---|
/api/v1/ikea/search | 关键词搜索、排序、筛选、分面 | 1 | 1 美元 |
/api/v1/ikea/product | 单个商品的价格、测量数据、材料、包裹 | 1 | 1 美元 |
/api/v1/ikea/items | 最多 100 个编号的价格 | 1 | 1 美元 |
/api/v1/ikea/deals | 10 种新品与优惠列表 | 1 | 1 美元 |
/api/v1/ikea/category | 一个品类的商品 | 1 | 1 美元 |
/api/v1/ikea/suggestions | 搜索框建议 | 1 | 1 美元 |
商场（stores）、商场库存（stock）、评价（reviews）、品类树（categories）、国别比价（compare）和 As-is 不支持 cn，会在扣费前返回 400。这些接口可用于 ikea.com 上的其他市场。上游失败不扣费，未找到（404）扣费。
宜家有官方 API 吗？
没有可以注册的官方 API。宜家没有公开商品目录的开发者门户或密钥计划，DIRIGERA 和 TRÅDFRI 智能家居网关的本地接口只用于设备，没有商品数据。宜家美国的使用条款仅许可将网站材料用于"non-commercial personal use only"。宜家中国的条款请自行查阅；本文不构成法律建议。
开始使用
- 注册 Scavio 账户：送 50 积分，无需绑卡，足够用 items 查询 50 次、每次 100 个编号。
- 用 search 找到宜家中国的编号，或从商品页网址末尾获取。
- 用 items 每次 100 个重新获取价格，连同日期一起保存；降价看
price_tag和previous_price。 - 用 deals 跟踪新品，用 category 跟踪整个品类。
- 也可以先在 Playground 里试用。价格：Hobby 每月 15 美元含 3,000 积分，Growth 每 1,000 积分 1 美元。
参考：宜家 API（中国） · 商品批量查询文档 · 优惠与新品文档 · 品类商品文档 · 7 个宜家价格 API 对比 · How to get IKEA prices by country（英文） · 快手视频数据 API 指南
Frequently asked questions
宜家中国的商品编号在哪里看？
商品页网址末尾的 8 位数字就是商品编号（例如 .../billy-bi-li-shu-jia-bai-se-90522038/；组合商品前面带 s，如 s59545297）。价签上写作 905.220.38 这样的格式。只知道名称时，向 /api/v1/ikea/search 传 "country": "cn" 和关键词，每个商品都会返回 item_no。
价格是人民币吗？含税吗？
"country": "cn" 时 price 是人民币数字（例如 399），currency 为 "CNY"。返回的是网站显示的线上价格，原样返回，不做换算，可能与商场价签不同。
宜家中国支持哪些接口？
支持商品搜索、商品详情、商品批量查询、优惠与新品、品类商品和搜索建议 6 个接口，每次调用 1 积分。商场、商场库存、评价、品类树、国别比价和 As-is 不支持 cn，传 cn 会在扣费前返回 400。
查询的编号不存在会扣费吗？
会。items 中未找到的编号会列在 not_found，单个商品未找到（404）也会扣 1 积分。上游失败返回 502，不扣费。宜家中国使用自有编号，请先用搜索结果的 item_no，再用 item_no_global 对应其他市场的编号。