> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Item Detail
> Full detail for a single eBay listing (price, condition, specifics, shipping, seller, ...).
## Path Parameters
The eBay listing item id. You can find this in search results or extract it from a listing URL (`/itm/{item_id}`).
## Query Parameters
eBay marketplace domain where the listing lives.
Examples: `com`, `co.uk`, `de`, `fr`
## Response
Marketplace domain the item was fetched from.
Full item object.
eBay listing item id.
eBay catalog product id (nullable).
Legacy item id, if different (nullable).
Listing title.
Listing subtitle (nullable).
Full URL to the listing.
Item condition label.
eBay numeric condition id (nullable).
Seller's free-text condition note (nullable).
Current price with `value`, `currency`, `symbol`, `raw`.
Strikethrough original price (nullable).
Discount percentage off original price (nullable).
ISO 4217 currency code.
Availability/stock message.
Quantity available (nullable).
Quantity sold (nullable).
Number of watchers (nullable).
`Buy It Now`, `Auction`, or `Best Offer`.
Whether the listing is an auction.
Number of bids (auctions only, nullable).
Relative time remaining for auctions, e.g. `12h 16m` (auctions only, nullable).
Current high bid for auction listings with `value`, `currency`, `symbol`, `raw`; mirrors `price`. Null for non-auction (fixed-price) listings.
Absolute auction end time as a Unix timestamp (float seconds). Null for non-auction listings.
Absolute auction end time as an ISO-8601 UTC string, e.g. `2026-06-22T19:50:51Z` (nullable).
Buy It Now price for fixed-price listings (mirrors `price`) or auction-with-Buy-It-Now listings, with `value`, `currency`, `symbol`, `raw`. Null for pure auctions.
Whether the seller accepts best offers (nullable).
Brand name (nullable).
Manufacturer part number (nullable).
Model name (nullable).
Color (nullable).
GTIN/UPC/EAN (nullable).
Primary image URL.
All image objects with `url`, `width`, `height`.
Number of images.
Listing description text (nullable).
Seller notes (nullable).
Key-value map of item specifics (e.g. `{"Brand": "Nintendo"}`).
Category breadcrumb path.
Primary category id (nullable).
Shipping options with `cost`, `is_free`, `service`, `destination_country`, `delivery_estimate`.
Primary shipping cost (nullable).
Whether primary shipping is free (nullable).
Item location text.
List of destinations the seller ships to.
Returns policy with `accepted`, `period`, `cost_paid_by`, `raw`.
Seller summary with `username`, `url`, `feedback_score`, `feedback_percent`, `store_name`, `store_url`.
Catalog rating, if shown (nullable).
Total ratings, if shown (nullable).
ISO 8601 timestamp the listing was last modified (nullable).
ISO 8601 timestamp when the item was scraped.
### Example Response
```json theme={null}
{
"domain": "com",
"item": {
"item_id": "256123456789",
"product_id": "20057872541",
"title": "Nintendo Switch OLED Model White Console - Brand New Sealed",
"url": "https://www.ebay.com/itm/256123456789",
"condition": "Brand New",
"condition_id": "1000",
"price": { "value": 299.99, "currency": "USD", "symbol": "$", "raw": "$299.99" },
"currency": "USD",
"availability": "In Stock",
"quantity_available": 12,
"quantity_sold": 42,
"watchers": 18,
"buying_format": "Buy It Now",
"is_auction": false,
"bids": null,
"time_left": null,
"current_bid": null,
"end_time_utc": null,
"end_time_at": null,
"buy_it_now_price": { "value": 299.99, "currency": "USD", "symbol": "$", "raw": "$299.99" },
"best_offer_enabled": true,
"brand": "Nintendo",
"mpn": "HEGSKAAAA",
"gtin": "0045496883414",
"main_image": "https://i.ebayimg.com/images/g/abc/s-l1600.jpg",
"images": [{ "url": "https://i.ebayimg.com/images/g/abc/s-l1600.jpg", "width": 1600, "height": 1600 }],
"images_count": 1,
"item_specifics": { "Brand": "Nintendo", "Model": "Switch OLED", "Color": "White" },
"categories": ["Video Games & Consoles", "Video Game Consoles"],
"category_id": "139971",
"shipping_options": [{ "cost": { "value": 0, "currency": "USD", "raw": "Free" }, "is_free": true, "service": "Standard Shipping" }],
"free_shipping": true,
"item_location": "United States",
"ships_to": ["United States", "Canada"],
"returns": { "accepted": true, "period": "30 days", "cost_paid_by": "buyer", "raw": "30 days returns. Buyer pays return shipping." },
"seller": { "username": "topgames_us", "url": "https://www.ebay.com/usr/topgames_us", "feedback_score": 18452, "feedback_percent": 99.4 },
"scraped_at": "2026-06-21T12:00:00Z"
}
}
```
### Auction data
Auction listings are fully supported. For auctions, `is_auction` is `true` and the auction-specific fields are populated: `bids` (bid count), `time_left` (relative remaining time), `current_bid` (the current high bid, mirroring `price`), and the absolute end time as both `end_time_utc` (Unix timestamp) and `end_time_at` (ISO-8601 Z string). For pure auctions `buy_it_now_price` is `null`; for fixed-price or auction-with-Buy-It-Now listings it carries the BIN price.
```json theme={null}
{
"domain": "com",
"item": {
"item_id": "256987654321",
"title": "Vintage Omega Seamaster Automatic Watch - No Reserve",
"url": "https://www.ebay.com/itm/256987654321",
"condition": "Pre-owned",
"price": { "value": 412.0, "currency": "USD", "symbol": "$", "raw": "$412.00" },
"currency": "USD",
"buying_format": "Auction",
"is_auction": true,
"bids": 23,
"time_left": "12h 16m",
"current_bid": { "value": 412.0, "currency": "USD", "symbol": "$", "raw": "$412.00" },
"end_time_utc": 1781034651.0,
"end_time_at": "2026-06-22T19:50:51Z",
"buy_it_now_price": null,
"scraped_at": "2026-06-22T07:34:51Z"
}
}
```
Each item-detail request costs **5 credits**. Failed requests are not charged.
## OpenAPI
````yaml GET /v1/ebay/items/{item_id}
openapi: 3.1.0
info:
title: ScrapeBadger eBay API
version: 1.0.0
description: >-
eBay marketplace scraping API for searching active and completed (sold)
listings, fetching item details, reviews, sellers, seller listings and
feedback, category browsing, autocomplete, and reference data across 18
marketplaces.
servers:
- url: https://scrapebadger.com
description: Production
security:
- apiKeyAuth: []
paths:
/v1/ebay/items/{item_id}:
get:
tags:
- eBay Items
summary: Get Item Detail
description: Get a single eBay listing's full detail.
operationId: getEbayItem
parameters:
- name: item_id
in: path
required: true
schema:
type: string
description: The eBay listing item id.
- name: domain
in: query
schema:
type: string
default: com
description: eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...).
responses:
'200':
description: Item detail
content:
application/json:
schema:
type: object
properties:
domain:
type: string
item:
type: object
properties:
item_id:
type: string
product_id:
type:
- string
- 'null'
legacy_item_id:
type:
- string
- 'null'
title:
type:
- string
- 'null'
subtitle:
type:
- string
- 'null'
url:
type:
- string
- 'null'
condition:
type:
- string
- 'null'
condition_id:
type:
- string
- 'null'
condition_description:
type:
- string
- 'null'
price:
type: object
properties:
value:
type:
- number
- 'null'
currency:
type:
- string
- 'null'
symbol:
type:
- string
- 'null'
raw:
type:
- string
- 'null'
original_price:
type: object
properties:
value:
type:
- number
- 'null'
currency:
type:
- string
- 'null'
symbol:
type:
- string
- 'null'
raw:
type:
- string
- 'null'
discount_percent:
type:
- number
- 'null'
currency:
type:
- string
- 'null'
availability:
type:
- string
- 'null'
quantity_available:
type:
- integer
- 'null'
quantity_sold:
type:
- integer
- 'null'
watchers:
type:
- integer
- 'null'
buying_format:
type:
- string
- 'null'
is_auction:
type: boolean
bids:
type:
- integer
- 'null'
time_left:
type:
- string
- 'null'
current_bid:
type:
- object
- 'null'
description: >-
Current high bid for auction listings; mirrors
`price`. Null for non-auction (fixed-price) listings.
properties:
value:
type:
- number
- 'null'
currency:
type:
- string
- 'null'
symbol:
type:
- string
- 'null'
raw:
type:
- string
- 'null'
end_time_utc:
type:
- number
- 'null'
description: >-
Absolute auction end time as a Unix timestamp (float
seconds). Null for non-auction listings.
end_time_at:
type:
- string
- 'null'
description: >-
Absolute auction end time as an ISO-8601 UTC string
(e.g. "2026-06-22T19:50:51Z"). Null for non-auction
listings.
buy_it_now_price:
type:
- object
- 'null'
description: >-
Buy It Now price for fixed-price listings (mirrors
`price`) or auction-with-Buy-It-Now listings. Null for
pure auctions.
properties:
value:
type:
- number
- 'null'
currency:
type:
- string
- 'null'
symbol:
type:
- string
- 'null'
raw:
type:
- string
- 'null'
best_offer_enabled:
type:
- boolean
- 'null'
brand:
type:
- string
- 'null'
mpn:
type:
- string
- 'null'
model:
type:
- string
- 'null'
color:
type:
- string
- 'null'
gtin:
type:
- string
- 'null'
main_image:
type:
- string
- 'null'
images:
type: array
items:
type: object
properties:
url:
type: string
width:
type:
- integer
- 'null'
height:
type:
- integer
- 'null'
images_count:
type: integer
description:
type:
- string
- 'null'
seller_notes:
type:
- string
- 'null'
item_specifics:
type: object
additionalProperties:
type: string
categories:
type: array
items:
type: string
category_id:
type:
- string
- 'null'
shipping_options:
type: array
items:
type: object
properties:
cost:
type: object
properties:
value:
type:
- number
- 'null'
currency:
type:
- string
- 'null'
symbol:
type:
- string
- 'null'
raw:
type:
- string
- 'null'
is_free:
type:
- boolean
- 'null'
service:
type:
- string
- 'null'
destination_country:
type:
- string
- 'null'
delivery_estimate:
type:
- string
- 'null'
shipping_cost:
type: object
properties:
value:
type:
- number
- 'null'
currency:
type:
- string
- 'null'
symbol:
type:
- string
- 'null'
raw:
type:
- string
- 'null'
free_shipping:
type:
- boolean
- 'null'
item_location:
type:
- string
- 'null'
ships_to:
type: array
items:
type: string
returns:
type: object
properties:
accepted:
type:
- boolean
- 'null'
period:
type:
- string
- 'null'
cost_paid_by:
type:
- string
- 'null'
raw:
type:
- string
- 'null'
seller:
type: object
properties:
username:
type:
- string
- 'null'
url:
type:
- string
- 'null'
feedback_score:
type:
- integer
- 'null'
feedback_percent:
type:
- number
- 'null'
store_name:
type:
- string
- 'null'
store_url:
type:
- string
- 'null'
rating:
type:
- number
- 'null'
ratings_total:
type:
- integer
- 'null'
date_modified_utc:
type:
- number
- 'null'
date_modified_at:
type:
- string
- 'null'
scraped_utc:
type:
- number
- 'null'
scraped_at:
type:
- string
- 'null'
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
````