Home Hardware Australia API

Live Home Hardware AU catalog data for tools and home improvement with search, category, and item endpoints.

原始信息汇总

Home Hardware Australia API 数据集概述

基本信息

• 数据集名称: Home Hardware Australia API
• 提供平台: RapidAPI
• 创建者: Dromb
• 类别: eCommerce
• 当前版本: 0.1.0
• 订阅计划: BASIC ($0.00 / mo), PRO ($10.00 / mo), ULTRA ($30.00 / mo), MEGA ($100.00 / mo)
• 服务等级: 100%
• 延迟: 2081ms
• 测试通过率: 100%
• 流行度: 8.7

数据集描述

Home Hardware Australia API 为开发者和数据团队提供了一种实用的方式来使用实时的 Home Hardware AU 产品数据，覆盖最重要的公共购物流程：关键词搜索、过滤器发现、类别浏览以及通过 ID、slug 或 URL 进行商品查找。

主要特点

• 产品搜索: /search 返回真实的 Home Hardware 产品结果，包含标准化的价格、条形码、类别、面包屑导航和图像。
• 类别发现: /categories 直接从实时 Unbxd 分面中提取可搜索的类别值。
• 过滤器发现: /search/filters 返回实时过滤器组以及客户端搜索 UI 支持的排序选项。
• 类别列表: /category 返回按 /categories 中的类别名称或类别 slug 过滤的产品。
• 商品解析: /item 支持 item_id、产品 slug 或完整产品 url。
• 直接产品恢复: item 可以直接从产品页面解析 slug/url，而不仅仅依赖于索引搜索匹配。
• 结构化故障: 无效输入、未找到和阻止的情况返回受控的 JSON 负载，而不是原始崩溃信息。
• 集成就绪: 标准化输出适用于分析管道、目录同步作业和 RapidAPI 市场使用。

典型用例

• 硬件目录丰富化
• DIY 零售监控
• 产品搜索体验
• 类别和过滤器导航
• 价格情报
• RapidAPI 就绪的产品数据集成

关键端点组

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

端点详情

1. GET categories_homehardware_categories_get
2. GET category_homehardware_category_get
3. GET search_homehardware_search_get
4. GET item_homehardware_item_get
5. GET search_filters_homehardware_search_filters_get
6. GET probe_homehardware_probe_get

技术说明

端点指南

• probe: 用于健康检查和快速店面验证。
• categories: 用于在调用 /homehardware/category 之前发现有效的类别名称和 slugs。
• search/filters: 用于构建分面搜索 UI 并了解可用的过滤器组。
• search: 示例: query=drill&page=1&page_size=24&sort=relevance
• category:
  • 按名称示例: category_name=Tools&page=1&page_size=24
  • 按 slug 示例: category_name=tools&page=1&page_size=24
• item:
  • 按 ID 示例: item_id=6172605
  • 按 slug 示例: slug=makita-12v-1-5ah-3-8-driver-drill-with-case-df333dwy
  • 按 URL 示例: url=https://www.homehardware.com.au/makita-12v-1-5ah-3-8-driver-drill-with-case-df333dwy

标准化字段

• 列表字段: id, slug, name, brand, barcode, source_url, category, breadcrumbs, description, availability, in_stock, price, discount_price, current_price, images, price_info[]
• 商品字段: 包含列表中的所有主要标准化产品字段，以及当产品页面在结构化数据中公开时的 mpn。

类别说明

• category 是产品的主要类别标签。
• breadcrumbs 是从可用类别字段或产品页面结构化数据组装的标准化类别路径。
• /category 可以接受类别 slug，并在需要时在内部将其解析回正确的类别名称。

商品解析说明

• 对于 item_id，API 搜索 Unbxd 产品索引并按 ID 匹配。
• 对于 slug 和 url，API 首先尝试直接获取产品页面并解析结构化产品数据。
• 如果直接页面解析不成功，API 仍可回退到索引搜索匹配。
• 标题为 404 Not Found 的产品页面被视为真实的未找到响应，而不是成功的商品负载。

过滤器说明

• /search/filters 返回来自真实 Home Hardware 搜索响应的实时分面组。
• 典型的过滤器组包括: category, brand, price, 其他由 Unbxd 为查询样本公开的实时分面桶, sort。

错误模型

• invalid_input: 用于空 query、空 category_name 或缺少商品标识符。
• not_found: 当 /homehardware/item 无法解析产品时使用。
• blocked: 当 Home Hardware 或 Unbxd 传输失败或被阻止时使用。
• error: 保留用于上述类别之外的可控非成功情况。

稳定性说明

• 搜索传输使用 fetch_with_fallback 加上 curl_cffi 直接回退。
• 浏览器样式标头、重试、轮换代理和浏览器 cookie 已连接到获取层。
• 产品页面回退显著提高了 item 对 slug 和 url 输入的可靠性。

标签

home hardware api, homehardware australia api, hardware store api, tools api, home improvement api, product search api, category api, retail data api