宜家优惠与新品 API

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

要获取的列表。

Example: new_products

• new_products — 新品。
• family_price — IKEA Family 会员价：price 为会员价，previous_price 为常规价。
• new_lower_price — 新低价：previous_price 为降价前的价格，附新价格的有效期。
• last_chance — 最后机会：即将停售的商品。
• lowest_price — 最低价区间。
• top_seller — 畅销产品。
• limited_edition — 限量版。
• time_restricted — 限时优惠。
• in_store_price_only — 仅限商场的价格。
• reduced_price_offer — 降价优惠。

宜家市场，小写代码。本接口支持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。

响应语言，须为该市场网站提供的语言；默认是市场的第一种语言（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

结果页码，从 1 开始。宜家只提供列表的前 2,000 条再加一页，因此 (page - 1) x page_size 不能超过 2,000。

Example: 2

每页商品数，1-100。

Example: 48

排序方式。

Example: price_asc

• relevance — 网站默认排序。默认值。
• price_asc — 价格从低到高。
• price_desc — 价格从高到低。
• newest — 最新商品优先。
• rating — 评分最高优先。
• name_asc — 名称 A 到 Z。
• most_popular — 最受欢迎优先。

分面中的颜色 ID（parameter f-colors），例如 10156 = 白色。

Example: 10156

分面中的价格区间 ID（parameter f-price-buckets）。ID 因市场而异，请从同一市场的分面中获取：宜家中国的 PRICE_0_20000 = ¥0 - 199。

Example: PRICE_0_20000

仅新品。

Example: true

仅最后机会（即将停售）商品。

Example: true

仅有 IKEA Family 会员价的商品。

Example: true

仅畅销产品。

Example: true

商场 ID（stores 接口的 stores[].store_id），会为每件商品加上该商场的库存状态（库存水平、送货）并启用 availability。stores 接口不支持 cn，因此宜家中国没有可用的商场 ID。

Example: 399

与 store_id 一起使用：in_store（该商场有货，默认）、click_collect 或 online。

Example: in_store

• in_store — 商场有货。
• click_collect — 可在该商场线上下单、到店自提。
• online — 可在线购买。

其他任意分面，以 facets[].parameter 为键，例如 {"f-materials": ["47350"]}。布尔型分面传 true。

Example: {"f-materials": ["47350"]}