Screwfix UK Real-Time Product, Pricing & Store API

Live Screwfix UK product, pricing, category, and store data with normalized JSON for search, category, item, store directory, and store detail.

原始信息汇总

Screwfix UK Real-Time Product, Pricing & Store API 数据集概述

基本信息

• 数据集名称: Screwfix UK Real-Time Product, Pricing & Store API
• 提供者: Dromb
• 类别: eCommerce
• 版本: 1.0.0 (current)

订阅计划

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

核心功能概述

此API为开发者和数据团队提供了一种实用的方式来使用Screwfix英国商店前端的实时公开数据，涵盖核心商业流程：产品搜索、类别浏览、商品详情、商店目录和商店详情。

主要特点

• 无需浏览器: 基于公开的Screwfix SSR页面和公开的商店定位器页面构建。
• 丰富的价格语义: 列表和商品响应同时公开含增值税和不含增值税的价格（当Screwfix发布时）。
• 实用的履约信号: 提货和配送标志已标准化到有效负载中。
• 包含公开商店目录: /stores 和 /store 端点公开分支代码、商店URL、地址、坐标和营业时间。
• 实用的商品详情: 产品详情包括评分、评论数量、媒体、要点、技术规格、可持续性元数据和变体。
• 干净的标准化输出: 搜索、类别和商品共享一个适用于零售业的响应结构，涵盖ID、名称、URL、价格、类别上下文、可用性、徽章和媒体。
• 结构化的失败处理: 无效输入、未找到、被阻止和一般错误返回干净的JSON有效负载，而非原始崩溃信息。

端点列表与描述

1. /screwfixProbe (GET): 通过轻量级实时搜索确认Screwfix商店前端的可用性。
2. /screwfixCategories (GET): 从实时导航中获取Screwfix顶级浏览类别。
3. /screwfixStores (GET): 浏览或搜索公开的Screwfix分支目录。
4. /screwfixStore (GET): 获取单个商店的地址、地图坐标和营业时间。
5. /screwfixSearchFilters (GET): 获取搜索或类别页面的实时筛选器和排序选项。
6. /screwfixSearch (GET): 通过关键词搜索产品。
7. /screwfixCategory (GET): 使用 category_id、slug或完整URL浏览类别。
8. /screwfixItem (GET): 通过产品代码、slug或完整URL获取单个产品。

典型用例

• 贸易和承包商工具应用
• 产品和价格监控
• 增值税感知的目录丰富
• 类别和品种跟踪
• 市场和转售商情报
• 商店定位器集成
• 为ERP或采购工作流程丰富产品详情

数据源与实现说明

• 基础主机: https://www.screwfix.com
• 访问模式: 非浏览器HTTP，具有备用传输方式。
• 主要数据表面:
  • 主页导航
  • /search?search=... 下的搜索页面
  • /c/... 下的类别页面
  • /p/.../<product_code> 下的产品页面
  • /stores/all 下的商店目录
  • /stores/<branch_code>/<slug> 下的商店详情页面
• 数据提取: 产品数据从公开的 __NEXT_DATA__ 有效负载中读取，商店定位器数据从公开的 /stores/all 目录和单独的公开商店详情页面读取。

数据标准化说明

• 列表行映射: 将原始字段（如 skuId, longDescription, priceInformation.currentPriceIncVat.amount 等）映射为标准化的字段（如 id, name, effective_price 等）。
• 商品行映射: 提取并标准化产品详情，包括 images, bullets, technical_specifications, variants 等。
• 商店标准化: 目录行仅公开稳定的商店身份和URL；详细的地址、营业时间和地图坐标来自公开的商店详情页面。

可靠性与验证

• 使用公开的SSR数据，不依赖浏览器会话。
• HTML响应会被短暂缓存以减少重复页面抓取。
• 类别映射和所有商店目录数据被缓存以实现更快的重复解析。
• 在2026年4月7日的实时验证中观察到：
  • /stores/all 公开了 935 个商店目录行。
  • /store?store_code=TA4 返回了Aberdare的实时详细分支记录。
  • /search?query=spanner 返回了 148 个产品。
  • /item?product_id=979HF 返回了实时丰富的商品详情，包括 price_ex_vat=166.66。

当前限制

• 商店搜索基于目录和文本匹配；目前API中没有地理空间最近商店排名功能。
• 产品详情中提供评论摘要，但单独的评论行未提取到单独的反馈中。
• 类别分类法来自标题导航加上从实时列表页面发现的类别筛选器；没有在一个响应中提供完整的深层浏览树导出。