Best Buy Listings API

Search Best Buy product listings — get names, prices, discounts, images, SKUs, models, ratings, and product links as structured JSON.

原始信息汇总

Best Buy Listings API 数据集详情

API 概述

该 API 允许用户从 Best Buy 搜索产品列表，并以清晰的结构化 JSON 格式实时返回数据。用户可以通过关键词查询，或直接指向任何 Best Buy 搜索或分类 URL，获取一页规范化的产品信息，包括名称、价格、折扣、图片、SKU、型号、评分、评论数和产品链接。适用于价格追踪、交易监控、竞争对手与市场分析以及产品研究。

核心功能亮点

• 快速 — 直接从 Best Buy 的嵌入式数据中提取结构化 JSON，无需在用户端进行 HTML 解析
• 丰富数据 — 每个产品包含名称、SKU、型号、图片、产品 URL、评分、评论数以及完整的价格明细
• 折扣信息 — 提供每个列表的原价、当前价、总节省金额和节省百分比
• 关键词或 URL 查询 — 可通过关键词搜索，或直接抓取指定的 Best Buy 分类/搜索 URL
• 自愈能力 — 对上游变化具有弹性，运行在 Apify 平台上

认证方式

所有请求通过 RapidAPI 发送，需在每次调用中携带 RapidAPI 密钥：

• X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
• X-RapidAPI-Host: best-buy-listings-api.p.rapidapi.com

端点详情

GET /search

搜索 Best Buy 列表，返回一页规范化结果。

参数说明：

参数	类型	是否必填	默认值	描述
q	string	否*	—	搜索关键词，例如 laptops。当提供 url 时忽略此参数
url	string	否*	—	完整的 Best Buy 搜索/分类 URL，优先级高于 q
page	integer	否	1	从 1 开始的结果页码。当设置 maxItems 时，此为起始页
maxItems	integer	否	—	返回的产品总数，从 page 开始自动分页（按 SKU 去重）。省略则返回一页。最大 200

*必须提供 q 或 url 中的一个。

响应字段说明

字段	类型	描述
query	string	搜索的关键词或 URL
page	number	返回的页码
count	number	此页的产品数量
items[].sku	string	Best Buy SKU ID
items[].name	string	产品名称
items[].priceDomain	object	价格明细对象，或为 null
items[].imageUrl	string	产品主图 URL
items[].productUrl	string	产品规范页面 URL
items[].model	string	制造商型号
items[].category	string	分类（如有）
items[].rating	number	客户平均评分
items[].reviewsCount	number	客户评论数
items[].variations	array	产品变体（如有）

priceDomain 对象字段：

字段	类型	描述
regularPrice	number	原价
currentPrice	number	当前客户价格
totalSavings	number	绝对折扣金额
totalSavingsPercent	number	折扣百分比
instantSavings	number	即时节省金额（如适用）

适用场景

• 价格追踪 — 监控特定产品随时间变化的当前价格、折扣和节省金额
• 交易监控 — 发现分类中最大的 totalSavingsPercent 降幅
• 竞争对手与市场分析 — 比较各品牌和分类的定价和评分
• 产品研究 — 将结构化的目录数据（SKU、型号、评分）集成到应用中

错误处理

错误时返回包含 HTTP 状态码的 JSON：

状态码	error 值	含义
502	scrape_failed	上游请求失败 — 请重试

常见问题

• 数据新鲜度：每次调用实时抓取 Best Buy，结果反映当前列表
• 分页方式：使用 page（从 1 开始）获取指定页，或设置 maxItems 让 API 自动分页返回指定数量产品（按 SKU 去重，最多 200 个）
• 抓取特定分类：将该分类/搜索页的 URL 作为 url 参数传入，而非使用 q
• 计数较小原因：每次调用只返回单个 Best Buy 页面渲染的产品，使用 page 参数获取更多页

注意事项

• 非官方 API：与 Best Buy 无关联、未经其认可或赞助
• 用途限制：仅供研究和分析使用，用户需自行负责数据的使用方式
• 订阅计划：提供 BASIC（$0.00/月）、PRO（$10.00/月）、ULTRA（$30.00/月）、MEGA（$100.00/月）等不同计划，各有独立的速率限制和月度配额