eBay API
eBay 已售商品 API
按任意关键词获取最近售出的 eBay 商品,可选价格区间、成色、类目、售出日期和排序筛选,逐页返回(成交价、售出日期、成色、卖家、物品详情);非常适合做定价调研。
POST/v1/run/ebay.sold_listings
可用率
98.79%
30d · 165 次调用
请求数
165
30d · 按周,近 12 周
响应时间
8.5s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"hasMore": true,
"items": [
{
"bestOfferAccepted": true,
"bidCount": 12500,
"condition": "example",
"countryCode": "US",
"epid": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"images": [
"https://example.com/image.jpg"
],
"itemId": "a1b2c3d4",
"listingType": "general",
"sellerFeedbackCount": 12500,
"sellerFeedbackPercent": 12.5,
"sellerUsername": "alex_rivera",
"shippingCost": "19.99",
"soldCurrency": "USD",
"soldPrice": 19.99,
"soldUtc": 12.5,
"title": "Example title",
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface EbaySoldListingsResponse {
data: {
hasMore?: boolean;
items: {
bestOfferAccepted?: boolean;
bidCount?: number;
condition?: string;
countryCode?: string;
epid?: string;
image?: string;
images?: string[];
itemId: string;
listingType?: string;
sellerFeedbackCount?: number;
sellerFeedbackPercent?: number;
sellerUsername?: string;
shippingCost?: string;
soldCurrency?: string;
soldPrice?: number;
soldUtc?: number;
title: string;
url: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/ebay.sold_listings
curl -X POST https://api.getanyapi.com/v1/run/ebay.sold_listings \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"limit":10,"query":"iphone 13 pro","sort":"ended_recently"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| query | string | "iphone 13 pro"已售物品的搜索关键词(例如 iphone 13 pro)。 |
| categoryId | string | 可选,在其中搜索的 eBay 数字类目 ID(例如 9355 表示 Cell Phones & Smartphones,9394 表示 Cell Phone Accessories)。 |
| condition | enum | 物品成色筛选(例如 used)。 |
| endDate | string | 只返回在此日期或之前售出的商品(含当天),格式为 YYYY-MM-DD(例如 2026-09-15)。此限制在每页获取后才应用,因此即使 hasMore 仍为 true,某一页的商品也可能少于 limit 条,甚至为空:请持续请求下一页,直到 hasMore 为 false。 |
| freeShipping | boolean | 当前数据源不支持:只接受 false(不筛选);true 会被拒绝,不扣费。 |
| limit | integer | 10最多返回的结果数量(1-25,默认 25)。 |
| listingType | enum | 限定刊登形式;省略或使用 all 表示两者都包含(例如 auction 表示仅拍卖成交)。 |
| maxPrice | number | 可选,最高成交价,以站点币种计(例如 500)。 |
| minPrice | number | 可选,最低成交价,以站点币种计(例如 200)。 |
| page | integer | 结果页码,从 1 开始。配合输出中的 hasMore 分页;翻页时请保持 query、筛选条件和 limit 不变,因为 limit 决定每页大小。 |
| returnsAccepted | boolean | 当前数据源不支持:只接受 false(不筛选);true 会被拒绝,不扣费。 |
| seller | string | 当前数据源不支持:设置了此参数的请求会被拒绝,不扣费。 |
| site | enum | 要搜索的 eBay 国家站点。已售商品目前只覆盖美国。 |
| sort | enum | "ended_recently"结果排序方式;省略时为 ended_recently(例如 price_high 表示按成交价加运费从高到低排序)。 |
| startDate | string | 只返回在此日期或之后售出的商品(含当天),格式为 YYYY-MM-DD(例如 2026-09-01)。 |
| 响应 | ||
| data | object | |
| data.hasMore | boolean | True when another results page exists. With endDate set a page can be short or empty while this is still true; request page + 1 to continue. |
| data.items | object[] | Sold listing records: title, sold price, sale date, condition, seller, and item URL. Populated whenever the provider has data for the entity. |
| data.items[].bestOfferAccepted | boolean | True when eBay marked the sale as Best Offer accepted. Absent when the source could not tell. |
| data.items[].bidCount | integer | Number of bids the listing received, for auction sales. |
| data.items[].condition | string | Item condition as listed (e.g. Pre-Owned). |
| data.items[].countryCode | string | ISO country code of the eBay marketplace the sale happened on. |
| data.items[].epid | string | eBay catalog product identifier (ePID), when the listing is matched to a catalog product. |
| data.items[].image | string | Primary listing image URL. Populated whenever the provider has data for the entity. |
| data.items[].images | string[] | All listing image URLs, primary first. |
| data.items[].itemId | string | eBay item identifier. Populated whenever the provider has data for the entity. |
| data.items[].listingType | string | Sale format: Auction or Fixed price. |
| data.items[].sellerFeedbackCount | integer | Seller's lifetime feedback count. Populated whenever the provider has data for the entity. |
| data.items[].sellerFeedbackPercent | number | Seller's positive-feedback percentage. Populated whenever the provider has data for the entity. |
| data.items[].sellerUsername | string | Seller's eBay username. Populated whenever the provider has data for the entity. |
| data.items[].shippingCost | string | Shipping the buyer paid, in the site currency (e.g. "$5.55"; "$0" is free shipping). |
| data.items[].soldCurrency | string | ISO currency code of the sold price (e.g. USD). |
| data.items[].soldPrice | number | Final sold price in the site currency. When bestOfferAccepted is true this is the listing's asking price: eBay does not publish the accepted offer amount. |
| data.items[].soldUtc | number | UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. |
| data.items[].title | string | Listing title as it appeared on eBay. Populated whenever the provider has data for the entity. |
| data.items[].url | string | Canonical listing URL. Populated whenever the provider has data for the entity. |
| found | boolean | |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0135 |
| 价格(/千次请求) | USD | US$13.50 |
常见问题
关于 eBay 已售商品 API
AnyAPI 的 eBay 已售商品 API 只需一次 POST 请求 /v1/run/ebay.sold_listings,就以统一格式的 JSON 返回 eBay 数据。按任意关键词获取最近售出的 eBay 商品,可选价格区间、成色、类目、售出日期和排序筛选,逐页返回(成交价、售出日期、成色、卖家、物品详情);非常适合做定价调研。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$13.50 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 eBay 已售商品 API 调用中有 98.8% 成功,响应时间中位数为 8.5 秒,共测量 165 次调用。
费用:每千次请求 US$13.50 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
按任意关键词获取最近售出的 eBay 商品,可选价格区间、成色、类目、售出日期和排序筛选,逐页返回(成交价、售出日期、成色、卖家、物品详情);非常适合做定价调研。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 eBay 已售商品 API 调用中有 98.8% 成功,响应时间中位数为 8.5 秒,共测量 165 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。