Get Item Detail
curl --request GET \
--url https://scrapebadger.com/v1/ebay/items/{item_id} \
--header 'x-api-key: <api-key>'{
"domain": "<string>",
"item": {
"item_id": "<string>",
"product_id": "<string>",
"legacy_item_id": "<string>",
"title": "<string>",
"subtitle": "<string>",
"url": "<string>",
"condition": "<string>",
"condition_id": "<string>",
"condition_description": "<string>",
"price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"original_price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"discount_percent": 123,
"currency": "<string>",
"availability": "<string>",
"quantity_available": 123,
"quantity_sold": 123,
"watchers": 123,
"buying_format": "<string>",
"is_auction": true,
"bids": 123,
"time_left": "<string>",
"best_offer_enabled": true,
"brand": "<string>",
"mpn": "<string>",
"model": "<string>",
"color": "<string>",
"gtin": "<string>",
"main_image": "<string>",
"images": [
{
"url": "<string>",
"width": 123,
"height": 123
}
],
"images_count": 123,
"description": "<string>",
"seller_notes": "<string>",
"item_specifics": {},
"categories": [
"<string>"
],
"category_id": "<string>",
"shipping_options": [
{
"cost": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"is_free": true,
"service": "<string>",
"destination_country": "<string>",
"delivery_estimate": "<string>"
}
],
"shipping_cost": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"free_shipping": true,
"item_location": "<string>",
"ships_to": [
"<string>"
],
"returns": {
"accepted": true,
"period": "<string>",
"cost_paid_by": "<string>",
"raw": "<string>"
},
"seller": {
"username": "<string>",
"url": "<string>",
"feedback_score": 123,
"feedback_percent": 123,
"store_name": "<string>",
"store_url": "<string>"
},
"rating": 123,
"ratings_total": 123,
"date_modified_utc": 123,
"date_modified_at": "<string>",
"scraped_utc": 123,
"scraped_at": "<string>"
}
}Items
Get Item Detail
Full detail for a single eBay listing (price, condition, specifics, shipping, seller, …).
GET
/
v1
/
ebay
/
items
/
{item_id}
Get Item Detail
curl --request GET \
--url https://scrapebadger.com/v1/ebay/items/{item_id} \
--header 'x-api-key: <api-key>'{
"domain": "<string>",
"item": {
"item_id": "<string>",
"product_id": "<string>",
"legacy_item_id": "<string>",
"title": "<string>",
"subtitle": "<string>",
"url": "<string>",
"condition": "<string>",
"condition_id": "<string>",
"condition_description": "<string>",
"price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"original_price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"discount_percent": 123,
"currency": "<string>",
"availability": "<string>",
"quantity_available": 123,
"quantity_sold": 123,
"watchers": 123,
"buying_format": "<string>",
"is_auction": true,
"bids": 123,
"time_left": "<string>",
"best_offer_enabled": true,
"brand": "<string>",
"mpn": "<string>",
"model": "<string>",
"color": "<string>",
"gtin": "<string>",
"main_image": "<string>",
"images": [
{
"url": "<string>",
"width": 123,
"height": 123
}
],
"images_count": 123,
"description": "<string>",
"seller_notes": "<string>",
"item_specifics": {},
"categories": [
"<string>"
],
"category_id": "<string>",
"shipping_options": [
{
"cost": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"is_free": true,
"service": "<string>",
"destination_country": "<string>",
"delivery_estimate": "<string>"
}
],
"shipping_cost": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"free_shipping": true,
"item_location": "<string>",
"ships_to": [
"<string>"
],
"returns": {
"accepted": true,
"period": "<string>",
"cost_paid_by": "<string>",
"raw": "<string>"
},
"seller": {
"username": "<string>",
"url": "<string>",
"feedback_score": 123,
"feedback_percent": 123,
"store_name": "<string>",
"store_url": "<string>"
},
"rating": 123,
"ratings_total": 123,
"date_modified_utc": 123,
"date_modified_at": "<string>",
"scraped_utc": 123,
"scraped_at": "<string>"
}
}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, frResponse
Marketplace domain the item was fetched from.
Full item object.
Show Item object
Show 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).
Time remaining for auctions (nullable).
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
{
"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,
"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"
}
}
Each item-detail request costs 5 credits. Failed requests are not charged.
⌘I