按用户名列出 eBay 卖家店铺内的全部在售商品,支持筛选、排序和分页。

查看 eBay 商品与卖家数据 API 的全部接口 →

以结构化 JSON 返回某个 eBay 卖家店铺里的全部在售商品,无需关键词就能扫描竞争对手或供货商的完整商品目录。唯一必填的参数是 seller,即 eBay 卖家用户名,也就是网址 /usr/{seller} 里的那段名称,或商品页“Sold by”链接中的名称(eBay 链接里的 _ssn 值)。其余可选参数沿用搜索接口的筛选方式:domain(已验证 13 个站点,按操作说明,com.sg、com.hk 等其他 eBay 国家站点同样可用)、category(eBay 数字类目 ID,可用 categories 操作按名称查询)、condition(new、open_box、refurbished、used、for_parts)、以站点币种计价的 price_min 与 price_max、布尔开关 best_offer、free_shipping 和 returns_accepted、location(domestic、us、uk、worldwide、north_america、european_union,可选项遵循各站点自带的商品所在地筛选,因此取决于 domain)、pickup_postcode 配合 pickup_distance(单位为英里,默认 25;仅适用于英国当面自提,需要 domain 为 co.uk),以及 sort(best_match、newly_listed、ending_soonest、price_low、price_high)。page 和 max_results 用于翻页遍历整个目录,max_results 每页取值 1 到 240,超过 240 会被截为 240。响应采用 ok/meta/data 三段式结构:data.seller 为卖家用户名,data.results[] 是商品卡片,包含 item_id、title、price{value,currency}、condition、buying_format、shipping、location、image 和 url,meta.pagination 给出分页状态,其中包括 has_more。实测探测结果(卖家 musicmagpie,domain 为 co.uk,max_results 为 5):HTTP 200,ok 为 true,存在 meta.pagination,data.seller 为字符串,data.results 是包含 5 张卡片的数组。已存档的源示例并未经过探测验证,来自另一次不同的调用(价格为美元,链接指向 ebay.com);其中部分卡片还带有 price.raw、形如“1,062 sold”的 sold_count 文本和 catalog_rating{average,review_count},运费显示为“+$4.71 delivery”这样的展示文本,而 condition 字段里是卖家的宣传语而不是成色标签,因此请把卡片上的 condition 当作展示文本,需要按成色过滤时请使用 condition 筛选参数。除 domain 和 max_results 之外的筛选参数没有在探测中验证过,操作说明中提到的翻页深度上限是在搜索查询上测得的,并非针对店铺目录。

API 功能

一个用户名拿下整个店铺 只需传入 seller,就能得到该卖家店铺里的在售商品,不必提供任何关键词。这正是它与搜索操作的根本区别。
与搜索一致的商品卡片 每张卡片都包含 item_id、title、price{value,currency}、condition、buying_format、shipping、location、image 和 url,结构与搜索结果相同,同一套解析代码即可同时处理两个操作。
只在单个卖家范围内筛选 category、condition、price_min、price_max、best_offer、free_shipping 和 returns_accepted 可以把店铺目录收窄到你真正关注的产品线、价格带或交易条件。
原生分页,轻松翻完大目录 page 与 max_results(1 到 240)配合 meta.pagination.has_more,只需一个简单循环就能一直翻到大型卖家的目录结束。
价格梯度与新品上架排序 sort 支持 best_match、newly_listed、ending_soonest、price_low 和 price_high,可以优先读取卖家最便宜、最贵或最新上架的商品。
item_id 可直接用于深度查询 每张卡片上的 item_id 和 url 都能交给 items-batch 或 item-detail,只为真正需要的店铺商品获取完整详情,节省调用成本。
部分卡片附带需求线索 已存档的源示例显示,部分卡片带有 sold_count 文本和 catalog_rating 对象。这些附加字段不保证出现在每张卡片上,也未经探测确认。

在线 API 演示

POST /api/project/ebay/seller-items

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X POST 'https://api.opendata-api.com/api/project/ebay/seller-items?key=<API_KEY>' \ -H 'Content-Type: application/json' \ -d '{"seller":"<seller>"}'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

seller 字段应该填什么?

填写 eBay 卖家用户名,也就是网址 /usr/{seller} 中的那段名称,或商品页“Sold by”链接里的名称(eBay 的 _ssn 值)。这是唯一的必填字段。探测时使用的是 musicmagpie。

seller-items 与搜索有什么区别?

搜索需要关键词,并在所有卖家范围内查找。seller-items 改为接收卖家用户名,返回该卖家店铺内的在售商品,卡片结构、筛选条件(类目、成色、价格区间、运费、退货、所在地、自提、排序)以及 page 和 max_results 分页方式都与搜索一致。

如何读取某个卖家的完整目录?

把 max_results 设为 240(每页上限,更大的值会被截为 240),page 从 1 开始递增,直到 meta.pagination.has_more 为 false 时停止。操作说明里测得的约 450 页深度来自搜索查询;单个店铺通常小得多,该深度并没有在店铺上测量过。

一张商品卡片包含哪些内容?

文档列出的字段有 item_id、title、price{value,currency}、condition、buying_format、shipping、location、image 和 url。探测确认了 max_results 为 5 时返回包含 5 张卡片的数组,但探测摘要没有列出每张卡片的具体字段。已存档的源示例(未经探测验证)还显示,部分卡片带有 price.raw、sold_count(例如“1,062 sold”)以及 catalog_rating{average,review_count}。

卡片上的 condition 字段可靠吗?

它不是一个干净的成色标签。在已存档的源示例中,店铺卡片的 condition 字段里是卖家的宣传语(例如“Great Prices & Quality from musicMagpie. 13m+ Feedbacks”),而不是 new 或 used 这样的值。如果想获取某种成色的商品,请直接传 condition 参数(new、open_box、refurbished、used、for_parts),不要去解析卡片文本。

价格是什么币种?domain 会改变什么?

domain 用来选择 eBay 站点,按操作说明,它同时决定币种和本地商品;price_min 与 price_max 按该站点的币种解释。已存档的源示例来自使用美元和 ebay.com 链接的调用,一位英国卖家的商品也以美元标价,所以请查看每张卡片的 price.currency,不要凭卖家所在国家去假设币种。

会返回已售出或已结束的商品,或者卖家评价吗?

不会。它只返回在售商品。如果需要卖家的评分、好评率、金牌卖家状态和评分明细,请用同一个用户名调用 seller-profile 操作。

这里的自提筛选是怎么工作的?

pickup_postcode 把结果限定为可在某个英国邮编附近当面自提的商品,并且要求 domain 为 co.uk。pickup_distance 设置半径(单位为英里,默认 25);eBay 提供 10、25、50、100、200 和 500 几档,其他数值会按更大的下一档处理。pickup_distance 只有与 pickup_postcode 一起使用才会生效。探测中没有验证这个筛选。

实时探测验证了什么?

使用卖家 musicmagpie、domain 为 co.uk、max_results 为 5 的调用返回了 HTTP 200,ok 为 true,meta 对象中包含 pagination,data.seller 为字符串,data.results 是包含 5 张商品卡片的数组。其他筛选条件、排序方式和深度翻页都没有在探测中验证过。

相关接口

相关指南

查看订阅方案 →