Search eBay (SerpAPI)
ebay_searchSearch eBay listings live via SerpAPI (engine ebay). Returns organic_results (each with title, link, condition, price, shipping, seller and — crucially — a product_id), plus categories, related_searches and pagination. Provide _nkw (a free-text query, what you'd type in eBay's search box) and/or a category_id to browse a category. Filter by price (_udlo/_udhi), condition (LH_ItemCondition), buying format (buying_format), seller (_sasl) and more; sort with _sop and paginate with _pgn. Pass a result's product_id to the ebay_product tool for full item details. Prices are in the marketplace currency (set via ebay_domain, default ebay.com).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _dmd | No | Result layout: 'Grid' or 'List'. Cosmetic; does not change the items returned. | |
| _ipg | No | Results per page. Allowed values: 25, 50 (default), 100, 200. | |
| _nkw | No | Search query — anything you'd type in eBay's search box. Required unless category_id is set. | |
| _pgn | No | Page number (1-based). Default 1. | |
| _sop | No | Sort order code: '12' = Best Match (default), '1' = ending soonest, '10' = newly listed, '15' = price+shipping lowest first, '16' = price+shipping highest first. | |
| _blrs | No | Set to 'spell_auto_correct' to exclude results from an auto-corrected spelling of the query. | |
| _sasl | No | Seller username(s) to filter by, comma-separated. | |
| _udhi | No | Maximum price (in the marketplace currency). | |
| _udlo | No | Minimum price (in the marketplace currency). | |
| _salic | No | Filter items by location, as a country code (e.g. '1' for US — see eBay location ids). | |
| _stpos | No | Buyer ZIP/postal code, used for location- and shipping-based filtering. | |
| _saslop | No | How to apply _sasl: 1 = only these sellers (default), 2 = exclude these sellers. | |
| no_cache | No | Force a fresh SerpAPI fetch and bypass this server's result cache. Default false. | |
| show_only | No | Extra filters, comma-separated: Sold, Complete (sold & completed listings), FS (free shipping), FR (free returns), RPA (returns accepted), Lots, Charity, Savings, SaleItems, AS, AV, LPickup. | |
| LH_PrefLoc | No | Preferred item location: 'Domestic', 'Regional' or 'Worldwide' (mapped internally to SerpAPI's numeric LH_PrefLoc codes — the words themselves are rejected by the upstream API). | |
| zero_trace | No | Enterprise-only ZeroTrace mode: don't store search params/metadata on SerpAPI. Default false. | |
| category_id | No | eBay category id to concentrate the search in. Can be used with or instead of _nkw. | |
| ebay_domain | No | eBay marketplace domain, e.g. 'ebay.com' (default), 'ebay.de', 'ebay.co.uk', 'ebay.com.au'. | |
| buying_format | No | Buying format filter: 'Auction', 'BIN' (Buy It Now) or 'BO' (Best Offer). | |
| LH_ItemCondition | No | Item condition id(s), pipe-separated for multiple ('1000|3000'): 1000 New, 1500 Open box, 2500 Seller refurbished, 3000 Used, 7000 For parts/not working, 10 Not specified. |