Capabilities
Ten read-only endpoints for search, listing detail, sellers, and categories. Prices come back in the currency of the eBay site you select.
A query returns up to 50 listing cards per page with price, shipping, condition, buying format, bid count, auction end time, and the seller's feedback percent. You can filter by condition, format, and price range, and sort by best match, newest, ending soonest, or price. See examples
Details add every image, the item specifics, the quantity available, the returns policy, the item location, the seller's own description, the category breadcrumbs, and the seller's feedback score. A batch call reads up to 5 listings. See examples
Similar items are the listings eBay recommends on an item's page, returned as listing cards. The offers call lists other listings of the same catalog product, which is useful for comparing prices on one product. See examples
A seller profile has the store name, feedback percent, items sold, followers, member-since date, location, and top-rated status. The seller's current listings come from a second call, up to 50 per page. See examples
The category tree as a flat list of ids, names, URLs, and parent ids, three levels deep by default. Pass a categoryId to get that category and its direct subcategories. See examples
Resolve reads an eBay item, seller, store, or category link and returns its type, id, marketplace, and canonical URL. It parses the link without loading the page. See examples
How a call is made
Send your key as a bearer token in the Authorization header. Search returns item numbers, and the listing calls take an item number or a link.
GET /api/v1/ebay/search requires q. Optional condition, format, sort, priceMin, priceMax, and page (1 to 10) refine the results, and marketplace picks the eBay site.
Details, offers, and similar items take id, the 9 to 15 digit item number, or an item url. When you pass a link, its host sets the marketplace.
GET /api/v1/ebay/seller and /api/v1/ebay/seller/products take username, the seller name that appears on each listing card.
Shortened examples
Trimmed responses for a listing card, a seller profile, a similar item, an offer, a category, and a resolved link. Prices are the ones shown when each sample was captured.
{
"id": "127943765980",
"title": "Apple iPhone 14 128GB A2649 Unlocked Very Good Condition All Colors",
"condition": "Very Good - Refurbished",
"price": 312.35,
"currency": "USD",
"shippingPrice": 0,
"buyingFormat": "fixed",
"seller": {
"username": "verizon",
"feedbackPercent": 99.5
}
}{
"id": "800634469572",
"title": "Apple iPhone 14 – Very Good Condition (512GB 128GB) Starlight Red Purple",
"condition": "Pre-owned",
"price": 279,
"currency": "USD",
"shippingPrice": 0,
"buyingFormat": "fixed"
}{
"id": "6000",
"name": "eBay Motors",
"parentId": null
}{
"username": "verizon",
"storeName": "Verizon",
"feedbackPercent": 99.5,
"itemsSold": 211000,
"followers": 18000,
"memberSince": "Jul 13, 2017",
"location": "United States",
"topRated": false
}{
"id": "376972331810",
"title": "Apple iPhone 14 - 128 GB - (PRODUCT)RED (Unlocked)",
"price": 280,
"currency": "USD"
}{
"type": "item",
"id": "127943765980",
"marketplace": "com",
"url": "https://www.ebay.com/itm/127943765980"
}Before you integrate
Answers about what the API reads, how to filter search, and which eBay sites it covers.
No. The API is read-only and uses no eBay account. It reads public listings, prices, sellers, and categories, while bidding, watching, and checkout happen on eBay.
Yes. condition takes new, used, or any. format takes auction, fixed, or any. sort takes best, newly, ending, price_asc, or price_desc. priceMin and priceMax set a range in the site's currency.
No. They are trimmed responses kept to show the field names. On a live call, search and seller listings are read fresh each time, and listing details are reused for up to 10 minutes.
Pass the item link as url to /api/v1/ebay/products/details, and the link's host sets the marketplace. /api/v1/ebay/resolve returns the item number and marketplace without loading the listing.
ebay.com. Set marketplace to co.uk, de, ca, com.au, fr, it, or es for another site, and prices come back in that site's currency.
The eBay docs cover the listing card fields, the search filters and sort values, the supported marketplaces, and a sample response for each of the 10 endpoints.
Every endpoint in the documentation includes a sample request in Shell, JavaScript, PHP, and Python.
Shell
JavaScript
PHP
PythonRelated APIs
Your SteadyAPI key covers these marketplace APIs too.
Walmart.com search, product details, prices, customer reviews, and Marketplace sellers, priced in USD. Walmart API
Amazon product search, details, prices, reviews, offers, best-seller rankings, and seller profiles. Amazon API
AliExpress product search, product details and descriptions, and product reviews. AliExpress API
Pricing
Your plan's monthly requests work on this API and every other SteadyAPI API. Plan details, overage rates, and the Free plan's daily cap are on the pricing page. Need more volume than the largest plan? Email [email protected].
Free $0.00 per month | Starter $14.99 per month | Developer $39.99 per month | Business Popular $89.99 per month | Enterprise $299.99 per month | |
|---|---|---|---|---|---|
| Subscribe | Subscribe | Subscribe | Subscribe | Subscribe | |
| Requests per month | 500 | 10,000 | 50,000 | 250,000 | 2,500,000 |
| Stock Market API | |||||
| Options Data API | |||||
| Crypto Data API | |||||
| AliExpress API | |||||
| Reddit API | |||||
| Booking.com API | |||||
| Real Estate API | |||||
| Baseball (MLB) API | |||||
| Hockey API | |||||
| Football API | |||||
| Amazon API | |||||
| eBay API | |||||
| Walmart API | |||||
| Instagram API | |||||
| Twitter / X API | |||||
| TikTok API | |||||
| YouTube API | |||||
| AutoHub API | |||||
| ScrapeFlow | |||||
| Commercial Use | |||||
| Optional overage rate* | $1.50 per 1,000 requests | $1.05 per 1,000 requests | $0.50 per 1,000 requests | $0.09 per 1,000 requests | |
| Overage cap | up to 50,000 extra | up to 250,000 extra | up to 1,250,000 extra | up to 12,500,000 extra |
Free $0.00 per year | Starter $11.96 per month$143.52 billed yearly | Developer $32.50 per month$389.99 billed yearly | Business Popular $72.50 per month$869.99 billed yearly | Enterprise $320.83 per month$3,849.99 billed yearly | |
|---|---|---|---|---|---|
| Subscribe | Subscribe | Subscribe | Subscribe | Subscribe | |
| Requests per month | 500 | 10,000 | 50,000 | 250,000 | 2,500,000 |
| Stock Market API | |||||
| Options Data API | |||||
| Crypto Data API | |||||
| AliExpress API | |||||
| Reddit API | |||||
| Booking.com API | |||||
| Real Estate API | |||||
| Baseball (MLB) API | |||||
| Hockey API | |||||
| Football API | |||||
| Amazon API | |||||
| eBay API | |||||
| Walmart API | |||||
| Instagram API | |||||
| Twitter / X API | |||||
| TikTok API | |||||
| YouTube API | |||||
| AutoHub API | |||||
| ScrapeFlow | |||||
| Commercial Use | |||||
| Optional overage rate* | $1.50 per 1,000 requests | $1.05 per 1,000 requests | $0.50 per 1,000 requests | $0.09 per 1,000 requests | |
| Overage cap | up to 50,000 extra | up to 250,000 extra | up to 1,250,000 extra | up to 12,500,000 extra |
* Overage is optional and stays off until you turn it on in Billing. It is available on paid plans billed by card through Stripe, and not during a trial. Usage is counted in monthly periods that start on your billing day, yearly plans included. Requests past the included limit are charged at the plan's rate for each started block of 1,000, up to the overage cap, on one invoice after the period ends. Amounts under $0.50 carry over to the next invoice. If you change plans during a period, the limit and overage rate of the plan you are on when the period ends apply to the whole period.
The Free plan is also capped at 20 requests per day (New York time). Requests count by endpoint weight, and only responses with HTTP status 200 count.
Commercial use is included only on the plans that list it. If you are not sure whether your project counts as commercial use, email [email protected] before you launch.
Why this API
Search gives you item numbers and seller names, and the detail calls take them as input.
Also on the blog
These posts come from across SteadyAPI, so the one at the top may be about a different API. The reference for this page is the documentation above.
Learn how to find hotels by destination using SteadyAPI. Resolve a place name to coordinates, then pull property names, ratings, and prices with the Booking.com hotel search endpoints.
READ MORE
Learn how to build a predictive real estate valuation pipeline using SteadyAPI. This guide shows developers how to combine historical property values, multi-provider forecasts, neighborhood market trends, housing market indicators, and comparable sales data to power automated valuation models (AVMs), investment analytics, and property intelligence platforms with structured real-time API data.
READ MORE
Neighborhood insights are just as important as the property itself. This guide shows developers how to use the SteadyAPI Neighborhood Amenities API to fetch school ratings, walkability and transit scores, and nearby amenities through a single endpoint. You'll learn how to authenticate requests, retrieve structured neighborhood data, filter schools and local businesses, and combine these metrics into a custom neighborhood quality score. Whether you're building a real estate marketplace, property valuation model, or location intelligence dashboard, this tutorial helps you enrich listings with valuable contextual data while reducing the complexity of managing multiple third-party integrations.
READ MORE
This guide walks developers through building a modern real estate data pipeline with SteadyAPI. You'll learn how to search MLS property listings, retrieve tax and transaction histories, analyze local housing market trends, and enrich property data with neighborhood and environmental insights. Instead of maintaining fragile web scrapers or navigating complex MLS integrations, SteadyAPI provides structured JSON APIs that simplify property data ingestion and help you build faster, more reliable real estate applications. Whether you're creating an investment platform, property valuation engine, market research tool, or analytics dashboard, this tutorial covers the essential endpoints and architecture needed to get started.
READ MORE