Skip to content
Gridlode
Docs · Reference

eBay Search Results

GET /v1/ecommerce/ebay/search2 credits / requestcache 60 min

Listings from an eBay search on ebay.com, ebay.co.uk, ebay.de and ten other eBay sites, as a signed-out shopper sees them: item ID, title, URL, price (and price range), currency, condition, shipping cost or free shipping, buying format (auction, Buy It Now, Best Offer), bids and time left, sold count, seller with feedback score and positive percentage, item location, sponsored flag and image, plus the result count and pagination. Filter by condition, format, price and sold listings. Verification pages are detected and never charged.

Query parameters

q
string · required
What to search for, e.g. 'mechanical keyboard'.
marketplace
string
eBay site to search, e.g. ebay.com, ebay.co.uk, ebay.de.
Default: "ebay.com"
Allowed: ebay.com, ebay.co.uk, ebay.de, ebay.fr, ebay.it, ebay.es, ebay.at, ebay.ch, ebay.nl, ebay.ie, ebay.pl, ebay.ca, ebay.com.au
page
integer
Results page (1-100).
Default: 1
per_page
integer
Results per page: 60, 120 or 240.
Default: 60
Allowed: 60, 120, 240
sort
string
Sort order (price sorts include shipping).
Default: "best_match"
Allowed: best_match, ending_soonest, newly_listed, price_low, price_high, nearest
buying_format
string
Auctions, Buy It Now, or both.
Default: "all"
Allowed: all, auction, buy_it_now
condition
string
Item condition.
Default: "any"
Allowed: any, new, used
sold
boolean
Search completed listings that sold instead of live listings.
Default: false
min_price
string
Minimum price in the marketplace currency.
Default: null
max_price
string
Maximum price in the marketplace currency.
Default: null
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/ecommerce/ebay/search?q=mechanical%20keyboard" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the eBay Search Results API page.