Get Seller Listings

curl --request GET \
  --url https://scrapebadger.com/v1/ebay/sellers/{username}/items \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://scrapebadger.com/v1/ebay/sellers/{username}/items', 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/sellers/{username}/items",
  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/sellers/{username}/items"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/ebay/sellers/{username}/items")

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>",
  "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>",
      "current_bid": {
        "value": 123,
        "currency": "<string>",
        "symbol": "<string>",
        "raw": "<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,
    "has_more": true
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

GET

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>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://scrapebadger.com/v1/ebay/sellers/{username}/items', 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/sellers/{username}/items",
  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/sellers/{username}/items"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://scrapebadger.com/v1/ebay/sellers/{username}/items")

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>",
  "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>",
      "current_bid": {
        "value": 123,
        "currency": "<string>",
        "symbol": "<string>",
        "raw": "<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,
    "has_more": true
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

Path Parameters

string

required

The eBay seller username whose storefront listings you want.

Query Parameters

string

default:"com"

eBay marketplace domain to resolve the seller on.Examples: com, co.uk, de, fr

string

Optional keyword filter within the seller’s store.

integer

default:1

Page number for paginated results. Range: 1 - 100.

integer

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

Response

string

Marketplace domain that was searched.

string

The seller whose listings were returned.

array

Array of the seller’s active listings (same SearchResult shape as search).

Show SearchResult object

integer

Position on the page (1-based).

string

eBay listing item id.

string

Listing title.

string

Full URL to the listing.

string

Primary image URL.

object

Price object with value, currency, symbol, raw.

string

Item condition label.

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, 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.

string

Shipping text.

integer

Number of watchers (nullable).

boolean

Always null. eBay renders its “Sponsored” badge into every card as anti-scraping bait, so promoted placements cannot be distinguished from organic results.

object

Pagination metadata with current_page, per_page, total_pages, total_results.

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": null
    }
  ],
  "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[]

Show child attributes

pagination

object

Show child attributes

scraped_utc

number | null

scraped_at

string | null

Overview

Search

Items

Sellers

Categories

Reference

Get Seller Listings

Path Parameters

Query Parameters

Response

Example Response

Authorizations

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

​Example Response

Authorizations

Path Parameters

Query Parameters

Response

Path Parameters

Query Parameters

Response

Example Response