获取指定站点当前 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/ebay/deals API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/ebay/deals?key=<API_KEY>'
查询结果
使用场景
- 制作特价资讯邮件或群聊推送,用 price 与 was_price 计算折扣百分比
- 定时抓取特价榜单快照,对比 item_id 差异,只推送上一轮未出现过的新特价
- 用不同 domain 调用 deals,比较各站点折扣商品数量与折扣力度
- 将宣传的 was_price 与同款商品搜索结果的价格中位数对照,识别虚高的折扣
- 当 deal_badge 有值时,按其分组,在看板中区分不同类型的促销
- 把榜单中的 item_id 送入 item-detail,筛选出包邮且卖家条款良好的特价商品清单
常见问题
需要传搜索关键词吗?
不需要。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 则是列表上显示的格式化金额字符串。