宜家商品搜索 API

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

搜索关键词，1-200 个字符，可使用该市场提供的任何语言；也可以直接搜商品编号。

Example: billy

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

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

仅在 country 为 es_islands（西班牙加那利群岛和巴利阿里群岛的商店）时必填，其他情况不可用：指定哪个岛的商店。

Example: tenerife

• tenerife — 特内里费岛（加那利群岛）。
• grancanaria — 大加那利岛（加那利群岛）。
• lanzarote — 兰萨罗特岛（加那利群岛）。
• fuerteventura — 富埃特文图拉岛（加那利群岛）。
• lapalma — 拉帕尔马岛（加那利群岛）。
• lagomera — 戈梅拉岛（加那利群岛）。
• elhierro — 耶罗岛（加那利群岛）。
• mallorca — 马略卡岛（巴利阿里群岛）。
• menorca — 梅诺卡岛（巴利阿里群岛）。
• ibiza — 伊维萨岛（巴利阿里群岛）。

按分面中的品类 ID（parameter f-subcategories）缩小范围，例如 st002。

Example: st002

结果页码，从 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"]}