↑ ↓ to move ↵ to open
eBay API · Endpoint

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
Response completed
{  "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"    }  ]}
Try it live, free
Input

What you send

The input object of the request, with every field the endpoint accepts.

FieldTypeRequiredWhat it doesExample
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 · …
Response

Fields it returns

What each record in the response holds, with the values from the sample above.

FieldTypeWhat it isExample
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
REST API · MCP server

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"  }}'
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

Using Upscrape, search eBay for used laptops and make a table of title, price, condition, shipping and seller, cheapest first. Flag the promoted listings.

The agent finds the endpoint, shows you the price, and runs it with your credits.
eBay

More from the eBay API

Same data, other platforms

The same data from other platforms

Questions

eBay Listings Search API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
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.

Get started

Your first eBay call is free.

Up to 100 free credits to start, no card needed.