Ebay Search
ebay_searchRead-onlyIdempotent
Search active eBay listings (US marketplace). Returns title, price, condition, seller, thumbnail, and item_id per hit. Use ebay_get_item with the returned item_id for full detail.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"q": "iPhone 15 Pro 256GB",
"sort": "price",
"limit": 25
},
"name": "ebay_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Keyword query (e.g. "iPhone 15 Pro 256GB") | |
| sort | No | price (asc) | -price (desc) | newlyListed | endingSoonest | |
| limit | No | 1-200 (default 25) | |
| filter | No | Advanced Browse API filter, e.g. "price:[20..100],conditions:{NEW},buyingOptions:{FIXED_PRICE}". See Browse docs. | |
| offset | No | Pagination offset (default 0) | |
| category_id | No | eBay category ID to scope to (see ebay_get_categories) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | Yes | Array of search result items | |
| limit | Yes | Number of results returned (1-200) | |
| total | Yes | Total number of matching listings | |
| offset | Yes | Pagination offset used |