eBay API: Get listing details
Gets the full public details of an eBay listing by link or item number: price, sale type, bids, condition, shipping, delivery, returns, location, item specifics, the seller's description, photos, seller and listing status. Shipping and delivery text may vary by destination; unavailable details are null.
Unofficial. Not affiliated with or endorsed by eBay.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Listing, required
listing An eBay item number or listing link, such as https://www.ebay.com/itm/376273226616.
https://www.ebay.com/itm/376273226616
Input as JSON
{ "listing": "https://www.ebay.com/itm/376273226616" }Output
{ "bids": null, "price": 315.48, "title": "LEGO 21302 Ideas The Big Bang Theory / New / Factory Sealed", "currency": "GBP", "watchers": 37, "condition": "New", "page_link": "https://www.ebay.com/itm/376273226616" , "sale_type": "Buy It Now", "time_left": null, "item_number": "376273226616", "photo_links": [ "https://i.ebayimg.com/images/g/o6QAAOSwFMNoLX9~/s-l1600.webp" , "https://i.ebayimg.com/images/g/fzIAAOSwyk9oLX95/s-l1600.webp" , "https://i.ebayimg.com/images/g/Ui4AAOSwmH1oLX98/s-l1600.webp" ], "seller_name": "yooyooshop", "item_location": "Bucheon-si, Gyeonggi-do, South Korea", "quantity_sold": 5, "shipping_cost": "US $10.48", "item_specifics": [ { "name": "Condition", "value": "New: A brand-new, unused, unopened and undamaged item in original retail packaging (where packaging is applicable). If the item comes direct from a manufacturer, it may be delivered in non-retail packaging, such as a plain or unprinted box or plastic bag. See the seller's listing for full details." }, { "name": "Brand", "value": "LEGO" }, { "name": "LEGO Theme", "value": "Ideas" } ], "listing_status": "active", "returns_policy": "30 days return . Buyer pays for return postage. If you use an eBay delivery label, it will be deducted from your refund amount .", "condition_notes": null, "delivery_estimate": "Estimated between Mon, 19 Oct and Mon, 2 Nov to 30144", "seller_description": "LEGO 21302 Ideas The Big Bang Theory / New / Factory Sealed We only handle genuine products. Bring home the iconic living room from The Big Bang Theory with this official LEGO Ideas set ! It includes detailed minifigures of your favorite characters and fun show references — a perfect gift for fans o…", "seller_feedback_score": 2824, "seller_positive_percent": 99.5}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ebay.com/get_listing","input":{"listing":"https://www.ebay.com/itm/376273226616"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "ebay.com/get_listing" , "input": { "listing": "https://www.ebay.com/itm/376273226616" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "ebay.com/get_listing" , "input": { "listing": "https://www.ebay.com/itm/376273226616" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run ebay.com/get_listing# with {"listing":"https://www.ebay.com/itm/376273226616"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "listing" ], "properties": { "listing": { "type": "string", "minLength": 1, "description": "An eBay item number or listing link, such as https://www.ebay.com/itm/376273226616." } }}Output schema
{ "type": "object", "required": [ "title", "price", "currency", "sale_type", "bids", "time_left", "condition", "condition_notes", "shipping_cost", "delivery_estimate", "returns_policy", "item_location", "item_specifics", "seller_description", "photo_links", "seller_name", "seller_feedback_score", "seller_positive_percent", "quantity_sold", "watchers", "listing_status", "item_number", "page_link" ], "properties": { "bids": { "type": [ "integer", "null" ] }, "price": { "type": [ "number", "null" ] }, "title": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "watchers": { "type": [ "integer", "null" ] }, "condition": { "type": [ "string", "null" ] }, "page_link": { "type": "string" }, "sale_type": { "enum": [ "Auction", "Buy It Now", null ], "type": [ "string", "null" ] }, "time_left": { "type": [ "string", "null" ] }, "item_number": { "type": "string" }, "photo_links": { "type": "array", "items": { "type": "string" } }, "seller_name": { "type": [ "string", "null" ] }, "item_location": { "type": [ "string", "null" ] }, "quantity_sold": { "type": [ "integer", "null" ] }, "shipping_cost": { "type": [ "string", "null" ] }, "item_specifics": { "type": "array", "items": { "type": "object", "required": [ "name", "value" ], "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "additionalProperties": false } }, "listing_status": { "enum": [ "active", "ended" ], "type": "string" }, "returns_policy": { "type": [ "string", "null" ] }, "condition_notes": { "type": [ "string", "null" ] }, "delivery_estimate": { "type": [ "string", "null" ] }, "seller_description": { "type": [ "string", "null" ] }, "seller_feedback_score": { "type": [ "integer", "null" ] }, "seller_positive_percent": { "type": [ "number", "null" ] } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
ebay.com/get_listing- Returns
- title, price, currency, sale type, bids, time left, condition, shipping, delivery, returns, location, item specifics, description, photos, seller, feedback, sold, watchers, status, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method ebay.com/get_listing with the inputs above.
Ask your agent
- What's the current bid and time left on eBay item 285647193021?
- Can you pull up everything about this listing: https://www.ebay.com/itm/394812736650 — condition, shipping cost, and return policy?
- I'm looking at item #176509823344 — who's the seller, what's their feedback score, and is it still active?
- Show me the item specifics, seller description, and photos for https://www.ebay.com/itm/226043918577 on eBay
- Is listing 305512847769 an auction or buy it now, and where does it ship from and how long is delivery?
See more
All eBay methodsChecks an eBay seller's public feedback profile and newest feedback comments from a username or store link. Store details are included when eBay shows them.
ebay.com/get_sellerGets the public details of a Craigslist listing from its link. Deleted or expired listings are not returned, and hidden contact details are not included.
craigslist.org/get_listingGets public details for one Airbnb listing from its link. When dates are given, it also returns dated prices and cancellation terms if Airbnb offers a quote.
airbnb.com/get_listingGets full details for a Newegg US product by name, product link, or item number. Seller, price, stock and shipping reflect the selected public offer; shipping may be unavailable when not displayed.
newegg.com/get_productLooks up an audiobook in an Audible store by title (optionally narrowed by author) or by Audible book link, and returns its details, narrators, length, rating, visitor price, series, publisher summary and whether that store's Plus Catalog includes it.
audible.com/get_audiobookLooks up a Chrome Web Store extension by name or store link and returns its public listing: developer, users, rating, version, update date, size, category, description, declared privacy practices, website and store link. Permissions are null when the listing does not show them.
chromewebstore.google.com/get_extensionSearches Mercari US listings for items for sale or sold, with condition, price and sorting filters, and adds seller, size and shipping details from each item page. Sold prices are displayed listing prices.
mercari.com/search_listingsGets a home's details from Realtor.com by street address or Realtor.com property link: status, list price, value estimate, beds, baths, size, year built, HOA fee, property and tax history, nearby schools, flood risk and photos.
realtor.com/get_home