eBay API · Endpoint

eBay Item API

Q: What do I send?

Send item_id. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds ebay.product.detail.get, checks its price and runs it with the same credits as the REST API.

Get one item from its ID: price and currency, condition, availability, quantity sold, item specifics, shipping, returns and the seller's rating.

1 credit per call
Failed calls are free
Updated 14 Oct 2026
ebay.product.detail.get

Start free, 100 credits API reference

Response completed

{  "title": "Lenovo ThinkPad E14 Gen 2 14” Laptop AMD Ryzen 5 16GB RAM 256GB SSD Windows 11",  "price": "249.99",  "availability": "OutOfStock",  "catalog_product_id": "5031559411",  "condition": "Good - Refurbished",  "currency": "USD",  "return_policy": "Returns accepted — 30 days, free returns",  "reviews_url": "https://www.ebay.com/urw/Lenovo+ThinkPad+14.1%22+T440+Core+I5+Laptop+Windows+10+8gb+RAM+128gb+SSD+Webcam/product-reviews/5031559411",  "sold_quantity": 1722,  "item_specifics": {    "Brand": "Lenovo",    "Bundle Description": "Charger is included",    "California Prop 65 Warning": "WARNING: This product can expose you to chemicals, including Lead, which are known to the State of California to cause cancer.",    "Color": "Black",    "Condition": "Good - Refurbished",    "Connectivity": "Gigabit Ethernet, HDMI, USB 2.0, USB-C, USB 3.2, Headphone/Microphone Combo Port",    "Country of Origin": "China",    "Custom Bundle": "Yes",    "Custom Label": "92230",    "Features": "Bluetooth, Built-in Microphone, Built-in Webcam, Widescreen Display, Wi-Fi, Anti-glare HD LED Display, Integrated Speakers",    "GPU": "AMD Radeon Graphics",    "Graphics Processing Type": "Integrated/On-Board Graphics",    "Item Height": "0.70 in",    "Item Length": "8.66 in",    "Item Weight": "3.61 lbs",    "Item Width": "12.7 in",    "MPN": "lenovodeals",    "Maximum Resolution": "1920 x 1080",    "Model": "Lenovo ThinkPad E14 Gen 2",    "Modified Item": "No",    "Most Suitable For": "Casual Computing, Workstation, School, Education, Office, Business",    "Operating System": "Windows 11 Home",    "Processor": "AMD Ryzen 5 PRO 4500U",    "Processor Speed": "2.10 GHz",    "RAM Size": "16 GB",    "Release Year": "2021",    "SSD Capacity": "256 GB",    "Screen Size": "14 in",    "Seller Notes": "The item shows moderate wear and is backed by a one year warranty. It is fully functional and has been professionally refurbished, inspecte…",    "Series": "ThinkPad",    "Storage Type": "SSD (Solid State Drive)",    "Type": "Notebook/Laptop",    "UPC": "does not apply",    "Warranty": "1 Year Warranty from a Microsoft Registered Refurbisher!"  },  "seller": {    "name": "Discount Computer Depot",    "feedback_rating": "99.6% positive",    "feedback_score": 175789,    "store_url": "https://www.ebay.com/str/discountcomputerdepot"  },  "shipping": {    "location": "Waco, Texas, United States",    "cost": "0.0",    "currency": "USD",    "free_shipping": true  }}

Try it live, free

Input

What you send

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

Field	Type	Required	What it does	Example
item_id	string	yes	The item's number, from its eBay URL or a search result.	283987164379

Response

Fields it returns

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

