通过商品 ID 或商品链接获取 eBay 商品完整详情,含价格、卖家、运费、退货政策和商品规格。

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

返回单个 eBay 商品的完整详情记录,可用 item_id(商品链接中 /itm/ 后面的数字)或完整的商品链接 url 指定,二者提供其一即可。domain 用于选择 13 个已验证站点之一(com、co.uk、de、com.au、ca、fr、it、es、nl、at、ch、ie、pl);将 include_description 设为 true 会内联完整的卖家描述文本,代价是多一次请求。响应采用 ok/meta/data 外层结构,data.item 即商品信息。实测示例(item_id 为 287070621317,domain 为 com):返回 item_id、title、url、price{value, currency, raw}、list_price、condition、availability、brand、model、mpn、images[](url、width、height,有时带 description)、含 22 项的 item_specifics{}、seller{name, feedback_pct, feedback_count}、shipping{country, currency, rate}、return_policy{days, method}、best_offer、quantity_available、quantity_sold、watchers、end_time、attributes{dimensions, weight} 和 description_url。该样本中 seller.feedback_pct、seller.feedback_count、category_path 以及 attributes 的两个值均为 null。另有文档说明但本次实测商品未涉及的字段:拍卖商品的 bids、current_bid 和 time_left,多规格商品的 variations[]{dimension, values[]{value, out_of_stock}},以及设置 include_description 后出现的 description 字段。

API 功能

按商品 ID 或粘贴链接查询 已知商品编号时传 item_id,或直接粘贴完整的商品链接 url;二者任一即可定位商品,用户提供的链接无需自己再解析 ID。
商品标识与规格参数 返回 brand、model、mpn 以及 item_specifics 对象(实测含 22 项,如 Color、RAM、Screen Size、Network),便于把商品与自有目录做匹配。
价格、标价与库存信号 price 与 list_price(实测为 274.99 对 899)同 availability、quantity_available、quantity_sold、watchers、best_offer 一起返回,在一条记录里给出需求与折扣背景。
运费与退货条款 shipping 提供 country、currency 和 rate,return_policy 提供退货期限天数与退货方式,可用于横向比较不同商品的卖家条款。
拍卖与多规格字段 根据接口文档,拍卖商品会增加 bids、current_bid 和 time_left,多规格商品会增加 variations[],其中每个取值带 out_of_stock 标记;实测商品两者都没有,请按可选字段处理。
可选的完整卖家描述 将 include_description 设为 true 可内联卖家描述文本,用于合规或关键词检查;它会多消耗一次请求,默认关闭,实测无论是否开启都会返回 description_url。

在线 API 演示

POST /api/project/ebay/item-detail

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

查看价格

API 响应 (JSON)

{}
curl -X POST 'https://api.opendata-api.com/api/project/ebay/item-detail?key=<API_KEY>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

应该传 item_id 还是 url?

二选一即可。item_id 是商品链接中 /itm/ 后面的数字,url 则接受完整的商品链接。接口文档说明二者必须提供其一,尽管在 schema 中两者都是可选的,所以两者都不传的请求不应发送。

include_description 有什么作用?

设为 true 会同时获取并内联完整的卖家描述文本,代价是多一次请求,因此默认关闭。实测未开启时,商品返回的是 description_url。

哪些字段只出现在拍卖商品上?

接口文档列出了拍卖商品的 bids、current_bid 和 time_left。实测商品是一口价商品,没有返回这些字段,但返回了 end_time,因此读取每个键之前请先判断是否存在。

多规格商品如何表示?

根据接口文档,variations[] 中每个维度(如尺码或颜色)对应一个条目,其 values[] 包含 value 和 out_of_stock。实测商品在 meta 中的 has_variations 为 false,所以该结构只有文档说明,尚未实测到。

为什么卖家好评相关字段是 null?

实测中 seller.feedback_pct 和 seller.feedback_count 为 null,而 seller.name 有值,category_path 与 attributes 同样为 null。请把这些字段当作可空字段,不要用它们作为必备的质量门槛。

能一次查询多个商品吗?

本接口每次请求只返回一个商品。如需一次处理多个商品 ID,可使用同一 API 中的 items-batch 接口,每次最多接受 40 个 ID。

应该选哪个 domain?

使用商品所属的 eBay 站点,例如 ebay.com 的商品用 com;domain 决定币种和本地商品环境。实测使用 com 站点,价格以美元返回。

相关接口

相关指南

查看订阅方案 →