Search Listings

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

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

fetch('https://scrapebadger.com/v1/ebay/search', 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/search",
  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/search"

	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/search")

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

{
  "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>",
      "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,
      "sold_date": "<string>",
      "sold_date_at": "<string>",
      "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,
    "has_more": true
  },
  "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>'

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

fetch('https://scrapebadger.com/v1/ebay/search', 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/search",
  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/search"

	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/search")

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

{
  "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>",
      "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,
      "sold_date": "<string>",
      "sold_date_at": "<string>",
      "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,
    "has_more": true
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

Query Parameters

string

required

Search keywords. Matches against listing titles.

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

string

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

integer

default:1

Page number for paginated results. Range: 1 - 1000.Use pagination.has_more to know when to stop — eBay re-serves its last page if you ask past the end, so this API returns an empty page there.

integer

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

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)

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

string

Buying format filter.

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

number

Minimum price filter in the marketplace’s local currency.

number

Maximum price filter in the marketplace’s local currency.

boolean

default:false

Only return listings with free shipping.

Response

string

The search query that was executed.

string

Marketplace domain that was searched.

string

The category id filter applied (nullable).

boolean

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

array

Array of matching listings.

Show SearchResult object

integer

Position on the page (1-based).

string

eBay listing item id.

string

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

string

Listing title.

string

Full URL to the listing.

string

Primary image URL.

object

Price object with value, currency, symbol, raw.

object

Strikethrough original price (nullable).

number

Discount percentage off the original price (nullable).

string

Item condition label.

string

Brand name (nullable).

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 for auctions, 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

Raw shipping text.

object

Parsed shipping cost (nullable).

boolean

Whether shipping is free (nullable).

string

Item location text.

string

Returns text (nullable).

integer

Number sold (nullable).

string

Sale date text as rendered by eBay, e.g. 2 Jul 2026 (completed/sold cards only; localized on non-English marketplaces, nullable).

string

Best-effort ISO date parsed from sold_date, e.g. 2026-07-02 (null when the marketplace’s date format is not English).

integer

Number of watchers (nullable).

string

Coupon/promo text (nullable).

number

Average catalog rating, if shown (nullable).

integer

Total ratings, if shown (nullable).

string

Seller username (nullable).

number

Seller positive-feedback percent (nullable).

integer

Seller feedback score (nullable).

string

Program badge, e.g. eBay Refurbished (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

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

object

Pagination metadata with current_page, per_page, total_pages, total_results.

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,
      "current_bid": 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": null
    },
    {
      "position": 2,
      "item_id": "256987654321",
      "title": "Nintendo Switch OLED Console - No Reserve Auction",
      "url": "https://www.ebay.com/itm/256987654321",
      "image": "https://i.ebayimg.com/images/g/def/s-l500.jpg",
      "price": { "value": 212.5, "currency": "USD", "symbol": "$", "raw": "$212.50" },
      "condition": "Used",
      "buying_format": "Auction",
      "is_auction": true,
      "bids": 17,
      "time_left": "12h 16m",
      "current_bid": { "value": 212.5, "currency": "USD", "symbol": "$", "raw": "$212.50" },
      "shipping": "Free shipping",
      "free_shipping": true,
      "location": "United States",
      "seller_name": "retro_deals",
      "is_sponsored": null
    }
  ],
  "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 <= 1000

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

Overview

Search

Items

Sellers

Categories

Reference

Search Listings

Query Parameters

Response

Example Response

Authorizations

Query Parameters

Response

​Query Parameters

​Response

​Example Response

Authorizations

Query Parameters

Response

Query Parameters

Response

Example Response