search
Search eBay listings by keyword, category, price, condition, and sort order. Filter results by marketplace and host to find matching items.
Instructions
Search eBay items via the Browse API.
Args:
query: keyword search string. Required.
category_id: numeric eBay category ID to restrict the search.
condition: one of NEW, LIKE_NEW, NEW_OTHER, USED_EXCELLENT,
USED_VERY_GOOD, USED_GOOD, USED_ACCEPTABLE, FOR_PARTS_OR_NOT_WORKING,
MANUFACTURER_REFURBISHED, CERTIFIED_REFURBISHED, or several other
refurbished tiers. Case-sensitive.
min_price: minimum item price (in currency).
max_price: maximum item price (in currency).
currency: ISO currency code for the price filter (default "USD").
sort: one of "best_match" (default), "price_asc", "price_desc",
"newly_listed", "ending_soonest".
limit: number of hits per page. Default 20, hard cap 200.
offset: pagination offset.
marketplace: eBay marketplace ID (default "EBAY_US"). Other examples:
"EBAY_GB", "EBAY_DE", "EBAY_IT".
host: which configured host to use ("sandbox" or "production"). If
omitted, uses the config's default_host.
Returns: dict with: - host: which host was actually targeted - total: total matching items per eBay - limit, offset, next_offset (None when there's no next page) - hits: list of item summaries (item_id, title, price, currency, condition, seller, image_url, ends_at, buying_options, web_url, bid_count if applicable)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| category_id | No | ||
| condition | No | ||
| min_price | No | ||
| max_price | No | ||
| currency | No | USD | |
| sort | No | best_match | |
| limit | No | ||
| offset | No | ||
| marketplace | No | EBAY_US | |
| host | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||