通过商品 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/ebay/item-detail API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/item-detail?key=<API_KEY>'
查询结果
使用场景
- 轮询多规格商品的 variations[].values[].out_of_stock,监控各尺码、颜色的变体级库存
- 把市场商品匹配到内部 SKU 时,用品牌、型号、MPN、类目路径和商品规格丰富商品目录
- 定时读取 current_bid、bids、time_left 和 end_time,跟踪拍卖直到结束
- 开启 include_description,扫描卖家描述文本中的必备或违禁用语,审查商品信息
- 选择供应商前,对比同款商品不同卖家的运费和退货期限
- 在聊天机器人或浏览器插件中,用 url 参数而非商品 ID 实现粘贴链接即查详情
- 长期记录 watchers 与 quantity_sold 的变化,估算某个商品的需求热度
常见问题
应该传 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 站点,价格以美元返回。