按用户名查询 eBay 卖家的信用评分、好评率、评分明细,以及金牌卖家和商家身份。
查看 eBay 商品与卖家数据 API 的全部接口 →以结构化 JSON 返回某位 eBay 卖家的公开信誉数据。唯一必填的参数是 seller,即 eBay 卖家用户名,也就是网址 /usr/{seller} 里的那段名称,或商品页“Sold by”链接中的名称。domain 为可选参数,用于选择 eBay 站点(已验证 13 个站点,按操作说明,com.sg、com.hk 等其他 eBay 国家站点同样可用)。调用时无需你自己拥有 eBay 账号,也不需要卖家授权,数据来自公开可见的卖家信息。响应采用 ok/meta/data 三段式结构,data.seller_profile 按文档包含 store_name、feedback_score、feedback_positive_pct、positive_pct_12mo、items_sold_display、followers_display、member_since、location、business_seller、top_rated 和 feedback_ratings,其中 feedback_ratings 是一个对象,含 positive、neutral、negative 三项,每一项都带有 m1、m6、m12 三个计数。实测探测结果(卖家 musicmagpie,domain 为 co.uk):HTTP 200,ok 为 true,存在 meta,data.seller_profile 是一个对象,其中包含 seller、feedback_score、positive_pct_12mo、feedback_ratings 和 detailed_seller_ratings 等字段。已存档的源示例并未经过探测验证,其 meta 中的 domain 为 com;示例里 feedback_score 是一个很大的整数,feedback_positive_pct 和 positive_pct_12mo 是形如 99.1 的百分比,items_sold_display 和 followers_display 是“51.1M”“487K”这类缩写的展示字符串而不是数字,member_since 是形如“Feb-02-11”的展示日期,location 是国家名称,business_seller 和 top_rated 是布尔值,detailed_seller_ratings 则是 Accurate description(与描述相符)、Communication(沟通)、Reasonable shipping cost(运费合理)和 Shipping speed(发货速度)四项五分制评分。示例中出现的是 seller 字段而没有 store_name,因此不要假定 store_name 一定存在。示例的 meta 还带有 record_count 和 feedback_upstream_error 标记(示例中为 false),建议记入日志。目前只探测过一位卖家(musicmagpie),对于不存在的卖家名称,其行为尚未验证。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/ebay/seller-profile API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/seller-profile?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"seller":"<seller>"}' 查询结果
使用场景
- 下单前评估供应商或批发清仓卖家,把 feedback_score 和 positive_pct_12mo 与自己设定的最低标准逐项比对
- 给竞品店铺打分:将 seller-profile 的结果与 seller-items 的店铺目录扫描按同一卖家用户名合并分析
- 定期保存 positive_pct_12mo 和 feedback_ratings 各窗口的快照,及时发现近期反馈走低的卖家
- 制作采购候选名单时,突出显示标记为 business_seller 或 top_rated 的卖家
- 为转售商做购前风险筛查,把 m1、m6、m12 窗口内的差评数量与反馈总量对比
- 在比价工具里给卖家加一个信誉浮窗,用 detailed_seller_ratings 展示发货速度、沟通等分项评分
常见问题
seller-profile 会返回什么?
返回与你所传卖家用户名对应的 data.seller_profile 对象。文档列出的字段有 store_name、feedback_score、feedback_positive_pct、positive_pct_12mo、items_sold_display、followers_display、member_since、location、business_seller、top_rated,以及含 positive、neutral、negative 三类、每类带 m1、m6、m12 计数的 feedback_ratings。
实测探测确认了哪些字段?
用卖家 musicmagpie 和 domain 为 co.uk 调用,返回 HTTP 200、ok 为 true,data.seller_profile 对象中包含 seller、feedback_score、positive_pct_12mo、feedback_ratings 和 detailed_seller_ratings 等字段。其余字段,例如 items_sold_display 和 member_since,来自操作说明和已存档的源示例,探测摘要并没有逐一确认。
m1、m6、m12 分别代表什么?
它们是 feedback_ratings 的三个时间窗口。结合同样带有时间范围的 positive_pct_12mo 字段来看,可以理解为最近 1 个月、6 个月和 12 个月,已存档示例中的计数也确实按 m1、m6、m12 依次增大。不过操作说明并没有明确写出这些窗口的含义,据此设定阈值之前,请先用自己的数据核对。
items_sold_display 和 followers_display 是数字吗?
不是。在已存档的源示例中,它们是缩写后的展示字符串,例如“51.1M”和“487K”,如果需要数值,请自行解析末尾的单位后缀。feedback_score 是普通整数,各个百分比字段则是形如 99.1 的数字。
使用时需要 eBay 账号或登录吗?
不需要。你只需传入卖家用户名,以及可选的 domain。返回的是公开可见的卖家信息,你这一侧不涉及 eBay 凭证、OAuth 令牌或卖家授权。
domain 参数会改变卖家的信誉数据吗?
操作说明只写明 domain 用于选择 eBay 站点。探测使用的是 co.uk,已存档的源示例中 meta 报告的 domain 为 com,两者都返回了同一用户名的 seller_profile,且示例中的 location 显示为英国。如果你要对比不同站点上的信誉,请对每个 domain 分别调用,再自行比较结果。
top_rated 是什么意思,能直接依赖它吗?
它是 seller_profile 中的布尔值。操作说明没有说明它是否对应 eBay 的“金牌卖家”或“金牌卖家 Plus”标识,而且已存档示例里,一位成交量极高的商家卖家返回的是 false。建议把它当作需要用你自己的卖家样本去验证的标记,并与 feedback_score、positive_pct_12mo 配合使用。
怎样同时拿到这位卖家的商品列表?
用同一个用户名调用 seller-items,即可列出该卖家店铺中的在售商品,再按卖家用户名把两份结果关联起来。seller-profile 本身只返回信誉数据。
meta 里的 feedback_upstream_error 是什么?
已存档的源示例中,meta.feedback_upstream_error 为 false,同时 record_count 为 1。操作说明没有对它做出定义,但建议把它记入日志,并在自动化流程里信任 feedback_ratings 之前先检查这个标记。