eBay Listings Search API
Search active listings by keyword, with filters for category, price range, condition, seller and auction or Buy It Now. Each result has the title, price, condition, shipping, seller and link.
- 1 credit per call
- Failed calls are free
- Updated
- ebay.products.search
{ "has_more": true, "next_page": 2, "listings": [ { "title": "Dell Latitude 3500 Laptop 15.6” HD Core i5 16GB RAM 256GB SSD Windows 11 WiFi", "price": "$242.22", "location": "United States", "condition": "Good - Refurbished", "item_id": "267147782259", "leaf_category": "177", "promoted": true, "rank": 0, "seller_feedback": "99.6% positive (175.7K)", "seller_name": "discountcomputerdepot", "shipping": "Free delivery in 2-4 days", "sold": false, "url": "https://www.ebay.com/itm/267147782259" }, { "title": "Dell Latitude 14\" Laptop Intel Core i3 16GB RAM 128GB SSD Windows 11 Pro WiFi", "price": "$204.05", "location": "United States", "condition": "Good - Refurbished", "item_id": "264987527030", "leaf_category": "177", "promoted": true, "rank": 1, "seller_feedback": "99.6% positive (175.7K)", "seller_name": "discountcomputerdepot", "shipping": "Free delivery in 2-4 days", "sold": false, "url": "https://www.ebay.com/itm/264987527030" } ]}
| # | Title | Price | Condition | Shipping | Seller | Seller feedback | Promoted | Item ID | Location | Leaf category |
|---|---|---|---|---|---|---|---|---|---|---|
| 1 | Dell Latitude 3500 Laptop 15.6” HD Core i5 16GB RAM 256GB SSD W… | $242.22 | Good - Refurbished | Free delivery in 2-4 days | discountcomputerdepot | 99.6% positive (175.7K) | true | 267147782259 | United States | 177 |
| 2 | Dell Latitude 14" Laptop Intel Core i3 16GB RAM 128GB SSD Windo… | $204.05 | Good - Refurbished | Free delivery in 2-4 days | discountcomputerdepot | 99.6% positive (175.7K) | true | 264987527030 | United States | 177 |
| 3 | HP EliteBook 830 G8 13.3" FHD Laptop i7 11th Gen 16GB RAM 256GB… | $329.99 | Good - Refurbished | Free delivery in 2-4 days | discountcomputerdepot | 99.6% positive (175.7K) | true | 267726532332 | United States | 177 |
| 4 | Lenovo ThinkPad E14 Gen 3 Laptop 14” FHD AMD Ryzen 5 16GB RAM 5… | $374.99 | Good - Refurbished | Free delivery in 2-4 days | discountcomputerdepot | 99.6% positive (175.7K) | true | 267224486732 | United States | 177 |
| 5 | Dell Latitude E5470 Laptop | 4GB RAM | 240GB SSD | 2.4GHz i5 | … | $50.00 | Pre-Owned | +$9.56 delivery | shift_into | 100% positive (454) | false | 178533582774 | United States | 177 |
| 6 | Dell Latitude 3490 14" Intel i5-7200U 2.50 GHz HDD 500GHz 8 GB … | $21.00 | Pre-Owned | +$20.00 delivery | irfannj | 98.6% positive (546) | false | 336815767348 | United States | 177 |
| 7 | 14" Dell Latitude Laptop: Intel i5! 16GB RAM - 500GB Storage! Z… | $122.59 | Good - Refurbished | Free delivery in 2-3 days | regadget | 99.8% positive (14.8K) | false | 117276989676 | United States | 177 |
| 8 | HP PROBOOK 640 G5 14" Windows 11 PRO Laptop i5 8th Gen 8GB RAM … | $155.00 | Pre-Owned | Free delivery | ticktock1-2-3 | 98.5% positive (63.4K) | false | 336755308094 | United States | 177 |
| 9 | HP Chromebook 11 G7 11.6" Intel 2.60 GHz 4 GB RAM 32 GB eMMC Bl… | $75.99 | Very Good - Refurbished | Free delivery | jetpaltd | 99.8% positive (5.2K) | false | 115603286837 | United States | 177 |
| 10 | dell inspiron 15 3000 laptop | $66.00 | Pre-Owned | +$8.58 delivery in 2-4 days | retrobountyhunters | 0% positive (0) | false | 800724483539 | United States | 177 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | What to search for, as you would type it on eBay. | used laptop |
| category | integer | no | Only listings in this eBay category ID. The categories endpoint lists them. | |
| condition | integer | no | Only listings in this eBay condition ID, such as new or used. | |
| limit | integer | no | Listings per page: 60, 120 or 240. | 60 |
| listing_type | string | no | Buy It Now (bin) or auction only. | bin · auction |
| max_price | string | no | The highest price to include. | |
| min_price | string | no | The lowest price to include. | |
| page | integer | no | Which page of results to return, starting at 1. | 1 |
| seller | string | no | Only listings from this seller's username. | |
| sold | boolean | no | Search covers active listings only, so this stays false. | false |
| sort | string | no | Best match, newest, lowest or highest price, or ending soonest. | best · newest · lowest_price · highest_price · … |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| listings[].title | string | The listing title as the seller wrote it. | Dell Latitude 3500 Laptop 15.6” HD Core i5 16GB RAM 256GB SSD W… |
| listings[].price | string | The price as eBay shows it, with its currency sign. | $242.22 |
| listings[].condition | string | The item's condition as the seller lists it. | Good - Refurbished |
| listings[].shipping | string | Delivery terms as eBay shows them. | Free delivery in 2-4 days |
| listings[].seller_name | string | The seller's eBay name. | discountcomputerdepot |
| listings[].seller_feedback | string | The seller's positive feedback share and count. | 99.6% positive (175.7K) |
| listings[].promoted | boolean | Whether the listing is a paid placement. | true |
| listings[].item_id | string | eBay's ID for the listing. | 267147782259 |
| listings[].location | string | Where the item ships from. | United States |
| listings[].leaf_category | string | eBay's ID for the listing's most specific category. | 177 |
| listings[].rank | integer | The listing's place in the results, starting at 0. | 0 |
| listings[].sold | boolean | Whether the listing has sold. | false |
| listings[].url | string | The page on eBay. | https://www.ebay.com/itm/267147782259 |
| has_more | boolean | Whether another page follows. | true |
| listings | array | The listings. | 60 records |
| next_page | integer | Send it as page to get the next page. | 2 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "ebay.products.search", "input": { "limit": 60, "page": 1, "query": "used laptop" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "ebay.products.search", "input": { "limit": 60, "page": 1, "query": "used laptop" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "ebay.products.search", "input": { "limit": 60, "page": 1, "query": "used laptop" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Using Upscrape, search eBay for used laptops and make a table of title, price, condition, shipping and seller, cheapest first. Flag the promoted listings.
More from the eBay API
- eBay Item API1 credit
- eBay Deals API1 credit
- eBay Store Items API1 credit
- eBay Store API1 credit
- eBay Seller Feedback API1 credit
- eBay Product Reviews API1 credit
- eBay Ranking Search API1 credit
- eBay Promotions Search API1 credit
- eBay Item Recommendations API1 credit
- eBay Additional Item Recommendations API1 credit
- eBay Categories API1 credit
The same data from other platforms
eBay Listings Search API FAQ
The short answers. The docs have the long ones.
How much does the eBay Listings Search API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send query. The input fields below list every option with its type and limits.
Do I need an eBay login?
No. It reads public eBay data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds ebay.products.search, checks its price and runs it with the same credits as the REST API.
Your first eBay call is free.
Up to 100 free credits to start, no card needed.