# Real-Time eBay Data - eBay Products, Categories & Seller Data

> Fast, reliable, and extensive eBay data API - search products, list products by category, get seller feedback and product reviews, and more from 20 eBay domains worldwide in real-time.

## Overview

Real-Time eBay Data is a fast, reliable, and extensive API for eBay product and seller data across 20 eBay domains worldwide in real-time. It returns products, categories, and seller feedback as structured JSON via REST.

Who is this API for: developers building price tracking, product research, reselling, and e-commerce intelligence tools.

What it returns: product search, products by category, product details, and seller feedback / reviews from eBay.

Need help integrating? Contact support@openwebninja.com.
For high volume / large scale plans, please contact support@openwebninja.com.

## Endpoints

### GET /search - Product Search
Search eBay products by keyword.
Parameters:
- **query** (string, required): Search keywords. **Examples:** `iphone 15 pro max` `nintendo switch oled` `vintage rolex submariner`
- page (integer, default: `1`): Page number to return (each page includes up to 60 results). **Allowed values:** `1-100`
- domain (string, default: `com`): eBay domain to search. Sets the marketplace country, language, and currency. **Default:** `com` **Allowed values:** `com, co.uk, com.au, de, ca, fr, it, es, at, ch, com.sg, com.my, ph, ie, pl, nl, be, com.hk, com.mx, com.br`
- sort_by (string, default: `BEST_MATCH`, allowed: BEST_MATCH | ENDING_SOONEST | NEWLY_LISTED | PRICE_LOWEST | PRICE_HIGHEST): Sort order for results. **Default:** `BEST_MATCH`
- condition (string): Filter by item condition. Supports comma-separated values for multiple conditions. **Allowed values:** `new, used, open_box, refurbished, for_parts` **Examples:** `new` `used,refurbished`
- buying_format (string, allowed: buy_it_now | auction | accepts_offers): Filter by buying format. **Allowed values:** `buy_it_now, auction, accepts_offers`
- show_only (string): Filter results by one or more listing attributes. Accepts a comma-separated list of values like `free_returns`, `deals_and_savings`, `returns_accepted`, `authorized_seller`, `sold_items`, `completed_items`, `free_shipping`, `local_pickup`. Example: `sold_items,completed_items`.
- min_price (number): Only return products with price greater than this value. Specified in the currency of the selected domain.
- max_price (number): Only return products with price less than this value. Specified in the currency of the selected domain.
- aspects (string): Filter by category-specific item aspects from eBay's left-side filter panel (Brand, Model, Storage Capacity, Network, Color, etc.). Pass a JSON-encoded array of `{name, value}` objects. `value` can be a single string or an array of strings (multiple values are OR-joined within the same aspect). Aspect names must match eBay's filter labels exactly. Available aspect names depend on the item category. Common examples include: `Brand`, `Model`, `Storage Capacity`, `Network`, `Lock Status`, `Color`, `RAM`, `Screen Size`, `Operating System`, `Material`, `Size`, `Type`, `Features`. **Limit:** up to 20 aspect entries per request. **Examples:** `[{"name":"Brand","value":"Apple"}]` `[{"name":"Storage Capacity","value":["128 GB","256 GB"]}]` `[{"name":"Model","value":"Samsung Galaxy A02s"},{"name":"Network","value":"Unlocked"}]`
Full URL: `https://api.openwebninja.com/real-time-ebay-data/search`

