eBay Item API and MCP — Listing Price, Condition & Seller
Send an eBay item ID or listing URL and this source returns that one active listing as data: title, price, condition, images and seller.
- You send
- An eBay item ID or listing URL
- You get back
- Title, price, condition, images and seller for one active listing
- Coverage
- Active eBay listings with a valid item ID or URL.
- Price
- 5 pts — $5 per 1,000
- Charged only when a listing resolves. An item ID that's expired or doesn't exist is not billed.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Checking listings by hand | Open each URL and read the page | Free, and slow at any scale | Fine for one listing, unworkable for a watchlist |
| Building a scraper | Write it, host it, repair it when eBay's page markup changes | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request per item ID or URL | $5 per 1,000, misses not billed | Returns what the listing publishes at request time — a snapshot, not a history |
What you get back
Every field in the example response below.
| Field | Type | Description |
|---|---|---|
id | string | eBay's item ID for the listing. |
title | string | Listing title. |
url | string | Direct link to the listing. |
price | number | Current listed price. |
currency | string | Currency code the price is in, e.g. "USD". |
list_price | number | The struck-through "was" price, when eBay publishes one. |
condition | string | Condition as the seller describes it — New, Used, For parts, and so on. |
seller_notes | string | Seller's free-text condition notes, when given. |
quantity_available | null | Quantity the seller has available, when eBay publishes a count. Null in the example. |
sold_count | null | Number of units sold, when eBay publishes a count. Null in the example. |
buying_formats | array | Buying format(s) for the listing, e.g. "FIXED_PRICE" or "AUCTION". |
has_best_offer | boolean | Whether the listing accepts best-offer negotiation. |
image | string | Primary listing image URL. |
images | array | All listing image URLs. |
item_specifics | object | Seller-entered specifics as key/value pairs — condition detail, brand, features and the rest. Shape varies per listing. |
brand | string | Brand, as listed in item specifics. |
mpn | string | Manufacturer part number. |
upc | null | UPC, when the seller provided one. Null in the example. |
breadcrumbs | array | eBay's category breadcrumb trail for the listing. |
category | string | Leaf category name for the listing. |
seller | object | The seller who posted the listing: id, name, feedback_count, positive_percent and store_url. |
watcher_count | number | Number of buyers currently watching the listing, when eBay publishes a count. |
Example response
A real response, as returned.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "ebay_item",
"item": "336776720041",
"human": "# eBay item\n\n- **Item:** 336776720041\n- **Proxy traffic:** 3.90 MB\n- **Title:** Apple Magic Mouse -A3204 Black - Wireless Bluetooth Mouse USB-C - Mint in Box\n- **Price:** USD75.99\n- **Condition:** Used\n- **Seller:** The Coco Store",
"machine": {
"item": {
"id": "336776720041",
"title": "Apple Magic Mouse -A3204 Black - Wireless Bluetooth Mouse USB-C - Mint in Box",
"url": "https://www.ebay.com/itm/336776720041",
"price": 75.99,
"currency": "USD",
"list_price": 79.99,
"condition": "Used",
"seller_notes": "“Excellent Mint Condition. Barely Used. Comes with Box.”",
"quantity_available": null,
"sold_count": null,
"buying_formats": [
"FIXED_PRICE"
],
"has_best_offer": false,
"image": "https://i.ebayimg.com/images/g/6rUAAeSw7BNqmbP2/s-l1600.png",
"images": [
"https://i.ebayimg.com/images/g/6rUAAeSw7BNqmbP2/s-l1600.png",
"https://i.ebayimg.com/images/g/0VUAAeSw5NJqmbP~/s-l1600.png"
],
"item_specifics": {
"Condition": "Used",
"Seller Notes": "“Excellent Mint Condition. Barely Used. Comes with Box.”",
"Device Charging Range": "1-2",
"Color": "Black",
"MPN": "MXK63AM/A",
"Tracking Method": "Laser",
"Number of Buttons": "1",
"Brand": "Apple",
"Type": "Tactile/Multi-Touch Mouse",
"Item Height": "0.85 in",
"Maximum DPI": "3200",
"Model": "Apple Magic Mouse",
"Connectivity": "Wireless, Bluetooth, Lightning",
"Charger Included": "No",
"Features": "Rechargeable",
"Country of Origin": "China"
},
"brand": "Apple",
"mpn": "MXK63AM/A",
"upc": null,
"breadcrumbs": [
"eBay",
"Electronics"
],
"category": "Mice, Trackballs & Touchpads",
"seller": {
"id": "cocosmartphones",
"name": "The Coco Store",
"feedback_count": 41808,
"positive_percent": 99.8,
"store_url": "https://www.ebay.com/str/cocosmartphones?_trksid=p4429486.m3561.l161210"
},
"watcher_count": 39
},
"proxy_traffic_bytes": 4086338
},
"total_points": 5
}How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
One item ID or listing URL per request. Either form works — an eBay item ID like 188182070260 or the full listing URL.
curl -X POST https://api.neuralverge.ai/functions/v1/run-ebay-item \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "item": "188182070260" }'What teams use it for
Where this field shows up in an actual workflow.
Watch a specific listing you compete against and get alerted when the price moves.
Check the current price and condition of a listing before buying to resell elsewhere.
Confirm a listing you were sent — by a supplier, a customer, or a partner — actually says what they claim it says.
Track a saved listing through an auction's final hours instead of refreshing the page.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Active eBay listings with a valid item ID or URL.
Read at request time.
This source returns publicly visible listing information, stamped with the item ID or URL it was read from and a session id you can trace.
- —Only covers listings that are currently active; an ended or removed listing won't resolve.
- —Reflects what the seller entered, which isn't independently verified by eBay or by NeuralVerge.
- —A single listing's price and stock can change between the moment you request it and the moment you read the result.
Questions, answered
Item returns one specific active listing from one seller. Product returns eBay's catalog record — the shared brand/model entry that many listings can belong to.
Related sources
Try ebay item on your own data
One request format across every source in the catalog.