nvNeuralVerge
E-commerce & Marketplaces

eBay Item Search API and MCP — Keyword, Price & Condition Filters

Send a keyword and this source searches active eBay listings, with optional filters for sort order, condition, buying format, price range and category. The result is a list of listings — title, price, condition and the rest — matching the query.

You send
A keyword, plus optional sort, condition, buying format, price and category filters
You get back
Matching active listings with title, price, condition and seller
Coverage
Active eBay listings matching the search keyword.
Price
1 point per returned result, up to 500 per request — $1 per 1,000
Billed per record actually returned, capped by max_items. A search that matches nothing costs nothing.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Searching eBay by handSet filters in the browser, scroll, copy resultsFree, and hours for anything beyond a quick checkNobody keeps a watch list current this way
Building a scraperWrite and maintain a crawler against eBay's search results pagesEngineering time, ongoing repair when markup changesA maintenance commitment for something that isn't your product
NeuralVergeOne request, filters as parameters$1 per 1,000 returned resultsA loose keyword with no filters can return a lot of irrelevant listings before you tune it
Response

What you get back

Every field in the example response below.

FieldTypeDescription
idstringeBay's item ID for the listing.
urlstringDirect link to the listing.
titlestringListing title.
pricenumberCurrent listed price.
currencystringCurrency code the price is in.
list_pricenullThe struck-through "was" price, when eBay publishes one. Null in the example.
conditionstringCondition as eBay's search results show it, e.g. "Brand New".
imagestringPrimary listing image URL.
buying_formatstringeBay's format code, e.g. "FIXED_PRICE" or "AUCTION".
bid_countnullNumber of bids, for auction-format listings. Null in the example.
has_best_offerbooleanWhether the listing accepts best-offer negotiation.
shippingstringShipping cost or terms as shown in search results, e.g. "Free delivery".
sold_countnumberNumber of units sold, when eBay publishes a count.
watcher_countnumberNumber of buyers currently watching the listing, when eBay publishes a count. Null on a listing eBay shows no count for, as for the second item in the example.
sellerobjectThe seller who posted the listing: name, positive_percent and feedback_count.
Response

Example response

A real response, as returned.

{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "ebay_item_search",
  "keyword": "wireless mouse",
  "max_items": 2,
  "start_page": 1,
  "sort": null,
  "condition": null,
  "buying_format": null,
  "min_price": null,
  "max_price": null,
  "category_id": null,
  "partial": false,
  "human": "# eBay item search\n\n- **Search term:** wireless mouse\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 1.85 MB",
  "machine": {
    "total_items": 2,
    "items": [
      {
        "id": "336776720041",
        "url": "https://www.ebay.com/itm/336776720041",
        "title": "Apple Magic Mouse -A3204 Black - Wireless Bluetooth Mouse USB-C - Mint in Box",
        "price": 75.99,
        "currency": "USD",
        "list_price": null,
        "condition": "Pre-Owned",
        "image": "https://i.ebayimg.com/images/g/6rUAAeSw7BNqmbP2/s-l500.webp",
        "buying_format": "FIXED_PRICE",
        "bid_count": null,
        "has_best_offer": false,
        "shipping": "+$7.99 delivery",
        "sold_count": null,
        "watcher_count": 39,
        "seller": {
          "name": "cocosprinkles",
          "positive_percent": 99.8,
          "feedback_count": 41800
        }
      },
      {
        "id": "800545632527",
        "url": "https://www.ebay.com/itm/800545632527",
        "title": "Logitech G PRO X2 SUPERSTRIKE Wireless Gaming Mouse - Rapid Trigger Haptics",
        "price": 154.99,
        "currency": "USD",
        "list_price": null,
        "condition": "Certified - Refurbished",
        "image": "https://i.ebayimg.com/images/g/NGwAAeSwi0pqgwCT/s-l500.webp",
        "buying_format": "FIXED_PRICE",
        "bid_count": null,
        "has_best_offer": false,
        "shipping": "Free delivery",
        "sold_count": 163,
        "watcher_count": null,
        "seller": {
          "name": "logitech_outlet",
          "positive_percent": 100,
          "feedback_count": 2700
        }
      }
    ],
    "proxy_traffic_bytes": 1940859
  },
  "total_points": 2
}
Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

keyword is required; every other filter is optional. max_items caps results at 500 (default 25), and start_page pages through results beyond that cap.

curl -X POST https://api.neuralverge.ai/functions/v1/run-ebay-item-search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "wireless mouse", "max_items": 25, "sort": "price_low", "condition": "new", "max_price": 40 }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Competitor price monitoring

Search your own product keywords on a schedule and see what similar listings are priced at right now.

Sourcing for resale

Filter by condition and price to find listings worth buying and reselling elsewhere.

Auction timing

Sort by ending_soonest to catch listings closing in the next few hours.

Market sizing

Count and characterize how many active listings exist for a keyword or category before entering it.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Active eBay listings matching the search keyword.

Freshness

Searched at request time.

Handling

This source returns publicly visible listing information, stamped with the query it was read from and a session id you can trace.

What it will not do
  • —Only covers active listings — ended auctions and sold buy-it-now listings drop out of the results.
  • —best_match ranking reflects eBay's own relevance algorithm, which isn't published and can shift.
  • —A broad keyword with no category or condition filter can return listings that aren't actually comparable to each other.
FAQ

Questions, answered

Yes — pass category_id, using an ID pulled from eBay categories.

Related

Related sources

Try ebay item search on your own data

One request format across every source in the catalog.

Get started