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
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).
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.true when the listing has closed (sold or ended), any buying format. Defaults to false.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.
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).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
{
"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

