> ## 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 Seller Listings
> List the active listings of a single eBay seller.
## Path Parameters
The eBay seller username whose storefront listings you want.
## Query Parameters
eBay marketplace domain to resolve the seller on.
Examples: `com`, `co.uk`, `de`, `fr`
Optional keyword filter within the seller's store.
Page number for paginated results. Range: `1` - `100`.
Results per page. Clamped to one of `60`, `120`, or `240`.
## Response
Marketplace domain that was searched.
The seller whose listings were returned.
Array of the seller's active listings (same `SearchResult` shape as [search](/api-reference/endpoint/ebay/search)).
Position on the page (1-based).
eBay listing item id.
Listing title.
Full URL to the listing.
Primary image URL.
Price object with `value`, `currency`, `symbol`, `raw`.
Item condition label.
`Buy It Now`, `Auction`, or `Best Offer`.
Whether the listing is an auction.
Number of bids (auctions only, nullable).
Relative time remaining, 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.
Shipping text.
Number of watchers (nullable).
Whether the result is a sponsored placement.
Pagination metadata with `current_page`, `per_page`, `total_pages`, `total_results`.
ISO 8601 timestamp when the results were scraped.
### Example Response
```json theme={null}
{
"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.
## OpenAPI
````yaml GET /v1/ebay/sellers/{username}/items
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/sellers/{username}/items:
get:
tags:
- eBay Sellers
summary: Get Seller Listings
description: List the active listings of a single eBay seller.
operationId: getEbaySellerItems
parameters:
- name: username
in: path
required: true
schema:
type: string
description: The eBay seller username.
- name: domain
in: query
schema:
type: string
default: com
description: eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...).
- name: query
in: query
schema:
type: string
description: Optional keyword filter within the seller's store.
- name: page
in: query
schema:
type: integer
default: 1
minimum: 1
maximum: 100
description: Page number for paginated results.
- name: per_page
in: query
schema:
type: integer
minimum: 1
maximum: 240
description: Results per page. Clamped to 60, 120 or 240.
responses:
'200':
description: Seller listings
content:
application/json:
schema:
type: object
properties:
domain:
type: string
username:
type: string
results:
type: array
items:
type: object
properties:
position:
type: integer
item_id:
type:
- string
- 'null'
product_id:
type:
- string
- 'null'
title:
type:
- string
- 'null'
url:
type:
- string
- 'null'
image:
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'
condition:
type:
- string
- 'null'
brand:
type:
- string
- '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'
shipping:
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'
location:
type:
- string
- 'null'
returns:
type:
- string
- 'null'
sold_count:
type:
- integer
- 'null'
watchers:
type:
- integer
- 'null'
coupon:
type:
- string
- 'null'
rating:
type:
- number
- 'null'
ratings_total:
type:
- integer
- 'null'
seller_name:
type:
- string
- 'null'
seller_feedback_percent:
type:
- number
- 'null'
seller_feedback_score:
type:
- integer
- 'null'
program_badge:
type:
- string
- 'null'
is_sponsored:
type: boolean
pagination:
type: object
properties:
current_page:
type: integer
per_page:
type:
- integer
- 'null'
total_pages:
type:
- integer
- 'null'
total_results:
type:
- integer
- 'null'
scraped_utc:
type:
- number
- 'null'
scraped_at:
type:
- string
- 'null'
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
````