Skip to content
Gridlode
Launching soonE-commerce2 credits / request

eBay Search Results API

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.

GEThttps://api.gridlode.com/v1/ecommerce/ebay/search
Get an API keyReference docs
This engine is built and is waiting for a terms review of the target site before we switch it on. Join early access through the contact form and we'll email you on launch day.

Parameters

NameTypeDescription
qrequiredstringWhat to search for, e.g. 'mechanical keyboard'.
marketplacestringeBay site to search, e.g. ebay.com, ebay.co.uk, ebay.de.
Default: "ebay.com"
One of: 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
pageintegerResults page (1-100).
Default: 1
per_pageintegerResults per page: 60, 120 or 240.
Default: 60
One of: 60, 120, 240
sortstringSort order (price sorts include shipping).
Default: "best_match"
One of: best_match, ending_soonest, newly_listed, price_low, price_high, nearest
buying_formatstringAuctions, Buy It Now, or both.
Default: "all"
One of: all, auction, buy_it_now
conditionstringItem condition.
Default: "any"
One of: any, new, used
soldbooleanSearch completed listings that sold instead of live listings.
Default: false
min_pricestringMinimum price in the marketplace currency.
Default: null
max_pricestringMaximum price in the marketplace currency.
Default: null
max_ageintegerAccept a cached answer up to this many seconds old, billed at 50%. Default 0 (always fresh).

Response fields

    Code

    curl "https://api.gridlode.com/v1/ecommerce/ebay/search?q=mechanical%20keyboard" \
  -H "Authorization: Bearer $GRIDLODE_KEY"
    2 credits per request
    One credit is $0.001 on the smallest pack, from $0.0003 on enterprise plans.
    Half price for cached data
    Cached for up to 1 h. Pass max_age to use it.
    Failed requests are free
    Blocks, timeouts and target errors never cost credits.

    Questions

    Part of these solutions
    How much does the eBay Search Results API cost?

    2 credits per request. One credit costs $0.001 on the smallest pack and as little as $0.0003 on enterprise plans. Cached answers cost half and failed calls are free.

    E-commerce

    Related APIs in this category

    All 7 in E-commerce · 1 live
    Live

    Shopify Store Products

    Every public product of a Shopify store from its storefront product feed (products.json), optionally for one collection

    0.02 credits / productTry freeDocs
    Soon

    Walmart Search Results

    Products from a walmart.com search as a signed-out shopper sees them, read from the page's structured data

    2 credits / requestDocs
    Soon

    Amazon Product

    One Amazon product page by ASIN on amazon.com or 19 other marketplaces, as a signed-out shopper sees it

    3 credits / requestDocs
    Soon

    Amazon Search Results

    Products from an Amazon search on amazon.com or 19 other marketplaces, as a signed-out shopper sees them

    3 credits / requestDocs
    Soon

    eBay Item Details

    One eBay listing by item number, as a signed-out shopper sees it

    2 credits / requestDocs
    Soon

    Walmart Product

    One walmart.com product page by item ID, as a signed-out shopper sees it

    2 credits / requestDocs