Field	Type	What it is	Example
title	string	The listing title as the seller wrote it.	Lenovo ThinkPad E14 Gen 2 14” Laptop AMD Ryzen 5 16GB RAM 256GB…
price	string	The price as eBay shows it, with its currency sign.	249.99
currency	string	The currency code of the prices.	USD
condition	string	The item's condition as the seller lists it.	Good - Refurbished
availability	string	Whether the item can be bought now.	OutOfStock
sold_quantity	integer	How many units have sold.	1722
seller	object	The seller of the item.	4 fields
seller.name	string	The seller's store name.	Discount Computer Depot
seller.feedback_rating	string	The seller's share of positive feedback.	99.6% positive
seller.feedback_score	integer	The seller's feedback score.	175,789
seller.store_url	string	The seller's eBay store.	https://www.ebay.com/str/discountcomputerdepot
shipping	object	Delivery terms as eBay shows them.	4 fields
shipping.location	string	Where the item ships from.	Waco, Texas, United States
shipping.cost	string	The delivery cost.	0.0
shipping.currency	string	The currency code of the prices.	USD
shipping.free_shipping	boolean	Whether delivery is free.	true
return_policy	string	The seller's return terms.	Returns accepted — 30 days, free returns
catalog_product_id	string	eBay's catalog ID for the product; the reviews endpoint takes it.	5031559411
item_specifics	object	The item's details as the seller lists them, such as brand, model and size.	34 fields
item_specifics.Brand	string	The brand, as the seller lists it.	Lenovo
item_specifics.Bundle Description	string	What comes bundled with the item.	Charger is included
item_specifics.California Prop 65 Warning	string	The California Prop 65 health warning for the item.	WARNING: This product can expose you to chemicals, including Le…
item_specifics.Color	string	The item's colour.	Black
item_specifics.Condition	string	The item's condition as the seller lists it.	Good - Refurbished
item_specifics.Connectivity	string	The ports and connections the item has.	Gigabit Ethernet, HDMI, USB 2.0, USB-C, USB 3.2, Headphone/Micr…
item_specifics.Country of Origin	string	Where the item was made.	China
item_specifics.Custom Bundle	string	Whether the seller put together a custom bundle.	Yes
item_specifics.Custom Label	string	The seller's own stock code for the listing.	92230
item_specifics.Features	string	The item's features as the seller lists them.	Bluetooth, Built-in Microphone, Built-in Webcam, Widescreen Dis…
item_specifics.GPU	string	The graphics chip.	AMD Radeon Graphics
item_specifics.Graphics Processing Type	string	The kind of graphics, such as integrated.	Integrated/On-Board Graphics
item_specifics.Item Height	string	The item's height.	0.70 in
item_specifics.Item Length	string	The item's length.	8.66 in
item_specifics.Item Weight	string	The item's weight.	3.61 lbs
item_specifics.Item Width	string	The item's width.	12.7 in
item_specifics.MPN	string	The manufacturer part number, as the seller lists it.	lenovodeals
item_specifics.Maximum Resolution	string	The highest screen resolution.	1920 x 1080
item_specifics.Model	string	The item's model.	Lenovo ThinkPad E14 Gen 2
item_specifics.Modified Item	string	Whether the item was changed from the original.	No
item_specifics.Most Suitable For	string	What the item suits best, as the seller lists it.	Casual Computing, Workstation, School, Education, Office, Busin…
item_specifics.Operating System	string	The operating system installed.	Windows 11 Home
item_specifics.Processor	string	The processor.	AMD Ryzen 5 PRO 4500U
item_specifics.Processor Speed	string	The processor's speed.	2.10 GHz
item_specifics.RAM Size	string	How much memory the item has.	16 GB
item_specifics.Release Year	string	The year the model came out.	2021
item_specifics.SSD Capacity	string	How much SSD storage the item has.	256 GB
item_specifics.Screen Size	string	The screen size.	14 in
item_specifics.Seller Notes	string	The seller's notes on the item's condition.	The item shows moderate wear and is backed by a one year warran…
item_specifics.Series	string	The product line, such as ThinkPad.	ThinkPad
item_specifics.Storage Type	string	The kind of storage, such as SSD.	SSD (Solid State Drive)
item_specifics.Type	string	The kind of item, such as laptop.	Notebook/Laptop
item_specifics.UPC	string	The item's UPC barcode number, when it has one.	does not apply
item_specifics.Warranty	string	The warranty offered with the item.	1 Year Warranty from a Microsoft Registered Refurbisher!
reviews_url	string	The product's review page on eBay.	https://www.ebay.com/urw/Lenovo+ThinkPad+14.1%22+T440+Core+I5+L…

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.product.detail.get",  "input": {    "item_id": "283987164379"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "ebay.product.detail.get",  "input": {    "item_id": "283987164379"  }}''')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.product.detail.get",  "input": {    "item_id": "283987164379"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

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

With Upscrape, open eBay item 283987164379 and tell me its price, condition, how many have sold, where it ships from, the return policy and the seller's rating.

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

eBay