eBay API

eBay Search API

Search eBay active listings by keyword with optional price-range, item-condition, listing-type, and sort filters and get title, price, condition, shipping, and seller in one normalized response.

Start freeDownload sampleor JSON

$1.20/1k req, pay per request, no subscription.

What the API returneditems[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 more fields
}
Uptime
99.97%
30d · 40,012 calls
Requests
40,033
30d · weekly, last 12 wks
Response
4.0s
median · 30d

Pricing and providers

eBay Search API pricing: one API, 3 interchangeable providers

The cheapest provider serves first. If it fails, the next one takes over in the same call.

You pay
$12.00
$1.20/1k req, only for what you use. No monthly plan.
Your first 83 requests are free with the $0.10 starting balance.

Try it

Get eBay search in one request

conditionarray
Filter by one or more item conditions; omit for all conditions (e.g. ["new", "open_box"]).
requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `sellerName`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a listing that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.

This sample shows 16 of 17 fields. See every field

{
  "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
      }
    ]
  }
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

One request, one response shape.

Every field you send and every field you get back, each with a real example.

Last verified 2026-10-31 · uptime and latency measured over 30d

Request body

JSON, posted to this endpoint.

  • querystring

    nintendo switch

    Search keywords, e.g. "nintendo switch" or "vintage levis 501".

  • conditionarray

    Filter by one or more item conditions; omit for all conditions (e.g. ["new", "open_box"]).

  • limitinteger

    3

    Maximum number of results to return (1 to 25, default 25).

  • listingTypeenum

    Restrict to a listing format; omit or use all for both (e.g. buy_it_now for fixed-price only).

  • maxPriceinteger

    Optional maximum item price in USD.

  • minPriceinteger

    Optional minimum item price in USD.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `sellerName`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a listing that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • sortenum

    price_low

    Result sort order; omit for eBay's Best Match (e.g. price_low sorts by lowest price plus shipping first).

You send. A small JSON body. The values shown are examples to replace with your own.

Response

JSON, one example value per field.

each itemdata.items[]

Listing records: title, price, condition, shipping cost, seller info, image, and item URL. Populated whenever the provider has data for the entity.

  • bidCountinteger

    12

    Bids placed so far, for auction listings.

  • conditionstring

    Used

  • currencystring

    USD

    ISO currency code of the price (e.g. USD).

  • imagestring

    https://i.ebayimg.com/images/g/3xkAAOSwLmhk3z4A/s-l500.jpg

    Primary listing image URL. Populated whenever the provider has data for the entity.

  • itemIdstring

    225876341102

    eBay item identifier. Populated whenever the provider has data for the entity.

  • listingTypestringcan require

    Auction

    Auction, FixedPrice, etc. Null when the serving source does not publish the listing format.

  • pricenumber

    129.5

    Listing price.

  • sellerFeedbackCountnumbercan require

    3204

    Seller's lifetime feedback count, or null when the serving source does not publish it.

  • sellerFeedbackPercentnumbercan require

    97.8

    Seller positive-feedback percentage, or null when the serving source does not publish it.

  • sellerNamestringcan require

    retro_games_hub

    Seller username, or null when the serving source does not publish the seller.

  • shippingCoststring

    $8.99

    Shipping cost or free-delivery label.

  • titlestring

    Nintendo Switch Lite Handheld Console - Turquoise - Used

    Populated whenever the provider has data for the entity.

  • urlstring

    https://www.ebay.com/itm/225876341102

    Populated whenever the provider has data for the entity.

top level
  • foundboolean

    true

  • 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.

You get back. Named, typed fields in the same shape whichever source answers.

FAQ

About the eBay Search API

The AnyAPI eBay Search API returns eBay search data as normalized JSON from one POST call to /v1/run/ebay.search. Search eBay active listings by keyword with optional price-range, item-condition, listing-type, and sort filters and get title, price, condition, shipping, and seller in one normalized response. AnyAPI routes each request across 3 sources and falls back automatically when one fails. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of eBay search calls through AnyAPI succeeded, with a median response time of 4.0 seconds across 40,012 measured calls.

It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet and each call draws it down. Some failed wallet-funded requests incur processing charges that we pass through at cost, with no markup; the error response shows the amount charged.

Search eBay active listings by keyword with optional price-range, item-condition, listing-type, and sort filters and get title, price, condition, shipping, and seller in one normalized response. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 100.0% of eBay search calls through AnyAPI succeeded, with a median response time of 4.0 seconds across 40,012 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Yes. A new AnyAPI account starts with $0.10 of free balance and no card required, which covers 83 eBay Search calls at $0.0012 each.

AnyAPI asks the next of its 3 sources in the same request, cheapest first, so one source going down does not fail your call.

Send a POST request to https://api.getanyapi.com/v1/run/ebay.search with your AnyAPI key in an "Authorization: Bearer" header and the input as a JSON body. The same key and the same wallet work on every AnyAPI endpoint.

No. You add US dollars to one prepaid AnyAPI balance and each request draws it down. There is no monthly plan and no minimum, and the same balance pays for every AnyAPI endpoint.

Yes. Install @getanyapi/sdk from npm for TypeScript or getanyapi from pip for Python. Both call every AnyAPI endpoint with the same key, and any HTTP client works too.

Yes. An agent can connect to the AnyAPI MCP server at https://api.getanyapi.com/mcp, or create its own free-trial key with one unauthenticated POST to https://api.getanyapi.com/agent/signup and call this endpoint over HTTP.
More to call

Other eBay endpoints

Productfrom $1.20 /1k reqProduct fullfrom $1.80 /1k reqSold listingsfrom $3.00 /1k reqSold listings thinfrom $3.00 /1k req