Search Listings

curl --request GET \
  --url https://scrapebadger.com/v1/ebay/search \
  --header 'x-api-key: <api-key>'

{
  "query": "<string>",
  "domain": "<string>",
  "category_id": "<string>",
  "sold": true,
  "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
    }
  ],
  "facets": {},
  "pagination": {
    "current_page": 123,
    "per_page": 123,
    "total_pages": 123,
    "total_results": 123
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

GET

ebay

Search Listings

curl --request GET \
  --url https://scrapebadger.com/v1/ebay/search \
  --header 'x-api-key: <api-key>'

{
  "query": "<string>",
  "domain": "<string>",
  "category_id": "<string>",
  "sold": true,
  "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
    }
  ],
  "facets": {},
  "pagination": {
    "current_page": 123,
    "per_page": 123,
    "total_pages": 123,
    "total_results": 123
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

Query Parameters

query

string

required

Search keywords. Matches against listing titles.

domain

string

default:"com"

eBay marketplace domain TLD or alias. See /v1/ebay/markets for all supported values.Examples: com, co.uk, de, fr, com.au

category_id

string

Restrict results to an eBay category id. Use /v1/ebay/categories to look up ids.

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.

sort_by

string

default:"best_match"

Sort order for results.

Value	Description
`best_match`	Best match (default)
`ending_soonest`	Auctions ending soonest first
`newly_listed`	Most recently listed
`price_low_to_high`	Cheapest first (incl. shipping)
`price_high_to_low`	Most expensive first (incl. shipping)

condition

string

Item condition filter.

Value	Description
`new`	Brand new
`open_box`	New (other) / open box
`refurbished`	Refurbished (any grade)
`used`	Pre-owned
`for_parts`	For parts or not working

buying_format

string

Buying format filter.

Value	Description
`auction`	Auction listings
`buy_it_now`	Fixed-price listings
`best_offer`	Listings accepting best offers

min_price

number

Minimum price filter in the marketplace’s local currency.

max_price

number

Maximum price filter in the marketplace’s local currency.

free_shipping

boolean

default:false

Only return listings with free shipping.

Response

query

string

The search query that was executed.

domain

string

Marketplace domain that was searched.

category_id

string

The category id filter applied (nullable).

sold

boolean

Always false for active-listing search (see /completed for sold).

results

array

Array of matching listings.

Show SearchResult object

position

integer

Position on the page (1-based).

item_id

string

eBay listing item id.

product_id

string

eBay catalog product id, if part of the catalog (nullable).

title

string

Listing title.

url

string

Full URL to the listing.

image

string

Primary image URL.

price

object

Price object with value, currency, symbol, raw.

original_price

object

Strikethrough original price (nullable).

discount_percent

number

Discount percentage off the original price (nullable).

condition

string

Item condition label.

brand

string

Brand name (nullable).

buying_format

string

Buy It Now, Auction, or Best Offer.

is_auction

boolean

Whether the listing is an auction.

bids

integer

Number of bids (auctions only, nullable).

time_left

string

Time remaining for auctions (nullable).

shipping

string

Raw shipping text.

shipping_cost

object

Parsed shipping cost (nullable).

free_shipping

boolean

Whether shipping is free (nullable).

location

string

Item location text.

returns

string

Returns text (nullable).

sold_count

integer

Number sold (nullable).

watchers

integer

Number of watchers (nullable).

coupon

string

Coupon/promo text (nullable).

rating

number

Average catalog rating, if shown (nullable).

ratings_total

integer

Total ratings, if shown (nullable).

seller_name

string

Seller username (nullable).

seller_feedback_percent

number

Seller positive-feedback percent (nullable).

seller_feedback_score

integer

Seller feedback score (nullable).

program_badge

string

Program badge, e.g. eBay Refurbished (nullable).

is_sponsored

boolean

Whether the result is a sponsored placement.

facets

object

Available filter facets keyed by name, each a list of string values.

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

{
  "query": "nintendo switch oled",
  "domain": "com",
  "category_id": null,
  "sold": false,
  "results": [
    {
      "position": 1,
      "item_id": "256123456789",
      "product_id": "20057872541",
      "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" },
      "original_price": { "value": 349.99, "currency": "USD", "symbol": "$", "raw": "$349.99" },
      "discount_percent": 14.0,
      "condition": "Brand New",
      "brand": "Nintendo",
      "buying_format": "Buy It Now",
      "is_auction": false,
      "bids": null,
      "time_left": null,
      "shipping": "Free shipping",
      "free_shipping": true,
      "location": "United States",
      "sold_count": 42,
      "watchers": 18,
      "seller_name": "topgames_us",
      "seller_feedback_percent": 99.4,
      "seller_feedback_score": 18452,
      "is_sponsored": false
    }
  ],
  "facets": { "condition": ["New", "Used"], "buying_format": ["Buy It Now", "Auction"] },
  "pagination": { "current_page": 1, "per_page": 60, "total_pages": 100, "total_results": 6000 },
  "scraped_at": "2026-06-21T12:00:00Z"
}

Each search request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key

string

header

required

Query Parameters

query

string

required

Search keywords.

domain

string

default:com

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

category_id

string

Restrict results to a category id.

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

sort_by

enum<string>

default:best_match

Sort order for results.

Available options:

best_match,

ending_soonest,

newly_listed,

price_low_to_high,

price_high_to_low

condition

enum<string>

Item condition filter.

Available options:

new,

open_box,

refurbished,

used,

for_parts

buying_format

enum<string>

Buying format filter.

Available options:

auction,

buy_it_now,

best_offer

min_price

number

Minimum price filter in the marketplace's local currency.

Required range: x >= 0

max_price

number

Maximum price filter in the marketplace's local currency.

Required range: x >= 0

free_shipping

boolean

default:false

Only return listings with free shipping.

Response

200 - application/json

Active listings

query

string | null

domain

string

category_id

string | null

sold

boolean

results

object[]

Show child attributes

facets

object

Show child attributes

pagination

object

Show child attributes

scraped_utc

number | null

scraped_at

string | null

eBay Scraper Overview Completed / Sold Listings

​Query Parameters

​Response

​Example Response

Authorizations

Query Parameters

Response

Query Parameters

Response

Example Response