亚马逊 Best Sellers 榜单 API:把网页榜单收成每日 BSR 快照

发布于 2026年10月1日 · 更新于2026年10月16日

畅销榜在亚马逊上就是一张给人点的网页,没有「导出今日名次」这种按钮。五十张商品卡、类目面包屑、底下的翻页。名次是页面画上去的数字,ASIN 塞在商品链接的某一段里。把这页交给爬虫,选择器活着的几个月表能填满;某天官网只换一层包裹 class,浏览器里五十张卡还在,表格先空了。选品的人去对官网,才发现挂掉的不是榜,是解析。

飙升榜、新品榜、心愿单榜、礼物榜同样是给人点的 HTML,不是一份能订阅的名次流。这篇不教注册,也不把接口目录摊开。要交的东西只有一件:每天一份按 ASIN 归档的快照文件。类目、榜种、站点在任务里各钉死一次,用 Python 打 best-sellers,别再解析瓷片。打开本页或复制示例不会发出请求。

登录后在控制台复制授权 Key,放到写文件那台机器的环境变量 OPENDATA_API_KEY。文中的 YOUR_API_KEY 只是占位。Key 走查询参数,会进访问日志,不要写进工单、截图和浏览器前端。

本来只是网页的榜单

五种榜都是页面。BEST_SELLERS 看类目近期销量;NEW_RELEASES 看已经在卖的新品;MOVERS_AND_SHAKERS 看二十四小时里名次跳得最凶的;MOST_WISHED_FOR 看心愿单和登记清单;GIFT_IDEAS 看当礼物被买走的。打印出来仍是一张网页。运营盯的是瓷片顺序,脚本要的是同一顺序落成字段。

真正要从瓷片上留下的,无非是名次、编码、标题、价格字符串、星级。JSON 也是这些:rank、asin、product_title、product_price、product_star_rating、product_num_ratings、product_url、product_photo。飙升榜上才有 rank_change_label,标明相对上一期的升降。没有这张标签的榜,别指望单次拉取就能画出涨跌。category_name 是解析后的类目名,方便多类目任务按返回名归档,不必只记手敲的路径——software/229535 和页面面包屑对不上时,以后对账全靠这个字段。

差别在运维。爬虫绑 CSS,这个请求绑查询参数。状态仍是两层,不能混着看。HTTP 4xx/5xx 表示传输、鉴权或额度,请求没跑成,这时候才去看 Key 和配额;信封是 {code, message, data},code 为 200 只说明平台受理了,不说明五十条都在。类目路径对该站点不成立,或当天没挂这张榜,往往是受理成功、products 空或缺。当未命中处理,不要拿同一路径死循环,也不要把空列表当成「稍后会刷出来」。

一个类目一种榜一次 50 条

先给文件起名,再发请求。一次任务只认一个类目、一种榜、一页。category 必填:顶级写 software 这种部门名,子类写 software/229535,跟你正在盯的那张畅销榜 URL 里的路径同一形态。从 URL 里抄 node,不要凭记忆编数字。type 默认 BEST_SELLERS,文件头里写死,避免定时任务哪天默默换榜——默认值适合手搓一次,不适合无值守。

一页五十条。page 默认 1。多数告警只看首页,前五十里名次跳变才有人值守;第 2 页是第二次调用、第二次扣额度、另一份文件。首页还没稳定落盘,先别翻页。只要名次和身份时再加 fields=rank,asin,product_title,product_price,rank_change_label。字段没想清楚就先全量收下,别一开始裁掉明天要对的列。

import os

import requests

BASE = "https://api.opendata-api.com/api/project/amazon/best-sellers"
KEY = os.environ["OPENDATA_API_KEY"].strip()


def fetch_chart(category, chart_type, country="US", page=1):
    resp = requests.get(
        BASE,
        params={
            "key": KEY,
            "category": category,
            "type": chart_type,
            "country": country,
            "page": page,
        },
        timeout=30,
    )
    resp.raise_for_status()  # HTTP layer: 4xx/5xx is transport or quota
    envelope = resp.json()
    if str(envelope.get("code")) != "200":
        raise RuntimeError(envelope.get("message"))
    data = envelope.get("data") or {}
    products = data.get("products")
    if products is None:
        products = []
    return data, products

