eBay 卖家评价 API:正确读取近 1、6、12 个月的好中差评数据
| 评价类别 | 近 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,并检查分页。一次商品列表不是完整库存,列表扫描也不能反过来“修正”评价汇总。没有历史接口时,历史观察需要应用自行留存;不能从当前响应倒推过去每一天的数据。
评价汇总不能证明成交量、逐条评价内容或卖家安全
这份资料不提供逐条评价正文、身份核验或完整交易历史。滚动评价变化不等于新增订单,较高好评率也不保证某件商品适合购买。将原字段、未知状态和观察时间交给审核人员,比把窗口相加后贴上一个没有依据的“可信分”更可靠。