eBay 卖家评价 API:正确读取近 1、6、12 个月的好中差评数据

发布于 2026年10月25日

评价类别近 1 个月 m1近 6 个月 m6近 12 个月 m12
好评 positive数量或未知数量或未知数量或未知
中评 neutral数量或未知数量或未知数量或未知
差评 negative数量或未知数量或未知数量或未知

做采购审核页,先确定这九个格子的含义,再决定图表样式。空白不能自动变成零,三个时间窗口也不能累加成“总评价”。eBay 卖家评价 API 返回的是公开资料汇总,适合辅助人工查看,不是现成的卖家安全结论。

近 1、6、12 个月好中差评应并列展示,不能相加

近期一个月包含在近期六个月中,六个月又包含在十二个月中。把三列相加会重复计算。建议按评价类别分行、按窗口分列,导出时保留 m1、m6、m12 原字段名。

这里使用接口文档的月份标签,不擅自改成精确的 30、180、365 天。不同接口的统计定义不能直接互换。两次快照的差值也不等于新增评价数:旧评价可能离开滚动窗口,新评价同时进入。评价数量更不能直接当成订单量。

用卖家用户名和站点 domain 查询评价资料

seller 应填卖家资料页或商品卖家链接中的用户名,不是看起来相似的店铺展示名。保存记录时把 domain 一起保存,避免把不同站点上下文混在一起。

这是使用 POST 和 JSON 请求体的读取操作。下面是已观察请求使用过的公开输入,不是对该卖家的推荐,也不保证当前数值不变。仅复制命令、打开页面或展开面板都不会发送请求;替换平台密钥后,需由你主动执行。

curl --request POST \
  'https://api.opendata-api.com/api/project/ebay/seller-profile?key=YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"domain":"co.uk","seller":"musicmagpie"}'

真实密钥不要进入代码仓库、截图或共享日志。即使用环境变量拼接,URL 查询串仍可能被日志记录。本例不需要卖家账户会话或私有 Cookie。

从 data.seller_profile 拆出评价统计,保留嵌套结构

先看 HTTP 状态,再检查平台响应的 code、message、data。平台 data 内是操作结果,操作结果还有自己的 ok、meta、data;卖家资料位于这一层的 data.seller_profile。不要少拆一层,也不要把平台成功误当成字段齐全。

已观察的成功结果确认了资料对象,以及嵌套的 feedback_ratings 和 detailed_seller_ratings。这不保证每次都返回全部文档字段。容器缺失应作为解析问题处理,不能直接造一个空资料,显示成“该卖家没有评价”。

def extract_profile(reply):
    if not isinstance(reply, dict) or str(reply.get("code")) != "200":
        raise ValueError("Platform request did not succeed")
    result = reply.get("data")
    if not isinstance(result, dict) or result.get("ok") is not True:
        raise ValueError("Profile operation did not succeed")
    data = result.get("data")
    profile = data.get("seller_profile") if isinstance(data, dict) else None
    if not isinstance(profile, dict):
        raise ValueError("Missing seller profile")
    return profile

错误处理不要输出含密钥的完整请求地址。执行成功与资料是否适合某次采购判断,是两回事。

信誉分、好评率与近12个月好评率分开处理

feedback_score、feedback_positive_pct、positive_pct_12mo 是三个不同字段。信誉分不是百分比,两个名称不同的百分比也不能相互填补。缺失时显示“未知”,不要用九宫格计数自行算出替代值;分母、重复评价者等口径并没有因此得到确认。

items_sold_display、followers_display 等展示字段同样不应强行转成精确整数。保留返回形式,不把缩写或装饰性文本变成看似准确的成交统计。

缺失评价数不补零,详细卖家评分另行读取

按实际对象取值,仅接受符合预期的计数,其余先保留未知。例如以下代码不会把字符串、布尔值或 null 当成零:

def feedback_matrix(profile):
    source = profile.get("feedback_ratings")
    source = source if isinstance(source, dict) else {}
    matrix = {}
    for sentiment in ("positive", "neutral", "negative"):
        row = source.get(sentiment)
        row = row if isinstance(row, dict) else {}
        matrix[sentiment] = {}
        for window in ("m1", "m6", "m12"):
            value = row.get(window)
            valid = type(value) in (int, float) and value >= 0
            matrix[sentiment][window] = value if valid else None
    return matrix

字符串计数可以另设明确的规范化步骤,但解析失败不能悄悄变成零。详细卖家评分 detailed_seller_ratings 应单独显示。验证只确认它是嵌套对象,没有证明所有卖家都有同一组维度;按运行时返回的键处理,不凭其他页面的字段强制补齐。

保存带时间的卖家快照,不生成未经验证的风险分

内部审核记录可包含调用方填写的站点、用户名、应用自己的 UTC 观察时间、三个独立信誉指标、评价矩阵和详细评分对象。观察时间表示你的程序何时拿到结果,不是所有指标的最后更新时间。

若还要看店铺商品,可用同一明确用户名和站点请求 seller-items,并检查分页。一次商品列表不是完整库存,列表扫描也不能反过来“修正”评价汇总。没有历史接口时,历史观察需要应用自行留存;不能从当前响应倒推过去每一天的数据。

评价汇总不能证明成交量、逐条评价内容或卖家安全

这份资料不提供逐条评价正文、身份核验或完整交易历史。滚动评价变化不等于新增订单,较高好评率也不保证某件商品适合购买。将原字段、未知状态和观察时间交给审核人员,比把窗口相加后贴上一个没有依据的“可信分”更可靠。