Get Item Detail
curl --request GET \
--url https://scrapebadger.com/v1/ebay/items/{item_id} \
--header 'x-api-key: <api-key>'import requests
url = "https://scrapebadger.com/v1/ebay/items/{item_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/ebay/items/{item_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/ebay/items/{item_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/ebay/items/{item_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/ebay/items/{item_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/ebay/items/{item_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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>",
"current_bid": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"is_ended": false,
"end_time_utc": 123,
"end_time_at": "<string>",
"buy_it_now_price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<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>'import requests
url = "https://scrapebadger.com/v1/ebay/items/{item_id}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://scrapebadger.com/v1/ebay/items/{item_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrapebadger.com/v1/ebay/items/{item_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://scrapebadger.com/v1/ebay/items/{item_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://scrapebadger.com/v1/ebay/items/{item_id}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://scrapebadger.com/v1/ebay/items/{item_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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>",
"current_bid": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<string>"
},
"is_ended": false,
"end_time_utc": 123,
"end_time_at": "<string>",
"buy_it_now_price": {
"value": 123,
"currency": "<string>",
"symbol": "<string>",
"raw": "<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
string
required
The eBay listing item id. You can find this in search results or extract it from a listing URL (
/itm/{item_id}).Query Parameters
string
default:"com"
eBay marketplace domain where the listing lives.Examples:
com, co.uk, de, frResponse
string
Marketplace domain the item was fetched from.
object
Full item object.
Show Item object
Show Item object
string
eBay listing item id.
string
eBay catalog product id (nullable).
string
Legacy item id, if different (nullable).
string
Listing title.
string
Listing subtitle (nullable).
string
Full URL to the listing.
string
Item condition label.
string
eBay numeric condition id (nullable).
string
Seller’s free-text condition note (nullable).
object
Current price with
value, currency, symbol, raw.object
Strikethrough original price (nullable).
number
Discount percentage off original price (nullable).
string
ISO 4217 currency code.
string
Availability/stock message.
integer
Quantity available (nullable).
integer
Quantity sold (nullable).
integer
Number of watchers (nullable).
string
Buy It Now, Auction, or Best Offer.boolean
Whether the listing is an auction.
integer
Number of bids (auctions only, nullable).
string
Relative time remaining for auctions, e.g.
12h 16m (auctions only, nullable).object
Current high bid for auction listings with
value, currency, symbol, raw; mirrors price. Null for non-auction (fixed-price) listings.boolean
true when the listing has closed (sold or ended), any buying format. Defaults to false.number
Listing end time as a Unix timestamp (float seconds): the auction close time, or the exact sold/ended time for ended listings of any format. Null for active fixed-price listings.
string
Listing end time as an ISO-8601 UTC string, e.g.
2026-06-22T19:50:51Z: the auction close time, or the exact sold/ended time for ended listings of any format (nullable).object
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.boolean
Whether the seller accepts best offers (nullable).
string
Brand name (nullable).
string
Manufacturer part number (nullable).
string
Model name (nullable).
string
Color (nullable).
string
GTIN/UPC/EAN (nullable).
string
Primary image URL.
array
All image objects with
url, width, height.integer
Number of images.
string
Listing description text (nullable).
string
Seller notes (nullable).
object
Key-value map of item specifics (e.g.
{"Brand": "Nintendo"}).array
Category breadcrumb path.
string
Primary category id (nullable).
array
Shipping options with
cost, is_free, service, destination_country, delivery_estimate.object
Primary shipping cost (nullable).
boolean
Whether primary shipping is free (nullable).
string
Item location text.
array
List of destinations the seller ships to.
object
Returns policy with
accepted, period, cost_paid_by, raw.object
Seller summary with
username, url, feedback_score, feedback_percent, store_name, store_url.number
Catalog rating, if shown (nullable).
integer
Total ratings, if shown (nullable).
string
ISO 8601 timestamp the listing was last modified (nullable).
string
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,
"bids": null,
"time_left": null,
"current_bid": null,
"is_ended": false,
"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.
For listings that have closed (sold or ended) — any buying format, not just auctions — is_ended is true and end_time_utc / end_time_at carry the exact sold/ended time. For active fixed-price listings all three stay at their defaults (false / null / 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" },
"is_ended": false,
"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.
⌘I

