按用户名列出 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>"}' 查询结果
使用场景
- 每天对竞争对手的店铺做一次快照,比对 item_id 的增减,发现新上架、已下架和调价的商品
- 先用 sort 为 price_low 再用 price_high 各取一遍,或用 price_min 和 price_max 切片,搭建某个卖家的价格梯度视图
- 开启 free_shipping、returns_accepted 或 best_offer 后扫描卖家商品,寻找一件代发或批发供货商
- 把店铺扫描限定在用 categories 操作查到的数字类目 ID 内,只追踪你正在竞争的那条产品线
- 把店铺扫描得到的 item_id 交给 items-batch,只为真正重要的商品拉取完整规格
- 以每页 240 条翻页,直到 meta.pagination.has_more 变为 false,据此估算某个卖家在售目录的规模
常见问题
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 张商品卡片的数组。其他筛选条件、排序方式和深度翻页都没有在探测中验证过。