一次请求批量获取多个 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 功能

单次请求查询多个商品 ID item_ids 传入以逗号分隔的字符串,即可在 data.items[] 中为每个查到的商品拿到一条记录。接口概述写单次最多 40 个 ID,参数说明写 15 个,建议按更严格的数字来拆分批次。
与单商品详情一致的完整记录 每条记录都包含标题、价格、list_price、成色、品牌、型号、MPN、图片、分类路径、商品属性、卖家信誉、运费条款、退货政策和数量字段,而不只是搜索结果里的简略卡片。
明确列出查不到的商品 eBay 无法解析的 ID(如已结束、被移除或无效的商品)会出现在 data.not_found[] 中,而不是凭空消失,所以你始终能知道一批请求里是哪个商品丢了。
meta 中的计费计数 meta.requested、meta.upstream_calls 和 billing_note 会说明本次提交并计费了多少个 ID,方便你为每一批核算费用,并在达到预算上限时及时停止任务。
并发抓取降低等待时间 各商品并行抓取(探测中 meta.concurrency 为 8)。接口说明中的实测为 8 个 ID 顺序调用 25.6 秒、批量调用 4.1 秒,省下的是等待时间,计费的查询次数并不会减少。
13 个已验证的 eBay 站点 domain 可选 com、co.uk、de、com.au、ca、fr、it、es、nl、at、ch、ie 或 pl,用来决定币种和本地化的商品;com.sg、com.hk 等其他 eBay 国家站点同样可以使用。

在线 API 演示

POST /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?

接口概述写的是单次最多 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,而第二条记录则带有退货政策和分类路径。请在解析代码中把这些字段当作可选字段处理;如果需要完整的卖家信誉,请使用卖家资料接口。

相关接口

相关指南

查看订阅方案 →