一次请求批量获取多个 eBay 商品的完整详情,查不到的商品 ID 会列在 not_found 中,并按商品 ID 逐个计费。
查看 eBay 商品与卖家数据 API 的全部接口 →按商品编号一次查询多个 eBay 商品,并为每个商品返回与单商品详情接口相同的完整记录。item_ids 填写以英文逗号分隔的字符串,每个编号取自商品链接 /itm/ 之后的那串数字;还可以通过 domain 选择站点(已验证 13 个站点,如 com、co.uk、de、com.au、ca),以决定查询的 eBay 站点和结算币种。接口概述写明单次最多 40 个 ID,而 item_ids 参数说明写的是单次最多 15 个,因此如果想保持在更严格的限制内,请按每批 15 个拆分。响应采用 ok/meta/data 三段式结构:data.items[] 中每条记录包含 item_id、title、url、price{value,currency,raw}、list_price、condition、availability、brand、model、mpn、images[]、category_path、item_specifics{}、seller{name,feedback_pct,feedback_count}、shipping{rate,currency,country}、return_policy{days,method}、best_offer、end_time、watchers、quantity_available、quantity_sold,拍卖类商品还会附带 bids、current_bid 等拍卖字段。已下架、被移除或无效的 ID 不会被悄悄丢弃,而是列在 data.not_found[] 中;meta.requested 与 meta.upstream_calls 则告诉你本次提交了多少个 ID、实际计费了多少次。计费按商品 ID 而不是按请求:eBay 没有批量商品接口,所以 N 个 ID 的费用与 N 次单商品查询相同,批量调用节省的是耗时而非费用(接口说明中的实测数据为 8 个 ID 顺序调用 25.6 秒,批量调用 4.1 秒)。一次实际探测(item_ids 为 287070621317,301782776848,domain 为 com)的结果:HTTP 200,ok 为 true,meta.requested 为 2,meta.upstream_calls 为 2,返回两条在售且 InStock 的记录,not_found 为空数组,data.unavailable 为 null。该次探测中第一条记录的 seller.feedback_pct、seller.feedback_count、category_path 和 return_policy 均为 null,所以这些字段请按可选字段处理;第二条记录则返回了 return_policy {days 30, method ReturnByMail} 以及三级分类路径。40 个 ID 的上限、拍卖字段以及非空的 not_found 数组来自接口说明和文档示例,并非探测所得。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/ebay/items-batch API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/items-batch?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"item_ids":"<item_ids>"}' 查询结果
使用场景
- 夜间分批刷新几百个商品 ID 组成的关注清单,并在每批结束后累加 meta.upstream_calls 来执行费用上限
- 把已提交的 ID 与 data.items 做差集,并读取 data.not_found,找出已结束或已被移除的商品
- 给竞品店铺扫描结果补充商品属性、卖家信誉和退货政策,但只针对筛选出的重点商品 ID
- 在发布前核验代发或供应商 SKU 清单,确认每个商品仍显示 listing_status 为 active 且 availability 为 InStock
- 对一组固定的供应商或竞品商品,对比 price 与 list_price,并跟踪 quantity_sold 和 watchers,以发现降价和热销款
- 在确定生产环境的批量大小之前,测算并发抓取相比顺序调用单商品详情所节省的实际耗时
常见问题
一次请求最多可以传多少个商品 ID?
接口概述写的是单次最多 40 个 ID,但 item_ids 参数说明写的是单次最多 15 个,而实际探测只用了 2 个。为了保持在更严格的限制之内,建议每批不超过 15 个,并把 meta.requested 与你实际发送的 ID 数量做对比。
是按请求计费,还是按商品 ID 计费?
按商品 ID 计费。eBay 没有批量商品接口,每个 ID 都是一次独立查询,价格与一次单商品详情调用相同。文档中 meta.upstream_calls 等于你发送的 ID 数量,meta.billing_note 的内容是「按商品 ID 计费,而非按调用计费」(priced per item ID, not per call);探测中传入 2 个 ID,requested 为 2,upstream_calls 也为 2。批量调用节省的是时间,不是计费的查询次数。
eBay 查不到的商品 ID 会怎么处理?
它们会出现在 data.not_found[] 中,而不是被直接丢弃,所以你可以把发送的 ID 与返回的 ID 做对比。文档记录的原因包括商品已结束、被移除或编号无效。探测返回的 not_found 为空数组;非空数组只出现在文档里的示例响应中。由于 meta.upstream_calls 等于发送的 ID 数量,未能解析的 ID 同样会计入其中。
批量调用比反复调用单商品详情更快吗?
从耗时来看是的,因为各个查询是并发执行的。接口说明中的实测为 8 个 ID 顺序调用 25.6 秒,批量调用 4.1 秒(约 6.2 倍)。探测中 2 个 ID 的 meta.latency_ms 约为 3,800,meta.concurrency 为 8。无论哪种方式,计费的查询次数都是一样的。
如果只需要价格、标题和成色,有更省钱的办法吗?
接口说明提到,可以用搜索接口并把 query 写成 (id1,id2,id3),这是 eBay 自带的 OR 语法,只计一次查询,只返回卡片级字段(item_id、title、price、condition、shipping、image、url)。实测每次大约能带 6 个 ID,第 7 个会被丢掉,并且不返回商品属性、卖家和退货政策。这些数据来自接口说明,并非探测所得。
item_ids 应该用什么格式?
使用以逗号分隔的 eBay 商品编号字符串,编号即商品链接 /itm/ 之后的那串数字,例如 287070621317,301782776848。参数说明还提到也可以传列表。本接口不接受商品链接;如果手里只有粘贴来的链接,请改用单商品详情接口。
为什么响应里有些卖家或分类字段是 null?
探测中,第一条记录的 seller.feedback_pct、seller.feedback_count、category_path 和 return_policy 均为 null,而第二条记录则带有退货政策和分类路径。请在解析代码中把这些字段当作可选字段处理;如果需要完整的卖家信誉,请使用卖家资料接口。