Skip to main content
GET
/
v1
/
ebay
/
categories
/
{category_id}
/
items
Browse a Category
curl --request GET \
  --url https://scrapebadger.com/v1/ebay/categories/{category_id}/items \
  --header 'x-api-key: <api-key>'
{
  "domain": "<string>",
  "category_id": "<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
    }
  ],
  "facets": {},
  "pagination": {
    "current_page": 123,
    "per_page": 123,
    "total_pages": 123,
    "total_results": 123
  },
  "scraped_utc": 123,
  "scraped_at": "<string>"
}

​
Path Parameters

​
category_id
string
required
The eBay category id to browse. Use /v1/ebay/categories to look up ids.

​
Query Parameters

​
domain
string
default:"com"
eBay marketplace domain to browse.Examples: com, co.uk, de, fr
​
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.
ValueDescription
best_matchBest match (default)
ending_soonestAuctions ending soonest first
newly_listedMost recently listed
price_low_to_highCheapest first
price_high_to_lowMost expensive first
​
min_price
number
Minimum price filter in the marketplace’s local currency.
​
max_price
number
Maximum price filter in the marketplace’s local currency.

​
Response

​
domain
string
Marketplace domain that was browsed.
​
category_id
string
The category id that was browsed.
​
results
array
Array of listings in the category (same SearchResult shape as search).
​
facets
object
Available filter facets keyed by name.
​
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",
  "category_id": "139971",
  "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",
      "seller_name": "topgames_us",
      "is_sponsored": false
    }
  ],
  "facets": { "condition": ["New", "Used"] },
  "pagination": { "current_page": 1, "per_page": 60, "total_pages": 100, "total_results": 6000 },
  "scraped_at": "2026-06-21T12:00:00Z"
}
Each category-browse request costs 5 credits. Failed requests are not charged.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
category_id
string
required

The eBay category id.

Query Parameters

​
domain
string
default:com

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

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

Response

200 - application/json

Category listings

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