Search active listings
Search live eBay listings for a keyword, with the same filters the site offers: condition, price range, auction vs Buy It Now, free delivery, seller and category. Returns each listing with its price, delivery cost, condition, image, and — for auctions — bid count and time remaining. Covers 13 eBay marketplaces. Scraped anonymously from the public search page; no eBay account needed.
Costs 3 credits per request.
Authorization
ApiKeyAuth API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.
In: header
Query Parameters
Search keywords, exactly as typed into eBay.
1 <= length <= 300eBay site to search. One of: uk, us, de, fr, it, es, nl, ie, at, pl, ch, au, ca.
"uk"Value in
- "uk"
- "us"
- "de"
- "fr"
- "it"
- "es"
- "nl"
- "ie"
- "at"
- "pl"
- "ch"
- "au"
- "ca"
Result page (1–100).
1 <= value <= 1001Listings to return (1–240). eBay pages in 60/120/240, so a smaller value simply truncates.
1 <= value <= 24060Filter by item condition.
Value in
- "new"
- "opened_never_used"
- "refurbished"
- "used"
- "for_parts"
Minimum price, in the marketplace currency.
0 <= valueMaximum price, in the marketplace currency.
0 <= valueRestrict to one seller username.
1 <= length <= 64Restrict to an eBay category id.
^\d+$Result ordering. Defaults to eBay Best Match.
Value in
- "best_match"
- "ending_soonest"
- "newly_listed"
- "price_low"
- "price_high"
Restrict to auctions or to fixed-price listings.
Value in
- "auction"
- "buy_it_now"
Only listings with free delivery.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/ebay/search_listings?query=pokemon+charizard"{ "query": "pokemon charizard", "marketplace": "uk", "currency": "GBP", "page": 1, "count": 60, "total_results": 180000, "has_more": true, "listings": [ { "listing_id": "198608105579", "title": "Pokémon TCG Charizard 11/108 Evolutions Holo Rare", "url": "https://www.ebay.co.uk/itm/198608105579", "epid": "19052761943", "price": 37.1, "currency": "GBP", "condition": "Pre-owned", "bids": 12, "time_left": "6d 23h", "shipping_price": 2.7, "free_shipping": false, "best_offer": true, "image": "https://i.ebayimg.com/images/g/QdcAAeSwzbZqlFRv/s-l500.webp", "location": "Japan" } ]}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}{ "error": { "code": "invalid_api_key", "message": "The provided API key is invalid or has been revoked." }}