eBay 搜索 API

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

免费开始下载示例或 JSON

US$0.75/千次请求，按请求付费，无需订阅。

nintendo switch | eBay

ebay.com/sch/i.html?_nkw=nintendo+switch

Hi! Sign inor registerDaily DealsBrand OutletGift CardsHelp & ContactShip toSellWatchlistMy eBay

ebay

All Categoriesnintendo switch

Advanced

3+ results for nintendo switch

Condition

NewOpen boxUsed

Buying format

All listingsAuctionBuy It Now

Price

Under $50$50 to $200Over $200

Item location

photo

Nintendo Switch Lite Handheld Console - Turquoise - Used

Used · 12 bids

$129.5

+$8.99 shipping

retro_games_hub (3204) 97.8%

photo

Nintendo Switch Console (Original 2017 Model) - Neon Red/Blue

Used

$179.99

Free shipping

consoleworld_usa (9871) 98.1%

photo

Nintendo Switch OLED Model Console - White

New

$249.99

Free shipping

game_deals_plus (41209) 99.5%

API 返回的内容items[0]

{
"itemId": "225876341102",
"title": "Nintendo Switch Lite Handheld Console - Turquoise - Used",
"url": "https://www.ebay.com/itm/225876341102",
"price": 129.5,
"condition": "Used",
"listingType": "Auction",
"sellerName": "retro_games_hub",
"sellerFeedbackPercent": 97.8,
还有 5 个字段
}

可用率

100.00%

30d · 15,585 次调用

请求数

15,585

30d · 按周，近 12 周

响应时间

3.7s

中位数 · 30d

价格与服务商

eBay 搜索 API 价格：一个 API，3 个可互换的服务商

最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。

服务商，按调用顺序

1Badger优先响应可用率 99.63%p50 3640ms占调用的 99.2%99.2%15,454 次调用99.63%3640msUS$0.75/千次请求flat 2Chameleon备用 1可用率 98.28%p50 4797ms占调用的 0.4%0.4%57 次调用98.28%4797msUS$1.75/千次请求flat 3Octopus备用 2可用率 100.00%p50 7575ms占调用的 0.5%0.5%71 次调用100.00%7575msUS$2.62/千条结果每次请求最多 US$0.0655

我需要次请求

你需支付

US$7.50

US$0.75/千次请求，只为实际用量付费。没有月度套餐。

有了 US$0.10 的初始余额，你的前 133 次请求免费。

试一试

一个请求获取 eBay 搜索

query*string搜索关键词，例如 "nintendo switch" 或 "vintage levis 501"。

conditionarray按一种或多种物品成色筛选；省略则包含所有成色（例如 ["new", "open_box"]）。

limitinteger 1-25最多返回的结果数量（1 到 25，默认 25）。listingTypeenum限定刊登形式；省略或使用 all 表示两者都包含（例如 buy_it_now 表示仅一口价）。maxPriceinteger 0-可选，物品最高价格，单位为 USD。minPriceinteger 0-可选，物品最低价格，单位为 USD。

requireFieldsarray

listingTypesellerFeedbackCountsellerFeedbackPercentsellerName

可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `sellerName`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。

sortenum结果排序方式；省略则使用 eBay 的最佳匹配（例如 price_low 表示按价格加运费从低到高排序）。

打开于提示词已复制

获取免费密钥

示例响应

免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。

{
  "found": true,
  "data": {
    "items": [
      {
        "itemId": "225876341102",
        "title": "Nintendo Switch Lite Handheld Console - Turquoise - Used",
        "url": "https://www.ebay.com/itm/225876341102",
        "price": 129.5,
        "condition": "Used",
        "listingType": "Auction",
        "sellerName": "retro_games_hub",
        "sellerFeedbackPercent": 97.8,
        "shippingCost": "$8.99",
        "image": "https://i.ebayimg.com/images/g/3xkAAOSwLmhk3z4A/s-l500.jpg",
        "currency": "USD",
        "bidCount": 12,
        "sellerFeedbackCount": 3204
      },
      {
        "itemId": "205512873341",
        "title": "Nintendo Switch Console (Original 2017 Model) - Neon Red/Blue",
        "url": "https://www.ebay.com/itm/205512873341",
        "price": 179.99,
        "condition": "Used",
        "listingType": "FixedPrice",
        "sellerName": "consoleworld_usa",
        "sellerFeedbackPercent": 98.1,
        "shippingCost": "$0.00",
        "image": "https://i.ebayimg.com/images/g/7wYAAOSwXqhk3z4B/s-l500.jpg",
        "currency": "USD",
        "sellerFeedbackCount": 9871
      },
      {
        "itemId": "204521873366",
        "title": "Nintendo Switch OLED Model Console - White",
        "url": "https://www.ebay.com/itm/204521873366",
        "price": 249.99,
        "condition": "New",
        "listingType": "FixedPrice",
        "sellerName": "game_deals_plus",
        "sellerFeedbackPercent": 99.5,
        "shippingCost": "Free",
        "image": "https://i.ebayimg.com/images/g/5vNAAOSwZthk3z4C/s-l500.jpg",
        "currency": "USD",
        "sellerFeedbackCount": 41209
      }
    ]
  }
}

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