### GET /products-by-category - Products by Category
Browse eBay products within a specific category.
Parameters:
- **category_id** (string, required): eBay category ID. You can find category IDs in eBay URLs (e.g., `9355` for Cell Phones & Smartphones, `175672` for Laptops & Netbooks, `11450` for Clothing). **Examples:** `9355` `175672` `11450`
- query (string): Search keywords within the category. Highly recommended for reliable results — without a query, eBay returns a browse page with limited server-rendered data. **Examples:** `samsung galaxy` `gaming laptop`
- page (integer, default: `1`): Page number to return (each page includes up to 60 results). **Allowed values:** `1-100`
- domain (string, default: `com`): eBay domain to search. Sets the marketplace country, language, and currency. **Default:** `com` **Allowed values:** `com, co.uk, com.au, de, ca, fr, it, es, at, ch, com.sg, com.my, ph, ie, pl, nl, be, com.hk, com.mx, com.br`
- sort_by (string, default: `BEST_MATCH`, allowed: BEST_MATCH | ENDING_SOONEST | NEWLY_LISTED | PRICE_LOWEST | PRICE_HIGHEST): Sort order for results. **Default:** `BEST_MATCH`
- condition (string): Filter by item condition. Supports comma-separated values for multiple conditions. **Allowed values:** `new, used, open_box, refurbished, for_parts`
- buying_format (string, allowed: buy_it_now | auction | accepts_offers): Filter by buying format. **Allowed values:** `buy_it_now, auction, accepts_offers`
- show_only (string): Filter results by one or more listing attributes. Accepts a comma-separated list of values like `free_returns`, `deals_and_savings`, `returns_accepted`, `authorized_seller`, `sold_items`, `completed_items`, `free_shipping`, `local_pickup`. Example: `sold_items,completed_items`.
- min_price (number): Only return products with price greater than this value. Specified in the currency of the selected domain.
- max_price (number): Only return products with price less than this value. Specified in the currency of the selected domain.
- aspects (string): Filter by category-specific item aspects from eBay's left-side filter panel (Brand, Model, Storage Capacity, Network, Color, etc.). Pass a JSON-encoded array of `{name, value}` objects. `value` can be a single string or an array of strings (multiple values are OR-joined within the same aspect). Aspect names must match eBay's filter labels exactly. Aspects are scoped to the `category_id` you pass. The category determines which aspects are available. Common examples include: `Brand`, `Model`, `Storage Capacity`, `Network`, `Lock Status`, `Color`, `RAM`, `Screen Size`, `Operating System`, `Material`, `Size`, `Type`, `Features`. **Limit:** up to 20 aspect entries per request. **Examples:** `[{"name":"Brand","value":"Samsung"}]` `[{"name":"Storage Capacity","value":["128 GB","256 GB"]}]` `[{"name":"Brand","value":"Samsung"},{"name":"Color","value":"Black"}]`
Full URL: `https://api.openwebninja.com/real-time-ebay-data/products-by-category`

### GET /product-details - Product Details
Get comprehensive details for a single eBay listing including title, price, images, condition, seller information, seller ratings, item specifics, shipping, return policy, and breadcrumb navigation.
Parameters:
- **product_id** (string, required): eBay item ID (numeric). Found in eBay listing URLs after `/itm/`. **Examples:** `287062440001` `266583210044`
- domain (string, default: `com`): eBay domain to fetch from. Sets the marketplace country, language, and currency. **Default:** `com` **Allowed values:** `com, co.uk, com.au, de, ca, fr, it, es, at, ch, com.sg, com.my, ph, ie, pl, nl, be, com.hk, com.mx, com.br`
Full URL: `https://api.openwebninja.com/real-time-ebay-data/product-details`

### GET /seller-feedback - Seller Feedback
Get seller feedback and reviews for an eBay seller.
Parameters:
- **seller_id** (string, required): eBay seller username. **Examples:** `wirelesssource` `thrift.books` `musicmagpie`
- product_id (string): eBay item ID to filter feedback for a specific product. Optional — if omitted, returns all feedback for the seller. **Examples:** `287062440001`
- page (integer, default: `1`): Page number to return (each page includes up to 25 reviews). **Allowed values:** `1-100`
- domain (string, default: `com`): eBay domain to fetch from. Sets the marketplace country and language. **Default:** `com` **Allowed values:** `com, co.uk, com.au, de, ca, fr, it, es, at, ch, com.sg, com.my, ph, ie, pl, nl, be, com.hk, com.mx, com.br`
Full URL: `https://api.openwebninja.com/real-time-ebay-data/seller-feedback`

## Base URL and Authentication

- Base URL: `https://api.openwebninja.com/real-time-ebay-data`
- Auth: API key in the `x-api-key` header. Get a key by subscribing (free tier available) at https://app.openwebninja.com/api/realtime-ebay-data

## Topics

ebay api, ebay data api, product data api, price tracking api, ecommerce data api, product search api, seller feedback api, reselling api, ebay scraper api

## Links

- API page: https://www.openwebninja.com/api/real-time-ebay-data
- Get an API key / subscribe: https://app.openwebninja.com/api/realtime-ebay-data
- Pricing & plans: https://app.openwebninja.com/api/realtime-ebay-data/pricing
- Website: https://www.openwebninja.com
- OpenAPI spec: https://openwebninja.s3.us-east-1.amazonaws.com/portal/openapi/realtime_ebay_data.yaml
- Support: support@openwebninja.com

_Last updated: 2026-05-27_