Kidstuff Australia Retail Data API

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

原始信息汇总

Kidstuff Australia Retail Data API 数据集概述

基本信息

• 数据集名称：Kidstuff Australia Retail Data API
• 提供商：Dromb
• 类别：eCommerce
• 版本：1.0.0 (current)
• API地址：https://rapidapi.com/dmitriygyrbu/api/kidstuff-australia-retail-data-api

服务指标

• 流行度：8.7 Popularity
• 服务等级：100% Service Level
• 延迟：10457ms Latency
• 测试通过率：100% Test

订阅计划

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

核心功能

Live Kidstuff Australia Retail Data in One API，为开发者和数据团队提供了一种实用的方式来处理实时的Kidstuff产品数据，涵盖最重要的公共购物流程：关键词搜索、类别发现、集合浏览以及通过slug或URL进行商品查找。

主要优势

• 产品搜索：/search 返回真实的Kidstuff产品结果，包含标准化的名称、品牌、价格、图片、库存信号和来源URL。
• 类别发现：/categories 返回实时的Kidstuff集合名称和slug，可直接用于/category。
• 过滤器发现：/search/filters 返回支持的排序模式和实时类别列表，用于客户端搜索界面。
• 类别列表：/category 返回来自真实Kidstuff集合的产品，并支持通过Shopify产品.js负载进行可选的详细信息丰富。
• 商品解析：/item 支持产品slug或完整的公共url，以及可选的variant_id选择。
• 结构化失败处理：空白输入、传输被阻止和缺失产品返回受控的JSON负载，而非原始崩溃。
• 集成就绪：标准化输出适用于目录摄取、监控、市场应用和RapidAPI客户端使用。

典型用例

• 玩具目录丰富
• 儿童零售监控
• 产品搜索体验
• 类别导航
• 价格跟踪
• 适用于RapidAPI的电子商务集成

关键端点组

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

端点详情

1. GET categories_kidstuff_categories_get
2. GET category_kidstuff_category_get
3. GET search_kidstuff_search_get
4. GET item_kidstuff_item_get
5. GET search_filters_kidstuff_search_filters_get
6. GET probe_kidstuff_probe_get

技术说明

端点指南

• probe：用于健康检查和快速店面验证。
• categories：用于在调用/kidstuff/category之前发现有效的集合slug。示例：refresh=false
• search/filters：用于在客户端应用程序中构建搜索控件和排序选择器。示例：refresh=false
• search：关键词产品搜索端点，期望正常的购物者查询，如puzzle、lego或sensory toy。示例：query=puzzle&page=1&limit=20&sort=relevance&details=false
• category：期望来自/kidstuff/categories的集合slug，例如puzzles或arts-crafts。示例：slug=puzzles&page=1&limit=40&sort=price_asc&details=false
• item：
  • 通过slug示例：slug=magnetic-matching-puzzle
  • 通过URL示例：url=https://www.kidstuff.com.au/products/magnetic-matching-puzzle
  • 带变体选择示例：slug=magnetic-matching-puzzle&variant_id=40928765432109

标准化字段

• 列表字段：id、slug、name、brand、source_url、category、description、availability、in_stock、price、current_price、images、source、price_info[]
• 商品字段：包含列表中的所有主要标准化产品字段，以及带有标准化变体级别行的variants[]

特定端点注意事项

• 搜索：
  • search 使用公共的Kidstuff Shopify建议端点。
  • details=false 是最快模式，从建议数据返回标准化搜索行。
  • details=true 尝试在可用时使用Shopify产品.js负载升级每个结果。
  • 空白或仅包含空格的查询返回invalid_input。
• 类别：
  • category 使用实时的Kidstuff集合列表，而非陈旧的本地目录。
  • details=true 可以用完整的产品.js数据丰富列表行，但它是可选的，正常浏览不需要。
  • 空白或仅包含空格的集合slug返回invalid_input。
• 商品：
  • item 从slug或完整url解析产品句柄。
  • API获取Shopify产品.js负载并标准化所选变体以及完整的variants[]数组。
  • 当提供variant_id时，匹配的变体成为主要的result。
  • 缺失的产品以结构化的not_found形式返回，而非原始的上游404/502传输错误。

错误模型

• invalid_input：用于空白query、空白类别slug或item中缺少slug/url。
• not_found：当/kidstuff/item无法解析产品时使用。
• blocked：当Kidstuff传输失败、被阻止或店面依赖项暂时不可用时使用。
• error：为上述类别之外的受控非成功情况保留。

稳定性说明

• 店面传输使用具有重试、类似浏览器的头部、代理支持和备用方法的共享回退获取层。
• API现在将上游店面404（针对缺失产品）转换为适当的not_found负载。
• 路由输入经过清理，因此空白或格式错误的值会快速失败，并返回清晰的结构化响应。

标签

kidstuff api, toys api, kids products api, australia retail api, product search api, category api, shopify catalog api, ecommerce data api