// ebay search api

Search eBay listings as JSON

Find eBay listings by keyword or category. Get prices, condition, shipping, seller information and links to product details, with filters for your marketplace.

Try it with your free key Read the docs →

$0.15 / 1K requestsPay as you go5 free calls, no card

// live playground

Try an eBay search

Your API Key

Verifying browser…

Try it live.

More options

Request

Keywords _nkwSearch keywords. Required unless category_id is supplied. Minimum characters: 1 Maximum characters: 500Category ID category_ideBay category ID. Minimum: 1 Maximum: 2147483647

Marketplace

Marketplace ebay_domaineBay marketplace hostname.Shipping postal code _stposDestination postal code used by eBay for shipping estimates. Minimum characters: 1 Maximum characters: 20Item country ID _saliceBay item-location country ID, e.g. 1 US, 2 Canada, 3 UK.Preferred item location LH_PrefLocItem location relative to the marketplace.

Listing filters

Minimum price _udloMinimum item price. Minimum: 0Maximum price _udhiMaximum item price. Minimum: 0Buying format buying_formatAuction, Buy It Now (BIN), or accepts offers (BO).Condition IDs LH_ItemConditionCondition IDs joined with |, such as 1000|3000. Pattern: ^[0-9]{1,4}(\|[0-9]{1,4}){0,9}$Spelling control _blrsExclude automatic spelling corrections.Show only show_onlyComma-separated filters: FR, RPA, AS, Savings, SaleItems, Lots, Charity, AV, FS, LPickup. Maximum characters: 100Seller usernames _saslComma-separated eBay seller usernames. Maximum characters: 1000Include or exclude sellers _saslopInclude (1) or exclude (2) the sellers in _sasl.Popular filters popular_filterseBay aspect filters as key=value pairs joined with &, with multiple values joined by |. Percent-encoded names are accepted. Maximum characters: 4000

Pagination and sorting

Page _pgnResult page, starting at 1. Minimum: 1 Maximum: 2147483647Results per page _ipgRequested results per page. eBay may adjust the page size.Sort order _sopSort: 12 best match, 1 ending soonest, 10 newly listed, 7 nearest, 15/16 total price ascending/descending, 2/3 item price ascending/descending, 18/19 condition new/used first. Availability depends on marketplace.Result layout _dmdResult layout.

# pip install httpx
import httpx

response = httpx.get(
    "https://ecll-litescrape-v3--site-api-web.modal.run/api/ebay/search",
    params={
        "_nkw": "coffee maker",
        "ebay_domain": "ebay.com",
        "_pgn": "1",
        "_ipg": "25",
    },
    headers={"Authorization": "Bearer ls_live_your_key"},
    timeout=120,
)
response.raise_for_status()
print(response.json())

Ready

Run the request to draw its results here. This endpoint returns:

organic_results
search_information
categories
popular_filters
related_searches
litescrape_pagination

// what you get

What the eBay Search API returns

Listing data in one response

Read titles, item IDs, prices, condition, shipping and seller information when eBay includes them. Each listing links to the Product API.

Marketplace and listing filters

Choose from 17 eBay marketplaces. Filter by category, price, buying format, condition, seller, location or the aspect filters returned with a search.

Page through matching listings

Choose a sort order and page size. Follow litescrape_pagination.next to keep the same query and filters on the next request.

Sections supplied by eBay

Deal panels, inline results, related items and review highlights appear when available. Optional sections vary by query and marketplace.

// use cases

What teams build with it

01
Monitor listing prices
Collect asking prices for matching products across searches and marketplaces.
02
Find inventory to inspect
Filter listings, then pass their product_id values to the Product API for item details.
03
Explore marketplace demand
Use returned categories, filters and related searches to refine product research.

// same key

More eBay APIs

Start pulling eBay Search data in five minutes.

Your first 5 calls are free. Top up the same key from $10 whenever you need more.

Get your API key Read the docs →

Litescrape sells to AI agents - live prices and self-serve payment