Scrape eBay search listings
ebay_searchSearches any regional eBay marketplace for keyword and returns the listings as JSON: title, price + currency, condition (with a normalised conditionCode), seller (username, feedback percentage and score), shippingCost, sold, watchers, bids, image and a clean item url. Filter with condition, listing_type, min_price/max_price, free_shipping, seller or category, sort with sort, and page with page/page_size (60, 120 or 240 per page). Set marketplace to search a specific site - prices, currency and availability differ between ebay.com, ebay.de, ebay.co.uk and the rest. When eBay finds no exact match it still serves a full page of its own loosely-related suggestions. That case is reported honestly: exactMatches is false and a notice explains it, so those listings are never mistaken for real matches. Returns JSON. Billed like an API request; listing plugins bill one unit per result page they fetch, so keep max_results modest.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | 1-based page number. Default: 1. | |
| sort | No | Ordering: best_match, newly_listed, ending_soon, price_asc, price_desc. Default 'best_match'. Default: best_match. | |
| seller | No | Restrict the search to one seller's username. | |
| keyword | Yes | Search phrase, e.g. 'iphone 13' or a part number like '1K0953519A'. | |
| category | No | eBay category id to search inside, e.g. '131090' for vehicle parts and accessories. | |
| condition | No | Item condition filter: new, open_box, refurbished, used, for_parts. Omit for every condition. | |
| max_price | No | Highest price to include, in the marketplace's currency. | |
| min_price | No | Lowest price to include, in the marketplace's currency. | |
| page_size | No | Listings per page - eBay's own page sizes: 60, 120, 240. Default: 60. | |
| marketplace | No | Regional eBay site to search. Prices, currency and availability differ per marketplace. One of: ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.nl, ebay.pl, ebay.at, ebay.ch, ebay.be, ebay.ie, ebay.ca, ebay.com.au, ebay.in, ebay.ph, ebay.com.sg, ebay.com.my, ebay.com.hk. Default: ebay.com. | |
| listing_type | No | Listing format: all, buy_it_now, auction. Default 'all'. Default: all. | |
| free_shipping | No | Only listings eBay marks as free delivery. Default: false. | |
| proxy_country | No | Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to a country chosen for the marketplace. |