# eBay Products by Category > eBay Products by Category is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14). Browse and search eBay product listings filtered by category ID, returning up to 60 products per page with pricing, seller, and condition details. ## Facts - Endpoint: GET https://agents.openwebninja.com/real-time-ebay-data/products-by-category?utm_source=zero.xyz - Price: price unknown - Payment: MPP - Status: unknown - Last checked: 2026-10-14 - Activations on Zero: 0 - Provider: agents.openwebninja.com - Website: https://agents.openwebninja.com - Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-ebay-products-by-category-7780ebe9 - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5G-VANL2JbAO2DaoRwF-J Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently. ## How to call it through Zero Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`): ```sh zero fetch --capability agents-openwebninja-com-ebay-products-by-category-7780ebe9 ``` Example prompt: Can you search eBay's Laptops & Netbooks category (category ID 175672) for 'gaming laptop' on the US marketplace and show me the first page of results including prices, conditions, and seller ratings? ## When to prefer this Use this endpoint when you need to search or browse eBay product listings scoped to a specific category rather than site-wide. It is ideal for product discovery, price comparison, and inventory research within a known eBay category. Prefer this over a general eBay search endpoint when you want to filter results by category ID, condition, buying format, or item-specific aspects (Brand, Model, Color, etc.). Best results require pairing a category_id with a query keyword. ## Known failure modes - Missing category_id returns a validation error (required parameter) - No query parameter leads to JavaScript-rendered eBay browse page with only 0-24 results instead of full 60 - Invalid or expired eBay session cookie for sold/completed listings returns 503 error prompting cookie replacement - Cookie belonging to wrong marketplace domain returns 503 - Category ID that does not exist on the specified domain may return empty results - Page number out of 1-100 range returns validation error - Unsupported domain value returns validation error ## How this service works Browse eBay products within a specific category. Works best with a `query` parameter — without it, eBay serves a JavaScript-rendered browse page and results may be limited (0-24 products). With `query`, returns full search results filtered by category (up to 60 products per page). ## Output Returns a JSON object containing an array of up to 60 product listings per page, each with title, price, currency, condition, buying format, seller name, seller feedback count and percentage, seller top-rated status, shipping info, location, image URL, product URL, item ID, discount, and original price. Also includes category name, subcategories, related categories, brand list, total results count, current page, and results per page. ## Request schema (JSON Schema) ```json { "type": "object", "required": [ "category_id" ], "properties": { "page": { "type": "integer", "default": 1, "maximum": 100, "minimum": 1, "description": "Page number to return (each page includes up to 60 results).\n\n**Allowed values:** `1-100`" }, "query": { "type": "string", "description": "Search keywords within the category. Highly recommended for reliable results — without a query, eBay returns a browse page with limited server-rendered data.\n\n**Examples:**\n`samsung galaxy`\n`gaming laptop`" }, "cookie": { "type": "string", "description": "Optional. Only used for **sold** and **completed** listings (`show_only=sold_items` / `completed_items`), ignored everywhere else.\n\nSold and completed listings are returned **without** a cookie: 60 results per page with the sale price, currency, sale date (`caption`), condition, shipping, location and images. On those results `seller_name`, `seller_feedback_count` and `seller_feedback_percentage` are `null` unless you pass your own eBay session cookie, which populates them on every result.\n\nPaste the cookie header from a browser signed in to eBay, e.g. `name=value; name2=value2`. It must belong to the same marketplace as `domain`. If it stops working, because it expired, was signed out elsewhere, or belongs to another marketplace, the request returns 503 telling you to replace it rather than silently falling back. It is never logged or returned in the response.\n\nMore details: https://www.openwebninja.com/blog/how-to-get-ebay-sold-and-completed-listings" }, "domain": { "type": "string", "default": "com", "description": "eBay domain to search. Sets the marketplace country, language, and currency.\n\n**Default:** `com`\n\n**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`" }, "aspects": { "type": "string", "description": "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).\n\nAspect 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`, … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "brands": { "type": "array", "items": { "type": "string" } }, "products": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "image": { "type": "string" }, "price": { "type": "number" }, "title": { "type": "string" }, "item_id": { "type": "string" }, "currency": { "type": "string" }, "discount": {}, "location": { "type": "string" }, "position": { "type": "integer" }, "shipping": { "type": "string" }, "condition": { "type": "string" }, "seller_name": { "type": "string" }, "free_returns": { "type": "boolean" }, "buying_format": { "type": "string" }, "original_price": {}, "seller_top_rated": { "type": "boolean" }, "seller_feedback_count": { "type": "integer" }, "seller_feedback_percentage": { "type": "number" } } } }, "current_page": { "type": "integer" }, "category_name": { "type": "string" }, "subcategories": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "name": { "type": "string" } } } }, "total_results": { "type": "integer" }, "results_per_page": { "type": "integer" }, "related_categories": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "name": { "type": "string" } } } } } }, "status": { "type": "string" }, "parameters": { "type": "object", "properties": { "page": { "type": "integer" }, "query": { "type": "string" }, "domain": { "type": "string" }, "category_id": { "type": "string" } } }, "request_id": { "type": "string" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-ebay-products-by-category-7780ebe9/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)