eBay Accepted offers API
Retrieve completed eBay sales for any keyword with the price the buyer actually paid, including accepted Best Offer amounts where available, plus the sale date, units sold, shipping, and format. History is available back to December 2023. Auctions are never Best Offers, so look at fixed-price sales. Results come back newest first, so with a small limit the sales can cover only the last few days of a date window; raise limit (up to 240) to cover more of it.
价格
eBay Accepted offers API 价格
试一试
一个请求获取 eBay Accepted offers
{
"data": {
"items": [
{
"bestOfferAccepted": true,
"bidCount": 12500,
"condition": "example",
"image": "https://example.com/image.jpg",
"itemId": "a1b2c3d4",
"listingType": "general",
"shippingCost": "19.99",
"soldCurrency": "USD",
"soldPrice": 19.99,
"soldUtc": 12.5,
"title": "Example title",
"totalSales": 12500,
"unitsSold": 42,
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
一个请求,一种响应结构。
你发送的每个字段和收到的每个字段,都附有真实示例。
最近验证于 2026-11-20 · 可用率和延迟按 30d 统计
请求体
JSON,POST 到这个接口。
- querystring
Gibson Les Paul Standard 60s
Search keyword for completed eBay sales (e.g. Gibson Les Paul Standard 60s).
- conditionenum
used
物品成色筛选(例如 used)。
- endDatestring
Last sale day to include, as YYYY-MM-DD (e.g. 2026-10-31).
- limitinteger
10
Maximum number of sales to return (1-240, default 240). Sales without a listing title or image are left out, so a page can hold fewer.
- maxPricenumber
Optional maximum price paid, in USD (e.g. 2000). It trims the returned page; it does not search all history for sales at that price.
- minPricenumber
Optional minimum price paid, in USD (e.g. 200). It trims the returned page; it does not search all history for sales at that price.
- startDatestring
First sale day to include, as YYYY-MM-DD (e.g. 2026-10-01). History is available back to December 2023. With neither date set, the last 90 days are searched.
响应
JSON,每个字段一个示例值。
Completed eBay sales, newest first: title, the price the buyer actually paid, sale date, units sold, shipping, format, and item URL. Populated whenever the provider has data for the entity.
- bestOfferAcceptedboolean
True when the sale was identified as a Best Offer the seller accepted, so soldPrice is the accepted offer (on a multi-unit listing, the rounded average paid per unit). Auctions are never Best Offers, so it is true only on fixed-price sales. False when it was not identified as one, which does not prove a full-price sale; sales from the last few hours are often not flagged yet. Absent when it could not be determined: on busy searches some older date windows come back with no Best Offer flag at all.
- bidCountinteger
Number of bids the listing received, for auction sales.
- conditionstring
Item condition (new or used), returned only when the request filtered by condition.
- imagestring
Primary listing image URL. Populated whenever the provider has data for the entity.
- itemIdstring
eBay item identifier. Populated whenever the provider has data for the entity.
- listingTypestring
Sale format: Auction or Fixed price.
- shippingCoststring
Shipping the buyer paid, in USD (e.g. "$18"; "$0" is free shipping).
- soldCurrencystring
ISO currency code of the price paid (USD).
- soldPricenumber
Price the buyer actually paid, in USD. On a Best Offer sale this is the accepted offer where available; when a listing sold more than one unit it is the average per unit (see unitsSold and totalSales).
- soldUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- titlestring
Listing title as it appeared on eBay. Populated whenever the provider has data for the entity.
- totalSalesnumber
Total paid across all units sold, in USD, as the listing reported it. soldPrice is this total divided by unitsSold, rounded, so their product can differ slightly.
- unitsSoldinteger
Units sold in this sale; above 1 for a multi-unit listing.
- urlstring
Canonical listing URL. Populated whenever the provider has data for the entity.
- foundboolean
- 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.
常见问题
关于 eBay Accepted offers API
AnyAPI 的 eBay Accepted offers API 只需一次 POST 请求 /v1/run/ebay.accepted_offers,就以统一格式的 JSON 返回 eBay 数据。Retrieve completed eBay sales for any keyword with the price the buyer actually paid, including accepted Best Offer amounts where available, plus the sale date, units sold, shipping, and format. History is available back to December 2023. Auctions are never Best Offers, so look at fixed-price sales. Results come back newest first, so with a small limit the sales can cover only the last few days of a date window; raise limit (up to 240) to cover more of it.无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$3 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 eBay Accepted offers API 调用中有 100.0% 成功,响应时间中位数为 2.3 秒,共测量 7 次调用。