eBay Item Search API — 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.
{
"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.64 MB",
"machine": {
"total_items": 2,
"items": [
{
"id": "188182070260",
"url": "https://www.ebay.com/itm/188182070260",
"title": "2 Wireless Optical Mouse Mice 2.4GHz USB Receiver For Laptop PC Computer DPI USA",
"price": 5.88,
"currency": "USD",
"list_price": null,
"condition": "Brand New",
"image": "https://i.ebayimg.com/images/g/9eYAAeSwFsBpu6TH/s-l500.webp",
"buying_format": "FIXED_PRICE",
"bid_count": null,
"has_best_offer": false,
"shipping": "Free delivery",
"sold_count": 327,
"watcher_count": null,
"seller": {
"name": "catboutique",
"positive_percent": 99.2,
"feedback_count": 89300
}
},
{
"id": "387260583301",
"url": "https://www.ebay.com/itm/387260583301",
"title": "Wireless Optical Mouse Mice 2.4GHz USB Receiver For Laptop PC Computer DPI lot",
"price": 4.99,
"currency": "USD",
"list_price": null,
"condition": "Brand New",
"image": "https://i.ebayimg.com/images/g/7REAAOSwBqVmrdKS/s-l500.webp",
"buying_format": "FIXED_PRICE",
"bid_count": null,
"has_best_offer": false,
"shipping": "Free delivery",
"sold_count": 168,
"watcher_count": null,
"seller": {
"name": "thenicefella-02",
"positive_percent": 99.2,
"feedback_count": 44200
}
}
],
"proxy_traffic_bytes": 1722086
},
"total_points": 2
}- 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.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Searching eBay by hand | Set filters in the browser, scroll, copy results | Free, and hours for anything beyond a quick check | Nobody keeps a watch list current this way |
| Building a scraper | Write and maintain a crawler against eBay's search results pages | Engineering time, ongoing repair when markup changes | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, filters as parameters | $1 per 1,000 returned results | A loose keyword with no filters can return a lot of irrelevant listings before you tune it |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
id | string | eBay's item ID for the listing. |
url | string | Direct link to the listing. |
title | string | Listing title. |
price | number | Current listed price. |
currency | string | Currency code the price is in. |
list_price | number | The struck-through "was" price, when eBay publishes one. |
condition | string | Condition as eBay's search results show it, e.g. "Brand New". |
image | string | Primary listing image URL. |
buying_format | string | eBay's format code, e.g. "FIXED_PRICE" or "AUCTION". |
bid_count | number | Number of bids, for auction-format listings. |
has_best_offer | boolean | Whether the listing accepts best-offer negotiation. |
shipping | string | Shipping cost or terms as shown in search results, e.g. "Free delivery". |
sold_count | number | Number of units sold, when eBay publishes a count. |
watcher_count | number | Number of buyers currently watching the listing, when eBay publishes a count. |
seller | object | The seller who posted the listing: name, positive_percent and feedback_count. |
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 }'What teams use it for
Where this field shows up in an actual workflow.
Search your own product keywords on a schedule and see what similar listings are priced at right now.
Filter by condition and price to find listings worth buying and reselling elsewhere.
Sort by ending_soonest to catch listings closing in the next few hours.
Count and characterize how many active listings exist for a keyword or category before entering it.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Active eBay listings matching the search keyword.
Searched at request time.
This source returns publicly visible listing information, stamped with the query it was read from and a session id you can trace.
- —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.
Questions, answered
Yes — pass category_id, using an ID pulled from eBay categories.
Related sources
Try ebay item search on your own data
One request format across every source in the catalog.