# eBay Product Search > eBay Product Search 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). Search eBay listings by keyword and return up to 60 products per page with pricing, seller info, shipping details, and condition filters. ## Facts - Endpoint: GET https://agents.openwebninja.com/real-time-ebay-data/search?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-product-search-f8e47c8b - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0b2BS2-jNYxgx_gwz2Xyb 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-product-search-f8e47c8b ``` Example prompt: Search eBay for used Nintendo Switch OLED consoles under $250 in good condition, sorted by lowest price first, and show me the first page of results from the US marketplace. ## When to prefer this Use this endpoint when you need real-time eBay product search results with rich listing metadata including seller reputation, pricing, shipping, and condition. Prefer this over Amazon or Walmart search endpoints when the user specifically wants eBay marketplace data, auction listings, or wants to research sold/completed prices for secondhand goods. It supports 20+ international eBay domains, making it ideal for cross-market price comparisons. ## Known failure modes - Missing required 'query' parameter returns a 400 validation error - Invalid domain value returns an error; only supported eBay marketplace codes are accepted - Requesting sold/completed listings without a valid eBay session cookie may return incomplete seller data (seller_name, seller_feedback_count, seller_feedback_percentage will be null) - Expired or wrong-marketplace eBay cookie returns a 503 error prompting cookie replacement - Page number outside 1-100 range is rejected - No results found for very specific or misspelled queries returns an empty products array - Rate limiting or quota exhaustion may return a 402 or 429 response ## How this service works Search eBay products by keyword. Returns up to 60 products per page with pricing, seller info, shipping details, and more. Supports filters for condition, buying format, price range, and sort order. ## Output Returns a paginated list of up to 60 eBay product listings per page, each including title, item URL, image URL, current price, original price, discount, currency, condition, buying format, shipping info, seller name, seller feedback count and percentage, top-rated seller flag, free returns flag, sponsored flag, watchers, bid count, time left (for auctions), items sold, review count, item location, and item ID. Also includes total result count, current page, results per page, and a list of related search queries with URLs. ## Request schema (JSON Schema) ```json { "type": "object", "required": [ "query" ], "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.\n\n**Examples:**\n`iphone 15 pro max`\n`nintendo switch oled`\n`vintage rolex submariner`" }, "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. 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`.\n\n**Limit:** up to 20 aspect entries per request.\n\n**Examples:**\n`[{\"name … (truncated) ``` ## Response schema (JSON Schema) ```json { "type": "object", "properties": { "data": { "type": "object", "properties": { "products": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "image": { "type": "string" }, "price": { "type": "number" }, "title": { "type": "string" }, "rating": { "type": "number" }, "item_id": { "type": "string" }, "currency": { "type": "string" }, "discount": { "type": "string" }, "location": { "type": "string" }, "position": { "type": "integer" }, "shipping": { "type": "string" }, "watchers": {}, "bid_count": {}, "condition": { "type": "string" }, "time_left": {}, "items_sold": { "type": "integer" }, "seller_name": { "type": "string" }, "free_returns": { "type": "boolean" }, "is_sponsored": { "type": "boolean" }, "review_count": { "type": "integer" }, "buying_format": { "type": "string" }, "original_price": { "type": "number" }, "seller_top_rated": { "type": "boolean" }, "seller_feedback_count": { "type": "integer" }, "seller_feedback_percentage": { "type": "number" } } } }, "current_page": { "type": "integer" }, "total_results": { "type": "integer" }, "related_searches": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "query": { "type": "string" } } } }, "results_per_page": { "type": "integer" } } }, "status": { "type": "string" }, "parameters": { "type": "object", "properties": { "page": { "type": "integer" }, "query": { "type": "string" }, "domain": { "type": "string" }, "sort_by": { "type": "string" } } }, "request_id": { "type": "string" } } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-ebay-product-search-f8e47c8b/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)