AnyAPIAnyAPI

eBay 已售商品

/ebay.sold_listings

按关键词逐页获取 eBay 近期已售商品,可选价格范围、成色、分类、售出日期和排序条件;返回成交价、售出日期、成色、卖家和商品详情,适用于定价研究。

最近 7 天完成的调用
0

统计不包含取消的调用。执行时间仅统计成功调用。

通过你的 Agent 使用

请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 AnyAPI 的 /ebay.sold_listings 接口。

输入参数

page选填
结果页码,从 1 开始。结合输出中的 hasMore 分页;翻页时保持 query、filters 和 limit 不变,因为 limit 决定每页大小。
site选填
要搜索的 eBay 国家站点。目前已售商品仅覆盖美国。
sort选填
结果排序方式;省略则为 ended_recently(例如 price_high 按成交价加运费从高到低排序)。
limit选填
返回结果数上限(1-60,默认 25)。
query必填
已售商品搜索关键词(例如 iphone 13 pro)。
seller选填
当前数据源不支持:设置此项的请求会被拒绝,不收费。
endDate选填
仅返回此日期及之前售出的商品,包含当天,格式为 YYYY-MM-DD(例如 2026-09-15)。每页获取后再应用此边界,因此一页可能少于 limit 条甚至为空,但 hasMore 仍为 true;请继续请求下一页,直至 hasMore 为 false。
maxPrice选填
可选最高成交价,使用站点币种(例如 500)。
minPrice选填
可选最低成交价,使用站点币种(例如 200)。
condition选填
商品成色筛选(例如 used)。
startDate选填
仅返回此日期及之后售出的商品,包含当天,格式为 YYYY-MM-DD(例如 2026-09-01)。
categoryId选填
可选 eBay 数字分类 id,限定搜索范围(例如 9355 表示手机与智能手机,9394 表示手机配件)。
listingType选填
限定商品销售形式;省略或使用 all 则包含两种形式(例如 auction 仅含拍卖成交)。
freeShipping选填
当前数据源不支持:仅接受 false(不筛选);true 会被拒绝,不收费。
returnsAccepted选填
当前数据源不支持:仅接受 false(不筛选);true 会被拒绝,不收费。
preferLatencyUnderMs选填
可选;省略时保持原路由,由最便宜的数据源提供结果。优先选择典型响应时间低于指定毫秒数的数据源,再从中选择最便宜的一个;典型响应时间指该接口数据源健康信息公布的过去 30 天响应时间中位数。这可能提高费用:如果最便宜的数据源无法达到目标,会改用更快但更贵的数据源,并按该来源的价格报价和计费。若没有数据源满足速度目标,仍会选择性价比最高的数据源完成请求,不会仅因速度慢而拒绝。尚未计时的数据源最后尝试。这只是偏好,不是保证:中位数描述历史请求,不是本次请求的耗时上限,也不包括请求本身要求的等待时间。对分页查询,该偏好仅用于第一页;后续页继续使用第一页所选的数据源及其报价。
source选填
可选。按优先顺序指定数据源 ID,取值来自 /catalog 或 /apis 中该接口的 `lanes[].source.id`。省略时使用最便宜的数据源,并支持自动故障切换。除非 `allowFallbacks` 为 false,否则先按给定顺序尝试列表中的来源,再尝试其他来源。仅指定一个来源且将 `allowFallbacks` 设为 false 时,只会由该来源按其价格提供结果,准确报价和计费,不会切换。报价取所有可能被使用的数据源中的最高价。不支持该接口的数据源 ID 会作为无效输入拒绝且不计费;列表中当前不可用的数据源也会被拒绝且不计费,省略 `source` 可改用其他来源。分页查询的后续请求必须继续包含第一页使用的数据源,或省略 `source`。
allowFallbacks选填
可选,默认为 true。设为 false 时,只允许 `source` 中列出的来源提供结果;若没有来源能提供服务,则拒绝请求且不计费。设为 true 时先尝试列出的来源,之后可按正常价格尝试其他来源。
ignoreSources选填
可选。指定本次请求要跳过的数据源 ID,取值来自该接口的 `lanes[].source.id`。使用剩余来源中最便宜的一个,报价则取剩余来源中的最高价。不支持该接口的数据源 ID,或同时出现在 `source` 中的 ID,都会作为无效输入拒绝且不计费;跳过全部来源也会以同样方式拒绝。

输入示例

{
  "sort": "ended_recently",
  "limit": 10,
  "query": "iphone 13 pro"
}

输出

AnyAPI 输出:found (布尔值), data.items (匹配记录);未找到结果时包含 reason。