Skip to main content
GET
/
v1
/
ebay
/
sellers
/
{username}
/
items
Get Seller Listings
curl --request GET \
  --url https://scrapebadger.com/v1/ebay/sellers/{username}/items \
  --header 'x-api-key: <api-key>'
{
  "domain": "<string>",
  "username": "<string>",
  "results": [
    {
      "position": 123,
      "item_id": "<string>",
      "product_id": "<string>",
      "title": "<string>",
      "url": "<string>",
      "image": "<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>",
      "condition": "<string>",
      "brand": "<string>",
      "buying_format": "<string>",
      "is_auction": true,
      "bids": 123,
      "time_left": "<string>",
      "shipping": "<string>",
      "shipping_cost": {
        "value": 123,
        "currency": "<string>",
        "symbol": "<string>",
        "raw": "<string>"
      },
      "free_shipping": true,
      "location": "<string>",
      "returns": "<string>",
      "sold_count": 123,
      "watchers": 123,
      "coupon": "<string>",
      "rating": 123,
      "ratings_total": 123,
      "seller_name": "<string>",
      "seller_feedback_percent": 123,
      "seller_feedback_score": 123,
      "program_badge": "<string>",
      "is_sponsored": true
    }
  ],
  "pagination": {
    "current_page": 123,
    "per_page": 123,
    "total_pages": 123,
    "total_results": 123
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

​
Path Parameters

​
username
string
required
The eBay seller username whose storefront listings you want.

​
Query Parameters

​
domain
string
default:"com"
eBay marketplace domain to resolve the seller on.Examples: com, co.uk, de, fr
​
query
string
Optional keyword filter within the seller’s store.
​
page
integer
default:1
Page number for paginated results. Range: 1 - 100.
​
per_page
integer
Results per page. Clamped to one of 60, 120, or 240.

​
Response

​
domain
string
Marketplace domain that was searched.
​
username
string
The seller whose listings were returned.
​
results
array
Array of the seller’s active listings (same SearchResult shape as search).
​
pagination
object
Pagination metadata with current_page, per_page, total_pages, total_results.
​
scraped_at
string
ISO 8601 timestamp when the results were scraped.

​
Example Response

{
  "domain": "com",
  "username": "topgames_us",
  "results": [
    {
      "position": 1,
      "item_id": "256123456789",
      "title": "Nintendo Switch OLED Model White Console - Brand New Sealed",
      "url": "https://www.ebay.com/itm/256123456789",
      "image": "https://i.ebayimg.com/images/g/abc/s-l500.jpg",
      "price": { "value": 299.99, "currency": "USD", "symbol": "$", "raw": "$299.99" },
      "condition": "Brand New",
      "buying_format": "Buy It Now",
      "is_auction": false,
      "shipping": "Free shipping",
      "watchers": 18,
      "is_sponsored": false
    }
  ],
  "pagination": { "current_page": 1, "per_page": 60, "total_pages": 23, "total_results": 1342 },
  "scraped_at": "2026-06-21T12:00:00Z"
}
Each seller-listings request costs 5 credits. Failed requests are not charged.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
username
string
required

The eBay seller username.

Query Parameters

​
domain
string
default:com

eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...).

​
query
string

Optional keyword filter within the seller's store.

​
page
integer
default:1

Page number for paginated results.

Required range: 1 <= x <= 100
​
per_page
integer

Results per page. Clamped to 60, 120 or 240.

Required range: 1 <= x <= 240

Response

200 - application/json

Seller listings

​
domain
string
​
username
string
​
results
object[]
​
pagination
object
​
scraped_utc
number | null
​
scraped_at
string | null