概览
提交一个 Amazon 非日本站 Best Sellers 榜单链接,获取榜单中的商品记录和排名信息,适合做类目盘点、竞品发现和站点对比。
数据说明
数据来自公开可访问的 Amazon 非日本站 Best Sellers 榜单,不包含日本站 amazon.co.jp。每条记录对应榜单中的一个商品,保留榜单排名、榜单类目、站点代码、商品标识、榜单链接和采集时间等信息。商品标识通常为 ASIN;榜单页面链接和站点代码用于判断记录来自哪个市场。
实际返回数量取决于榜单页面当时可见的数据和任务执行结果。提交的期望采集条数用于表达本次任务的取数需求,空榜单、下架商品或页面无法访问时可能返回较少记录。采集时间沿用来源表示。
结果长什么样
每条记录代表榜单中的一个商品:
| 榜单排名 | 榜单类目 | 站点代码 | 商品标识 | 采集时间 |
|---|---|---|---|---|
| 1 | 卸妆水 | US | B017PCGABI | 2026-11-06T17:12:14 |
结果另有业务标识、榜单链接、任务项和无数据标记等信息。
应用场景
- 盘点不同 Amazon 站点和类目的热门商品,观察榜单排名与商品标识。
- 发现竞品和潜在选品方向,结合榜单类目、站点代码和采集时间整理市场快照。
- 分批保存同一榜单的采集结果,按采集时间比较排名变化。
适用边界
每次任务提交 1 个 Amazon 非日本站 Best Sellers 榜单完整链接;不支持 amazon.co.jp,实际返回数量以榜单可用数据为准。
- 适合用于
- 需要获取 Amazon 非日本站 Best Sellers 榜单中的商品及其排名信息时
- 不要用于
- 需要日本站 amazon.co.jp 榜单时——本 App 不支持日本站
- 需要单个商品详情、评论或历史数据时——本 App 只返回榜单记录
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1榜单链接无效、站点不受支持或任务过期时,修正链接后重新提交
- 2任务部分成功时使用已经返回的榜单记录;限流、服务暂不可用或超时可稍后重试
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- Amazon 热门榜单链接
hotlist_url必填string要采集的 Amazon 非日本站 Best Sellers 榜单完整 HTTPS 链接。请使用公开可访问的榜单页面;不支持 amazon.co.jp。示例https://www.amazon.com/Best-Sellers-Beauty-Personal-Care-Makeup-Cleansing-Water/zgbs/beauty/23504934011/ref=zg_bs_nav_beauty_3_23504928011 - 期望采集条数
limit必填integer希望采集的榜单商品条数;实际返回数量以榜单可用数据和任务执行结果为准,数量越大通常耗时和费用越高。范围1–示例10
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 榜单排名
bestseller_rankinteger商品在该榜单中的排名示例1 - 业务标识
biz_idstring来源榜单记录的业务标识,当前为榜单页面链接示例https://www.amazon.com/Best-Sellers-Beauty-Personal-Care-Makeup-Cleansing-Water/zgbs/beauty/23504934011/ref=zg_bs_nav_beauty_3_23504928011 - 榜单类目
categorystring商品所属的榜单类目示例卸妆水 - 站点代码
countrystring榜单所属 Amazon 站点代码示例US
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"bestseller_rank": 1,
"biz_id": "https://www.amazon.com/Best-Sellers-Beauty-Personal-Care-Makeup-Cleansing-Water/zgbs/beauty/23504934011/ref=zg_bs_nav_beauty_3_23504928011",
"category": "卸妆水",
"country": "US",
"crawl_time": "2026-11-06T17:12:14",
"item": "https://www.amazon.com/Best-Sellers-Beauty-Personal-Care-Makeup-Cleansing-Water/zgbs/beauty/23504934011/ref=zg_bs_nav_beauty_3_23504928011",
"sku_id": "B017PCGABI",
"task_item": "https://www.amazon.com/Best-Sellers-Beauty-Personal-Care-Makeup-Cleansing-Water/zgbs/beauty/23504934011/ref=zg_bs_nav_beauty_3_23504928011",
"no_data": false
}调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/amazon-hotlist",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 50 条为一个计费单位,不足 50 条按 50 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。