eBay API

eBay 搜索 API

按关键词搜索 eBay 在售商品，可选价格区间、物品成色、刊登类型和排序筛选，在一个标准化响应中返回标题、价格、成色、运费和卖家。

POST/v1/run/ebay.search
可用率
100.00%
30d · 95 次调用
请求数
95
30d · 按周，近 12 周
响应时间
7.7s
中位数 · 30d

服务商网络

按流量排序的服务商

服务商
Octopus已服务 68可用率 100.00%7567ms p5071.6%US$2.62/千条结果每次请求最多 US$0.0655Badger优先调用已服务 23可用率 65.71%5564ms p5024.2%US$0.50/千次请求固定价Chameleon已服务 4可用率 100.00%4657ms p504.2%US$1.75/千次请求固定价

试一试

发出你的第一个请求

conditionarray
按一种或多种物品成色筛选；省略则包含所有成色（例如 ["new", "open_box"]）。
requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `sellerName`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
打开于
获取免费密钥
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
  "data": {
    "items": [
      {
        "bidCount": 12500,
        "condition": "example",
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "itemId": "a1b2c3d4",
        "listingType": "general",
        "price": 19.99,
        "sellerFeedbackCount": 12500,
        "sellerFeedbackPercent": 12.5,
        "sellerName": "Example title",
        "shippingCost": "19.99",
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ]
  },
  "found": true,
  "reason": "not_found"
}
响应类型定义
interface EbaySearchResponse {
  data: {
    items: {
      bidCount?: number;
      condition?: string;
      currency?: string;
      image?: string;
      itemId: string;
      listingType?: string | null;
      price?: number;
      sellerFeedbackCount?: number | null;
      sellerFeedbackPercent?: number | null;
      sellerName?: string | null;
      shippingCost?: string;
      title: string;
      url: string;
    }[];
  } | null;
  found: boolean;
  reason?: "not_found";
}

完整的参数与响应参考：这个接口的每个字段、类型和示例。

参考

请求、响应与价格

最近验证于 2026-09-29 · 可用率和延迟按 30d 统计
POST /v1/run/ebay.search
curl -X POST https://api.getanyapi.com/v1/run/ebay.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":3,"query":"nintendo switch","sort":"price_low"}'
字段类型示例值
请求体
querystring"nintendo switch"搜索关键词，例如 "nintendo switch" 或 "vintage levis 501"。
conditionarray按一种或多种物品成色筛选；省略则包含所有成色（例如 ["new", "open_box"]）。
limitinteger3最多返回的结果数量（1 到 25，默认 25）。
listingTypeenum限定刊登形式；省略或使用 all 表示两者都包含（例如 buy_it_now 表示仅一口价）。
maxPriceinteger可选，物品最高价格，单位为 USD。
minPriceinteger可选，物品最低价格，单位为 USD。
requireFieldsarray可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `sellerName`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
sortenum"price_low"结果排序方式；省略则使用 eBay 的最佳匹配（例如 price_low 表示按价格加运费从低到高排序）。
响应
dataobject
data.itemsobject[]Listing records: title, price, condition, shipping cost, seller info, image, and item URL. Populated whenever the provider has data for the entity.
data.items[].bidCountintegerBids placed so far, for auction listings.
data.items[].conditionstring
data.items[].currencystringISO currency code of the price (e.g. USD).
data.items[].imagestringPrimary listing image URL. Populated whenever the provider has data for the entity.
data.items[].itemIdstringeBay item identifier. Populated whenever the provider has data for the entity.
data.items[].listingType可设为必填stringAuction, FixedPrice, etc. Null when the serving source does not publish the listing format.
data.items[].pricenumberListing price.
data.items[].sellerFeedbackCount可设为必填numberSeller's lifetime feedback count, or null when the serving source does not publish it.
data.items[].sellerFeedbackPercent可设为必填numberSeller positive-feedback percentage, or null when the serving source does not publish it.
data.items[].sellerName可设为必填stringSeller username, or null when the serving source does not publish the seller.
data.items[].shippingCoststringShipping cost or free-delivery label.
data.items[].titlestringPopulated whenever the provider has data for the entity.
data.items[].urlstringPopulated 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.0005
价格（/千次请求）USDUS$0.50

常见问题

关于 eBay 搜索 API

AnyAPI 的 eBay 搜索 API 只需一次 POST 请求 /v1/run/ebay.search，就以统一格式的 JSON 返回 eBay 数据。按关键词搜索 eBay 在售商品，可选价格区间、物品成色、刊登类型和排序筛选，在一个标准化响应中返回标题、价格、成色、运费和卖家。AnyAPI 会在 3 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.50 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 eBay 搜索 API 调用中有 100.0% 成功，响应时间中位数为 7.7 秒，共测量 95 次调用。

费用：每千次请求 US$0.50 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。

按关键词搜索 eBay 在售商品，可选价格区间、物品成色、刊登类型和排序筛选，在一个标准化响应中返回标题、价格、成色、运费和卖家。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。

过去 30 天，通过 AnyAPI 发起的 eBay 搜索 API 调用中有 100.0% 成功，响应时间中位数为 7.7 秒，共测量 95 次调用。这些是 AnyAPI 对经过网关的流量的自有测量，持续重新计算，并非公开承诺的服务等级目标。
更多接口

eBay 的其他接口

商品详情/千次请求 US$0.50 起商品详情（完整版）/千次请求 US$1.80 起已售商品/千次请求 US$13.50 起已售商品（精简版）/千次请求 US$13.50 起