list_bestsellers
Retrieve Amazon Best Sellers top 100 for any category, including 24-hour sales rank changes. Analyze category leaders and track ranking shifts.
Instructions
[Amazon 热销榜] 拉某类目的 Best Sellers Top-100,含 24h 排名变化。 Use when: 用户说"X 类目热销榜""哪些是该类目龙头""有没有黑马冲上来""benchmark 卖得最好的产品";选品时定基准品;竞品雷达里追踪类目龙头排名变化。 Don't use: 看新品(用 list_new_releases);想要类目下完整商品列表而非 Top 100(用 list_category_products);只知道关键词不知道类目(用 search_categories 先找类目)。 Returns: data.json[0].data.{ reftag, recsList } — recsList 是字符串形式的 JSON 数组,需要二次 parse;每条 { id, metadataMap.{ render.zg.rank, currentSalesRank, percentageChange, twentyFourHourOldSalesRank } }。 Pair with: ↑ categorySlug 需要用户提供或从场景推测(如 'electronics' / 'home-garden' / 'beauty');↓ 把 id (ASIN) 喂 get_amazon_product 拆单品。 Cost: ~1 积点/次, ~5s。 Tips: categorySlug 是 Amazon URL 路径里的英文短横线串,从 amazon.com/Best-Sellers 顶部导航能看到。
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| categorySlug | Yes | Amazon Best Sellers 类目 slug(小写英文短横线),如 'electronics'、'home-garden'、'beauty'、'toys-and-games'。可以从 amazon.com/Best-Sellers 顶部导航的 URL 路径里读到。 | |
| site | No | Amazon 站点。默认 amz_us。 | amz_us |
| zipcode | No | 邮编,必须匹配 site 站点所在国家(amz_us → 美国邮编,amz_jp → 日本邮编 …)。可选;不传时后端会从对应国家邮编池随机挑一个。跨国邮编(如 amz_us + 日本邮编)会被后端拒绝。Examples: 10001 (NY) / 90001 (LA) / 100-0001 (Tokyo). | |
| format | No | 返回格式。默认 'json'——结构化 Top-100 ASIN 排名列表。需要原始页面阅读时切 'markdown'。 | json |