参考

一个请求，一种响应结构。

你发送的每个字段和收到的每个字段，都附有真实示例。

最近验证于 2026-10-09 · 可用率和延迟按 30d 统计

请求体

JSON，POST 到这个接口。

querystring
nintendo switch
搜索关键词，例如 "nintendo switch" 或 "vintage levis 501"。
conditionarray
按一种或多种物品成色筛选；省略则包含所有成色（例如 ["new", "open_box"]）。
limitinteger
3
最多返回的结果数量（1 到 25，默认 25）。
listingTypeenum
限定刊登形式；省略或使用 all 表示两者都包含（例如 buy_it_now 表示仅一口价）。
maxPriceinteger
可选，物品最高价格，单位为 USD。
minPriceinteger
可选，物品最低价格，单位为 USD。
requireFieldsarray
可选；省略时路由不变，由最便宜的数据源处理。列出本次请求必须能返回的输出字段，例如 `sellerName`，请求就只会由能返回全部这些字段的数据源处理。未列出的字段，只要处理请求的数据源有，仍会照常返回。这可能提高你的价格：最便宜的数据源无法返回某个列出的字段时，会改由更贵的数据源处理，并按它的价格报价和扣费。如果某个商品确实没有某个列出的字段，该字段仍可能缺失。如果列出的字段组合没有任何单一数据源能同时返回，请求会作为无效输入被拒绝，不扣费。
sortenum
price_low
结果排序方式；省略则使用 eBay 的最佳匹配（例如 price_low 表示按价格加运费从低到高排序）。

你发送。 一个简短的 JSON 请求体。显示的值只是示例，请换成你自己的。

响应

JSON，每个字段一个示例值。

foundboolean
true

each itemdata.items[]

itemIdstring
225876341102
titlestring
Nintendo Switch Lite Handheld Console - Turquoise - Used
urlstring
https://www.ebay.com/itm/225876341102
pricenumber
129.5
conditionstring
Used
listingTypestring可设为必填
Auction
sellerNamestring可设为必填
retro_games_hub
sellerFeedbackPercentnumber可设为必填
97.8
shippingCoststring
$8.99
imagestring
https://i.ebayimg.com/images/g/3xkAAOSwLmhk3z4A/s-l500.jpg
currencystring
USD
bidCountnumber
12
sellerFeedbackCountnumber可设为必填
3204

你收到。 字段有名称、有类型，无论哪个数据源响应，结构都一样。

常见问题

关于 eBay 搜索 API

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

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

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

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

可以。新的 AnyAPI 账户自带 US$0.10 免费余额，无需绑卡，足够调用 133 次 eBay 搜索，每次 US$0.00075。

AnyAPI 会在同一个请求中依次尝试它的 3 个数据源，从最便宜的开始，所以一个数据源宕机不会让你的调用失败。

向 https://api.getanyapi.com/v1/run/ebay.search 发送 POST 请求，在 “Authorization: Bearer” 请求头中放入你的 AnyAPI 密钥，并以 JSON 请求体传入参数。同一个密钥和同一个钱包适用于所有 AnyAPI 接口。

不需要。你向一个预付费的 AnyAPI 余额充值美元，每个请求从中扣费。没有月度套餐，也没有最低消费，同一个余额可用于所有 AnyAPI 接口。

有。TypeScript 用 npm 安装 @getanyapi/sdk，Python 用 pip 安装 getanyapi。两者都用同一个密钥调用所有 AnyAPI 接口，任何 HTTP 客户端也都可以。

可以。智能体可以连接 https://api.getanyapi.com/mcp 上的 AnyAPI MCP 服务器，或者向 https://api.getanyapi.com/agent/signup 发送一次无需认证的 POST 来创建自己的免费试用密钥，再通过 HTTP 调用这个接口。

更多接口

eBay 的其他接口

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

一个密钥，一个钱包，
开始你的第一次 eBay 调用。

领取 ~150 次免费请求

eBay 搜索 API

eBay 搜索 API 价格：一个 API，3 个可互换的服务商

一个请求获取 eBay 搜索

一个请求，一种响应结构。

关于 eBay 搜索 API

eBay 搜索 API 怎么收费？

eBay 搜索 API 返回什么？

eBay 搜索 API 的可靠性如何？

eBay 搜索 API 可以免费试用吗？

eBay 搜索 API 的某个数据源失败时会怎样？

如何调用 eBay 搜索 API？

使用 eBay 搜索 API 需要订阅吗？

eBay 搜索 API 有 SDK 吗？

AI 智能体可以使用 eBay 搜索 API 吗？

eBay 的其他接口

一个密钥，一个钱包，开始你的第一次 eBay 调用。

一个密钥，一个钱包，
开始你的第一次 eBay 调用。