eBay API reference
Get eBay listings, prices, item details, deals, stores and seller feedback as clean JSON. Search by keyword or read one item, store or seller. No eBay account needed.
The eBay API has 12 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin eBay in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are item_id, query and store. Prices run from 0.5 credits to 3 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
ebay.products.search |
Search active listings by keyword, with filters for category, price range, condition, seller and auction or Buy It Now. | 2–5 credits |
ebay.product.detail.get |
Get one item from its ID: price and currency, condition, availability, quantity sold, item specifics, shipping, returns and the seller's rating. | 1 credit |
ebay.deals.list |
List eBay's current deals with price, discount and quantity left, and browse them by deal category. | 0.75 credits |
ebay.store.items.list |
List or search the items in one eBay store, page by page. | 1–5 credits |
ebay.store.get |
Get a store's profile: name, description, feedback, followers and items sold. | 1 credit |
ebay.seller.feedback.list |
Read a seller's public feedback: the comment, rating, item, price and whether the purchase was verified. | 0.75–1.5 credits |
ebay.product.reviews.list |
Read the public ratings and reviews of an eBay catalog product, with its average rating. | 0.75 credits |
ebay.search.placements |
See the order listings appear in for a search, and which of them are promoted. | 1.5–5 credits |
ebay.search.promotions |
See the sponsored listings and ad placements on a search results page. | 2–5 credits |
ebay.item.promotions |
Get the recommended listings eBay shows on an item page, with their prices and discounts. | 0.5 credits |
ebay.item.deferred_promotions |
Get the extra recommendation rows on an item page, with their listing links. | 3 credits |
ebay.categories.list |
Get eBay's category tree with IDs and links, to filter searches by category. | 1 credit |
What to know
- Prices as eBay shows them Search and store results give the price as displayed, with its currency sign. The item endpoint gives the amount and currency separately.
- Item, product and seller IDs differ An item ID is one listing, a product ID is the catalog model many listings share, and a store name can differ from the seller's username.
- Reviews are the public ones Product reviews are the ratings and reviews eBay shows publicly for a catalog product, which can be a small set.
- Pages, one at a time List endpoints return a page and has_more. Ask for the next page number to continue.
Something missing or unclear? Ask the team that builds the eBay endpoints.