eBay API Capability

Get item

Read item prices, availability, images, specifications, shipping, returns, and seller information.

Capability ID ebay.product.detail.get

Cost From $1.25 per 1,000 requests · 1 credit

Maximum runtime 180 seconds

# Get item

Read item prices, availability, images, specifications, shipping, returns, and seller information.

- Platform: [eBay](https://docs.upscrape.com/docs/platforms/ebay)
- Capability ID: `ebay.product.detail.get`
- Cost: 1 credit per request
- Maximum runtime: 180 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

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

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `item_id` | `string` | Yes | Item identifier. |

### Example input

```json
{
  "item_id": "283987164379"
}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "availability": "InStock",
  "best_offer_available": true,
  "catalog_product_id": "5031559411",
  "condition": "Good - Refurbished",
  "currency": "USD",
  "images": [
    "https://i.ebayimg.com/images/g/k4sAAeSwoFlqqJE1/s-l1600.jpg",
    "https://i.ebayimg.com/images/g/h7YAAeSwFGVqqJE1/s-l1600.jpg",
    "https://i.ebayimg.com/images/g/jzkAAeSwj7pqqJE1/s-l1600.jpg"
  ],
  "item_id": "283987164379",
  "item_specifics": {
    "Processor Speed": "1.60 GHz",
    "UPC": "does not apply",
    "SSD Capacity": "256 GB",
    "Graphics Processing Type": "Integrated/On-Board Graphics",
    "Release Year": "2018",
    "Connectivity": "Gigabit Ethernet, HDMI, USB-C, VGA, SD Card Slot, USB 3.2, Headphone/Microphone Combo Port",
    "Item Weight": "3.52 lbs",
    "Color": "Black",
    "Bundle Description": "Charger is included",
    "Series": "Latitude",
    "Operating System": "Windows 11 Pro",
    "Storage Type": "SSD (Solid State Drive)",
    "Brand": "Dell",
    "Warranty": "1 Year Warranty from a Microsoft Registered Refurbisher!",
    "Item Height": "0.79 in",
    "GPU": "Intel UHD Graphics 620",
    "Item Width": "13.12 in",
    "Custom Label": "92230",
    "Screen Size": "14 in",
    "MPN": "delldeals",
    "Country of Origin": "China",
    "Custom Bundle": "Yes",
    "RAM Size": "16 GB",
    "Features": "Bluetooth, Built-in Microphone, Built-in Webcam, Widescreen Display, Wi-Fi, Anti-glare HD LED Display, Integrated Speakers",
    "Model": "Dell Latitude 5490",
    "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.",
    "Item Length": "9.01 in",
    "Processor": "Intel Core i5-8250U",
    "Most Suitable For": "Casual Computing, Workstation, School, Education, Office, Business",
    "Maximum Resolution": "1920 x 1080",
    "Seller Notes": "The item shows moderate wear and is backed by a one year warranty. It is fully functional and has been professionally refurbished, inspected and cleaned to good condition by qualified sellers. The item includes original or new accessories and will come in a new generic packaging. See the seller's listing for full details.",
    "Modified Item": "No",
    "Condition": "Good - Refurbished",
    "Type": "Notebook/Laptop"
  },
  "price": "249.99",
  "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",
  "seller": {
    "feedback_rating": "99.6% positive",
    "feedback_score": 174386,
    "name": "Discount Computer Depot",
    "store_url": "https://www.ebay.com/str/discountcomputerdepot"
  },
  "shipping": {
    "cost": "0.0",
    "currency": "USD",
    "free_shipping": true,
    "location": "Waco, Texas, United States"
  },
  "sold_quantity": 1716,
  "title": "Dell Latitude 5490 Business 14” Laptop Core i5 16GB RAM 256GB SSD Windows 11 Pro"
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `availability` | `string` | InStock |
| `best_offer_available` | `boolean` | true |
| `catalog_product_id` | `string` | 5031559411 |
| `condition` | `string` | Good - Refurbished |
| `currency` | `string` | USD |
| `images` | `array` | 3 items |
| `images` | `array` | 3 items |
| `item_id` | `string` | 283987164379 |
| `item_specifics` | `object` | 34 fields |
| `item_specifics.Brand` | `string` | Dell |
| `item_specifics.Bundle Description` | `string` | Charger is included |
| `item_specifics.California Prop 65 Warning` | `string` | WARNING: This product can expose you to chemicals, including Lead, whic… |
| `item_specifics.Color` | `string` | Black |
| `item_specifics.Condition` | `string` | Good - Refurbished |
| `item_specifics.Connectivity` | `string` | Gigabit Ethernet, HDMI, USB-C, VGA, SD Card Slot, USB 3.2, Headphone/Mi… |
| `item_specifics.Country of Origin` | `string` | China |
| `item_specifics.Custom Bundle` | `string` | Yes |
| `item_specifics.Custom Label` | `string` | 92230 |
| `item_specifics.Features` | `string` | Bluetooth, Built-in Microphone, Built-in Webcam, Widescreen Display, Wi… |
| `item_specifics.GPU` | `string` | Intel UHD Graphics 620 |
| `item_specifics.Graphics Processing Type` | `string` | Integrated/On-Board Graphics |
| `item_specifics.Item Height` | `string` | 0.79 in |
| `item_specifics.Item Length` | `string` | 9.01 in |
| `item_specifics.Item Weight` | `string` | 3.52 lbs |
| `item_specifics.Item Width` | `string` | 13.12 in |
| `item_specifics.MPN` | `string` | delldeals |
| `item_specifics.Maximum Resolution` | `string` | 1920 x 1080 |
| `item_specifics.Model` | `string` | Dell Latitude 5490 |
| `item_specifics.Modified Item` | `string` | No |
| `item_specifics.Most Suitable For` | `string` | Casual Computing, Workstation, School, Education, Office, Business |
| `item_specifics.Operating System` | `string` | Windows 11 Pro |
| `item_specifics.Processor` | `string` | Intel Core i5-8250U |
| `item_specifics.Processor Speed` | `string` | 1.60 GHz |
| `item_specifics.RAM Size` | `string` | 16 GB |
| `item_specifics.Release Year` | `string` | 2018 |
| `item_specifics.SSD Capacity` | `string` | 256 GB |
| `item_specifics.Screen Size` | `string` | 14 in |
| `item_specifics.Seller Notes` | `string` | The item shows moderate wear and is backed by a one year warranty. It i… |
| `item_specifics.Series` | `string` | Latitude |
| `item_specifics.Storage Type` | `string` | SSD (Solid State Drive) |
| `item_specifics.Type` | `string` | Notebook/Laptop |
| `item_specifics.UPC` | `string` | does not apply |
| `item_specifics.Warranty` | `string` | 1 Year Warranty from a Microsoft Registered Refurbisher! |
| `price` | `string` | 249.99 |
| `return_policy` | `string` | Returns accepted — 30 days, free returns |
| `reviews_url` | `string` | https://www.ebay.com/urw/Lenovo+ThinkPad+14.1%22+T440+Core+I5+Laptop+Wi… |
| `seller` | `object` | 4 fields |
| `seller.feedback_rating` | `string` | 99.6% positive |
| `seller.feedback_score` | `integer` | 174386 |
| `seller.name` | `string` | Discount Computer Depot |
| `seller.store_url` | `string` | https://www.ebay.com/str/discountcomputerdepot |
| `shipping` | `object` | 4 fields |
| `shipping.cost` | `string` | 0.0 |
| `shipping.currency` | `string` | USD |
| `shipping.free_shipping` | `boolean` | true |
| `shipping.location` | `string` | Waco, Texas, United States |
| `sold_quantity` | `integer` | 1716 |
| `title` | `string` | Dell Latitude 5490 Business 14” Laptop Core i5 16GB RAM 256GB SSD Windo… |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)

POST /execute Shared execution endpoint

Input parameters

item_id string required

Item identifier.

Example 283987164379

Response

Successful output is returned in results[0].data.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

Illustrative sample The example response is shown in the response panel.

Illustrative output fields

Values illustrate one response. Read the guidance above for missing values and limits; fields can vary with the requested operation and the data available.

Path	Observed type	Example
`availability`	`string`	InStock
`best_offer_available`	`boolean`	true
`catalog_product_id`	`string`	5031559411
`condition`	`string`	Good - Refurbished
`currency`	`string`	USD
`images`	`array`	3 items
`images`	`array`	3 items
`item_id`	`string`	283987164379
`item_specifics`	`object`	34 fields
`item_specifics.Brand`	`string`	Dell
`item_specifics.Bundle Description`	`string`	Charger is included
`item_specifics.California Prop 65 Warning`	`string`	WARNING: This product can expose you to chemicals, including Lead, whic…
`item_specifics.Color`	`string`	Black
`item_specifics.Condition`	`string`	Good - Refurbished
`item_specifics.Connectivity`	`string`	Gigabit Ethernet, HDMI, USB-C, VGA, SD Card Slot, USB 3.2, Headphone/Mi…
`item_specifics.Country of Origin`	`string`	China
`item_specifics.Custom Bundle`	`string`	Yes
`item_specifics.Custom Label`	`string`	92230
`item_specifics.Features`	`string`	Bluetooth, Built-in Microphone, Built-in Webcam, Widescreen Display, Wi…
`item_specifics.GPU`	`string`	Intel UHD Graphics 620
`item_specifics.Graphics Processing Type`	`string`	Integrated/On-Board Graphics
`item_specifics.Item Height`	`string`	0.79 in
`item_specifics.Item Length`	`string`	9.01 in
`item_specifics.Item Weight`	`string`	3.52 lbs
`item_specifics.Item Width`	`string`	13.12 in
`item_specifics.MPN`	`string`	delldeals
`item_specifics.Maximum Resolution`	`string`	1920 x 1080
`item_specifics.Model`	`string`	Dell Latitude 5490
`item_specifics.Modified Item`	`string`	No
`item_specifics.Most Suitable For`	`string`	Casual Computing, Workstation, School, Education, Office, Business
`item_specifics.Operating System`	`string`	Windows 11 Pro
`item_specifics.Processor`	`string`	Intel Core i5-8250U
`item_specifics.Processor Speed`	`string`	1.60 GHz
`item_specifics.RAM Size`	`string`	16 GB
`item_specifics.Release Year`	`string`	2018
`item_specifics.SSD Capacity`	`string`	256 GB
`item_specifics.Screen Size`	`string`	14 in
`item_specifics.Seller Notes`	`string`	The item shows moderate wear and is backed by a one year warranty. It i…
`item_specifics.Series`	`string`	Latitude
`item_specifics.Storage Type`	`string`	SSD (Solid State Drive)
`item_specifics.Type`	`string`	Notebook/Laptop
`item_specifics.UPC`	`string`	does not apply
`item_specifics.Warranty`	`string`	1 Year Warranty from a Microsoft Registered Refurbisher!
`price`	`string`	249.99
`return_policy`	`string`	Returns accepted — 30 days, free returns
`reviews_url`	`string`	https://www.ebay.com/urw/Lenovo+ThinkPad+14.1%22+T440+Core+I5+Laptop+Wi…
`seller`	`object`	4 fields
`seller.feedback_rating`	`string`	99.6% positive
`seller.feedback_score`	`integer`	174386
`seller.name`	`string`	Discount Computer Depot
`seller.store_url`	`string`	https://www.ebay.com/str/discountcomputerdepot
`shipping`	`object`	4 fields
`shipping.cost`	`string`	0.0
`shipping.currency`	`string`	USD
`shipping.free_shipping`	`boolean`	true
`shipping.location`	`string`	Waco, Texas, United States
`sold_quantity`	`integer`	1716
`title`	`string`	Dell Latitude 5490 Business 14” Laptop Core i5 16GB RAM 256GB SSD Windo…

Execution behavior

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until the job reaches completed or failed.

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

import json import os import requests payload = json.loads(r'''{ "input": { "item_id": "283987164379" }, "capability": "ebay.product.detail.get" }''') 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))

{ "availability": "InStock", "best_offer_available": true, "catalog_product_id": "5031559411", "condition": "Good - Refurbished", "currency": "USD", "images": [ "https://i.ebayimg.com/images/g/k4sAAeSwoFlqqJE1/s-l1600.jpg", "https://i.ebayimg.com/images/g/h7YAAeSwFGVqqJE1/s-l1600.jpg", "https://i.ebayimg.com/images/g/jzkAAeSwj7pqqJE1/s-l1600.jpg" ], "item_id": "283987164379", "item_specifics": { "Processor Speed": "1.60 GHz", "UPC": "does not apply", "SSD Capacity": "256 GB", "Graphics Processing Type": "Integrated/On-Board Graphics", "Release Year": "2018", "Connectivity": "Gigabit Ethernet, HDMI, USB-C, VGA, SD Card Slot, USB 3.2, Headphone/Microphone Combo Port", "Item Weight": "3.52 lbs", "Color": "Black", "Bundle Description": "Charger is included", "Series": "Latitude", "Operating System": "Windows 11 Pro", "Storage Type": "SSD (Solid State Drive)", "Brand": "Dell", "Warranty": "1 Year Warranty from a Microsoft Registered Refurbisher!", "Item Height": "0.79 in", "GPU": "Intel UHD Graphics 620", "Item Width": "13.12 in", "Custom Label": "92230", "Screen Size": "14 in", "MPN": "delldeals", "Country of Origin": "China", "Custom Bundle": "Yes", "RAM Size": "16 GB", "Features": "Bluetooth, Built-in Microphone, Built-in Webcam, Widescreen Display, Wi-Fi, Anti-glare HD LED Display, Integrated Speakers", "Model": "Dell Latitude 5490", "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.", "Item Length": "9.01 in", "Processor": "Intel Core i5-8250U", "Most Suitable For": "Casual Computing, Workstation, School, Education, Office, Business", "Maximum Resolution": "1920 x 1080", "Seller Notes": "The item shows moderate wear and is backed by a one year warranty. It is fully functional and has been professionally refurbished, inspected and cleaned to good condition by qualified sellers. The item includes original or new accessories and will come in a new generic packaging. See the seller's listing for full details.", "Modified Item": "No", "Condition": "Good - Refurbished", "Type": "Notebook/Laptop" }, "price": "249.99", "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", "seller": { "feedback_rating": "99.6% positive", "feedback_score": 174386, "name": "Discount Computer Depot", "store_url": "https://www.ebay.com/str/discountcomputerdepot" }, "shipping": { "cost": "0.0", "currency": "USD", "free_shipping": true, "location": "Waco, Texas, United States" }, "sold_quantity": 1716, "title": "Dell Latitude 5490 Business 14” Laptop Core i5 16GB RAM 256GB SSD Windows 11 Pro" }