本文示例用 software 加 MOVERS_AND_SHAKERS,因为变动标签在这张榜上。同一类目的畅销榜是另一份文件。不要把两种 type 揉进一张 map,再去解释名次对不上。

换站点不必重写任务

榜是按站点出的。country 支持 US(默认)、GB、DE、FR、IT、ES、NL、SE、PL、BE、IE、CA、MX、BR、AU、JP、IN、SG、AE、SA、EG、ZA、TR、CN。上面的函数已经吃 country。日本站电子类新品榜就是同一函数换 category="electronics"、chart_type="NEW_RELEASES"、country="JP",不是第二套解析器,也不必为每个站点再写一遍选择器。

类目路径跟站点走。美国站有的 node,日本站可能换号,也可能没有。加站点时先从该站自己的畅销榜页抄路径,抄完用同一套信封判断,不要假设「美国能出五十条,日本就一定能」。信封 200 而 products 为空,先怀疑路径,别先换 Key。

country 写进文件名,也写进 JSON。美国第 3 名和日本第 3 名塞进同一本字典,所谓全球 BSR 看板就是假的。跨境对照可以并排两份文件,不能合成一条名次。language=en_US 只改文案,不合并目录,更不会把日文站的 ASIN 列表翻译成美国站的榜。落盘时用 UTF-8,标题里的日文、中文才不会被转义成一串 \u。

每天留下的快照文件

产物按「站点 + 类目 + 榜种 + 页码」每天一份 JSON,文件名把这四段都带上,目录里一眼能分开。商品 map 的键是 asin,值里留下名次、标题、价格、评分、评价数,以及有就写的 rank_change_label。没有 ASIN 的行直接跳过,不要用标题当键。列表为空也要落盘:空的 by_asin 表示今天拉到了、榜上没有货,和任务没跑不是一回事。值班的人看目录,缺文件才是没跑;有文件但 map 是空的,是路径或空榜。

import json
from datetime import date

CATEGORY = "software"
CHART_TYPE = "MOVERS_AND_SHAKERS"
COUNTRY = "US"
PAGE = 1


def main():
    data, products = fetch_chart(CATEGORY, CHART_TYPE, COUNTRY, PAGE)
    day = date.today().isoformat()
    snapshot = {
        "date": day,
        "category": CATEGORY,
        "category_name": data.get("category_name"),
        "type": CHART_TYPE,
        "country": COUNTRY,
        "page": PAGE,
        "by_asin": {},
    }
    for item in products:
        asin = item.get("asin")
        if not asin:
            continue
        snapshot["by_asin"][asin] = {
            "rank": item.get("rank"),
            "title": item.get("product_title"),
            "price": item.get("product_price"),
            "rating": item.get("product_star_rating"),
            "num_ratings": item.get("product_num_ratings"),
            "rank_change": item.get("rank_change_label"),
        }
    slug = CATEGORY.replace("/", "-")
    filename = f"bsr-{COUNTRY}-{slug}-{CHART_TYPE}-{day}-p{PAGE}.json"
    with open(filename, "w", encoding="utf-8") as handle:
        json.dump(snapshot, handle, indent=2, ensure_ascii=False)
    print(f"wrote {len(snapshot['by_asin'])} asins to {filename}")


if __name__ == "__main__":
    main()

只盯你真看的那几个组合,一天跑一次。相邻两天的文件能分出三类信号:今天有昨天没有(新进榜)、反过来(掉榜)、名次升过你设的阈值。飙升榜上 rank_change_label 已经带涨跌,单份文件也能列出蹿得最快的,但标签不是历史,替代不了带日期的快照。昨天的文件丢了,今天再拉一次也补不回昨天的名次。

这份快照不是买盒、不是跟卖数、不是评论流,也不是今日特价。哪天认定某条值得深挖,再把最多十个 ASIN 交给 product-details;别每天对五十行全量展开,榜单任务会变成误打的目录爬取。products-by-category 用来看前五十以外的类目体量,那是另一份产物。榜单一天之内会动,日频文件吃不到盘中尖峰;要盘中就得另排更密的任务,并接受额度上去。第 1 页只有五十行,不是长尾。信封 200 且 products 为空,是路径不对或榜是空的,不是换 Key 的理由。参数见 best-sellers,单次费用见定价。