获取指定站点当前 eBay 每日特价(Daily Deals)榜单,含促销价、原价和运费信息。

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

返回某个 eBay 站点的 Daily Deals 页面当前展示的促销商品,无需提供搜索关键词。可选参数 domain 用于选择 13 个已验证站点之一(com、co.uk、de、com.au、ca、fr、it、es、nl、at、ch、ie、pl),同时决定币种和本地商品;可选参数 max_results 设置返回的特价卡片数量,最多 240。响应采用 ok/meta/data 外层结构,data.results[] 中每张卡片对应一个特价商品,包含 item_id、title、price{value, currency, raw}、was_price{value, currency, raw}、shipping、deal_badge、image 和 url。实测示例(domain 为 com,max_results 为 5):返回 5 张以美元计价的卡片,其中 4 张带有 was_price 对象,1 张的 was_price 为 null;shipping 为文本 Free shipping 或 null;所有卡片的 deal_badge 均为 null,因此 was_price、shipping 和 deal_badge 都应按可选字段处理。meta.record_count 为 5,meta.domain 为 com。

API 功能

促销价与原价并列 每张卡片同时给出 price 和 was_price,二者都含数值、币种和原始展示字符串,折扣率只需做一次减法;未展示参考价时 was_price 为 null(实测 5 张中有 1 张)。
无需任何查询条件 只传 domain,甚至传空请求体,就能拿到全站促销特价榜单,首次调用前无需做任何参数调整。
每张卡片带运费标签 shipping 字段保留特价卡片上显示的运费说明,如 Free shipping;榜单未显示时为 null,方便你筛选包邮优惠。
特价徽章字段 deal_badge 用于区分不同类型的促销;实测 5 张卡片均为 null,因此编码时应把它当作可选字段,不要当作一定存在的标签。
可衔接详情的商品 ID 每张卡片都带有 item_id 和商品 url,看中的特价商品可直接交给 item-detail 接口,进一步获取规格、卖家和退货条款。
按站点返回本地币种 domain 决定返回哪个 eBay 站点的特价,价格以该站点的币种返回(实测 com 站点为美元)。

在线 API 演示

POST /api/project/ebay/deals

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

需要传搜索关键词吗?

不需要。deals 接口只接受可选的 domain 和 max_results 参数,返回所选站点当前的促销榜单,因此空 JSON 请求体也是有效请求。

每张特价卡片包含哪些字段?

包含 item_id、title、price、was_price、shipping、deal_badge、image 和 url。price 与 was_price 是带 value、currency、raw 的对象;实测 5 张卡片都返回了这八个键。

如何计算折扣百分比?

对 was_price 不为 null 的卡片,计算 (was_price.value - price.value) / was_price.value。实测 5 张卡片中 4 张带有 was_price,1 张为 null,没有 was_price 的卡片请直接跳过,不要当作折扣为零。

deal_badge 为什么是 null?

实测 5 张卡片的 deal_badge 全部为 null,说明该字段存在但可能为空。不要把它当作必有的标签,可改为比较 price 与 was_price。

每次调用最多能获取多少条特价?

max_results 取值 1 到 240,超过 240 会被截断为 240。实测请求 5 条,返回 5 张卡片,meta.record_count 也确认了返回数量。

如何获取某个特价商品的完整信息?

取出卡片中的 item_id,发送给 item-detail 接口即可。它会返回品牌、型号、商品规格、卖家、运费和退货政策,这些内容特价榜单本身不包含。

价格是什么币种?

币种取决于所选站点。实测使用 com 站点,所有 price 和 was_price 的 currency 均为 USD,raw 则是列表上显示的格式化金额字符串。

相关接口

相关指南

查看订阅方案 →