按用户名查询 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 功能

历史总评分与近 12 个月好评率 feedback_score、feedback_positive_pct 和 positive_pct_12mo 放在同一个对象里,既能看到卖家长期积累的信誉,也能看到最近一年的变化趋势。
按时间窗口统计的反馈数量 feedback_ratings 把好评、中评和差评的数量分别按 m1、m6、m12 三个窗口拆开,近期反馈的下滑可以和长期总数放在一起对照着看。
分项卖家评分 实测返回了 detailed_seller_ratings 对象;已存档的示例中包含与描述相符、沟通、运费合理和发货速度四项五分制评分。
金牌卖家与商家身份标记 top_rated 和 business_seller 都是布尔值,筛选采购候选名单时无需再逐个打开卖家页面人工确认。
店铺规模与经营年限一目了然 items_sold_display、followers_display、member_since 和 location 能说明一家店铺的体量和资历,其中前两项是缩写后的展示字符串,不是数值。
只凭一个用户名即可查询信誉 只有 seller 是必填项,domain 可选。读取公开卖家的信誉不需要 eBay 登录、卖家授权,也不需要提供商品编号。
与店铺商品扫描共用同一个卖家标识 seller-items 扫描所用的用户名可以原样传到这里,因此同一位卖家的商品清单和信誉数据可以直接用该用户名关联起来。

在线 API 演示

POST /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>"}'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

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 之前先检查这个标记。

相关接口

相关指南

查看订阅方案 →