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"}'
字段类型示例值
请求体
querystring"iphone 13 pro"已售物品的搜索关键词(例如 iphone 13 pro)。
categoryIdstring可选,在其中搜索的 eBay 数字类目 ID(例如 9355 表示 Cell Phones & Smartphones,9394 表示 Cell Phone Accessories)。
conditionenum物品成色筛选(例如 used)。
endDatestring只返回在此日期或之前售出的商品(含当天),格式为 YYYY-MM-DD(例如 2026-09-15)。此限制在每页获取后才应用,因此即使 hasMore 仍为 true,某一页的商品也可能少于 limit 条,甚至为空:请持续请求下一页,直到 hasMore 为 false。
freeShippingboolean当前数据源不支持:只接受 false(不筛选);true 会被拒绝,不扣费。
limitinteger10最多返回的结果数量(1-25,默认 25)。
listingTypeenum限定刊登形式;省略或使用 all 表示两者都包含(例如 auction 表示仅拍卖成交)。
maxPricenumber可选,最高成交价,以站点币种计(例如 500)。
minPricenumber可选,最低成交价,以站点币种计(例如 200)。
pageinteger结果页码,从 1 开始。配合输出中的 hasMore 分页;翻页时请保持 query、筛选条件和 limit 不变,因为 limit 决定每页大小。
returnsAcceptedboolean当前数据源不支持:只接受 false(不筛选);true 会被拒绝,不扣费。
sellerstring当前数据源不支持:设置了此参数的请求会被拒绝,不扣费。
siteenum要搜索的 eBay 国家站点。已售商品目前只覆盖美国。
sortenum"ended_recently"结果排序方式;省略时为 ended_recently(例如 price_high 表示按成交价加运费从高到低排序)。
startDatestring只返回在此日期或之后售出的商品(含当天),格式为 YYYY-MM-DD(例如 2026-09-01)。
响应
dataobject
data.hasMorebooleanTrue 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.itemsobject[]Sold listing records: title, sold price, sale date, condition, seller, and item URL. Populated whenever the provider has data for the entity.
data.items[].bestOfferAcceptedbooleanTrue when eBay marked the sale as Best Offer accepted. Absent when the source could not tell.
data.items[].bidCountintegerNumber of bids the listing received, for auction sales.
data.items[].conditionstringItem condition as listed (e.g. Pre-Owned).
data.items[].countryCodestringISO country code of the eBay marketplace the sale happened on.
data.items[].epidstringeBay catalog product identifier (ePID), when the listing is matched to a catalog product.
data.items[].imagestringPrimary listing image URL. Populated whenever the provider has data for the entity.
data.items[].imagesstring[]All listing image URLs, primary first.
data.items[].itemIdstringeBay item identifier. Populated whenever the provider has data for the entity.
data.items[].listingTypestringSale format: Auction or Fixed price.
data.items[].sellerFeedbackCountintegerSeller's lifetime feedback count. Populated whenever the provider has data for the entity.
data.items[].sellerFeedbackPercentnumberSeller's positive-feedback percentage. Populated whenever the provider has data for the entity.
data.items[].sellerUsernamestringSeller's eBay username. Populated whenever the provider has data for the entity.
data.items[].shippingCoststringShipping the buyer paid, in the site currency (e.g. "$5.55"; "$0" is free shipping).
data.items[].soldCurrencystringISO currency code of the sold price (e.g. USD).
data.items[].soldPricenumberFinal 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[].soldUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].titlestringListing title as it appeared on eBay. Populated whenever the provider has data for the entity.
data.items[].urlstringCanonical 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.
价格
每次请求价格USDUS$0.0135
价格(/千次请求)USDUS$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 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。