IKEA Australia Retail Data API

Live IKEA Australia search, category, filter, and product detail data in one normalized API.

原始信息汇总

IKEA Australia Retail Data API 数据集概述

数据集基本信息

• 数据集名称: IKEA Australia Retail Data API
• 提供平台: RapidAPI
• 提供者: Dromb
• 类别: eCommerce
• 版本: 1.0.0 (current)
• 订阅者数量: 1

API 性能指标

• 流行度: 8.9 Popularity
• 服务等级: 100% Service Level
• 延迟: 356ms Latency
• 测试通过率: 100% Test

订阅计划与定价

• BASIC: $0.00 / mo
• PRO: $10.00 / mo
• ULTRA: $30.00 / mo
• MEGA: $100.00 / mo

核心功能概述

提供实时 IKEA 澳大利亚零售数据的统一 API，涵盖公共购物流程中最关键的环节：关键词搜索、品类发现、筛选器发现、品类列表以及通过产品编号、slug 或 URL 进行商品查询。

API 优势

• 产品搜索: /search 端点返回真实的 IKEA 产品结果，包含标准化定价、标识符、评分、面包屑导航和图片 URL。
• 品类发现: /categories 端点直接从 IKEA 搜索筛选器中提取可用的目录品类。
• 筛选器发现: /search/filters 端点公开可用的搜索筛选器，如品类、类型、价格、颜色、材质和排序选项。
• 品类列表: /category 端点返回来自 /ikea/categories 的特定品类 ID 下的产品。
• 商品解析: /item 端点可以通过 item_id、slug 或完整的公开 url 来解析一个产品。
• 变体覆盖: 当 IKEA 在搜索有效载荷中返回产品变体时，商品详情会包含这些变体信息。
• 结构化错误处理: 无效输入、未找到和被阻止的情况会返回受控的 JSON 有效载荷，而非原始崩溃信息。
• 集成就绪: 标准化输出适用于目录同步、分析管道、价格监控和市场工具。

典型用例

• 家具目录丰富化
• 产品搜索体验
• 品类和筛选器导航
• IKEA 产品种类监控
• 竞争性零售分析
• RapidAPI 就绪的产品数据集成

关键端点分组

• 健康检查: probe
• 发现: categories, search/filters
• 列表: search, category
• 产品详情: item

端点列表

• GET /search_filters_ikea_search_filters_get
• GET /probe_ikea_probe_get
• GET /category_ikea_category_get
• GET /item_ikea_item_get
• GET /categories_ikea_categories_get
• GET /search_ikea_search_get

技术实现说明

端点指南

• probe: 用于健康检查和快速后端可用性检查。
• categories: 用于在调用 /ikea/category 之前发现有效的 category_id 值。
• search/filters: 用于构建分面搜索 UI 并了解可用的筛选器组。
• search: 示例: query=chair&page=1&page_size=24
• category: 示例: category_id=700676&page=1&page_size=24
• item:
  • 通过 item id 示例: item_id=59445467
  • 通过 slug 示例: slug=loberget-malskaer-swivel-chair-white-s59445467
  • 通过 URL 示例: url=https://www.ikea.com/au/en/p/loberget-malskaer-swivel-chair-white-s59445467/

标准化字段

列表字段:

• id
• item_no
• item_no_global
• slug
• name
• source_url
• category
• breadcrumbs
• product_type
• design_text
• description
• rating
• review_count
• availability
• in_stock
• price
• discount_price
• current_price
• images
• price_info[]

商品字段:

• 包含与列表相同的核心产品字段
• 当 IKEA 在搜索有效载荷中公开相关产品变体时，包含 variants[]

标识符说明

• id 被标准化为优先使用 IKEA 的 itemNo，然后是 itemNoGlobal，最后是原始 id。
• item_no 是标准的 IKEA 商品编号（当可用时）。
• item_no_global 是 IKEA 的全球商品编号（当可用时）。
• slug 是从公开的 IKEA 产品 URL 中提取的。

分页说明

• page 和 page_size 映射到 IKEA 搜索窗口偏移量。
• total 在可用时从 IKEA 结果元数据中派生。
• total_exact=true 表示端点返回的是 IKEA 元数据计数，而不仅仅是当前页面的长度。

筛选器说明

• /ikea/search/filters 从实时 IKEA 搜索响应中返回动态筛选器组。
• 典型的筛选器键包括:
  • category
  • type
  • price
  • colour
  • material
  • features
  • customer_rating
  • series
  • suitable_for
  • sort

错误模型

• invalid_input: 用于空 query、空 category_id 或缺少商品标识符的情况。
• not_found: 当 /ikea/item 无法匹配产品时使用。
• blocked: 当 IKEA 搜索传输失败或被阻止时使用。
• error: 保留用于上述类别之外的受控非成功响应。

稳定性说明

• 搜索传输使用多种请求路径：直接 httpx、代理辅助重试和 curl_cffi 回退。
• API 返回结构化有效载荷，而不是暴露原始传输异常。
• 本地直接函数调用现在也更安全地支持，因为在构建有效载荷之前，路由输入已被标准化。

实施注意事项

• search 是产品搜索端点。
• category 期望一个由 /ikea/categories 返回的品类 ID，而不是 slug。
• item 适用于 item_id、产品 slug 或完整的产品 url。
• 当 IKEA 公开两个标识符时，item_no 和 item_no_global 会分别返回。
• total 现在在可用时反映 IKEA 元数据计数，而不仅仅是当前页面的长度。
• 空 query 或空 category_id 值会返回结构化的 invalid_input 有效载荷。

标签

ikea api, ikea australia api, furniture api, home products api, product search api, category api, filter api, retail data api