{"uid":"cap_5G-VANL2JbAO2DaoRwF-J","slug":"agents-openwebninja-com-ebay-products-by-category-7780ebe9","name":"eBay Products by Category","description":"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).","url":"https://agents.openwebninja.com/real-time-ebay-data/products-by-category?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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`, `RAM`, `Screen Size`, `Operating System`, `Material`, `Size`, `Type`, `Features`.\n\n**Limit:** up to 20 aspect entries per request.\n\n**Examples:**\n`[{\"name\":\"Brand\",\"value\":\"Samsung\"}]`\n`[{\"name\":\"Storage Capacity\",\"value\":[\"128 GB\",\"256 GB\"]}]`\n`[{\"name\":\"Brand\",\"value\":\"Samsung\"},{\"name\":\"Color\",\"value\":\"Black\"}]`"},"sort_by":{"enum":["BEST_MATCH","ENDING_SOONEST","NEWLY_LISTED","PRICE_LOWEST","PRICE_HIGHEST"],"type":"string","default":"BEST_MATCH","description":"Sort order for results.\n\n**Default:** `BEST_MATCH`"},"condition":{"type":"string","description":"Filter by item condition. Supports comma-separated values for multiple conditions.\n\n**Allowed values:** `new, used, open_box, refurbished, for_parts`"},"max_price":{"type":"number","description":"Only return products with price less than this value. Specified in the currency of the selected domain."},"min_price":{"type":"number","description":"Only return products with price greater than this value. Specified in the currency of the selected domain."},"show_only":{"type":"string","description":"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`. Note: `sold_items` and `completed_items` work without a cookie, and the optional `cookie` parameter adds seller details to those results."},"category_id":{"type":"string","description":"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).\n\n**Examples:**\n`9355`\n`175672`\n`11450`"},"buying_format":{"enum":["buy_it_now","auction","accepts_offers"],"type":"string","description":"Filter by buying format.\n\n**Allowed values:** `buy_it_now, auction, accepts_offers`"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unprobed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_I8DfDM_aYzRsr0Y5nPKQd","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.openwebninja.com","brandSlug":"agents-openwebninja-com-x402","brandBaseUrl":"https://agents.openwebninja.com","brandDocsUrl":null,"whatItDoes":"Browse and search eBay product listings filtered by category ID, returning up to 60 products per page with pricing, seller, and condition details.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Price comparison for smartphone shopping","prompt":"Search eBay's Cell Phones & Smartphones category (ID 9355) for 'iPhone 15 Pro' on eBay.com and give me the listings with prices, conditions, and seller feedback so I can compare deals."},{"title":"Finding used clothing deals by category","prompt":"Browse eBay's Clothing category (ID 11450) for 'vintage levi jeans' — filter to used condition on the US marketplace and show me up to 60 results from page 1 with prices and shipping info."},{"title":"Monitoring electronics inventory on eBay UK","prompt":"Search eBay UK (domain co.uk) in the Laptops & Netbooks category (ID 175672) for 'refurbished MacBook Air' and return the first page of results with prices in GBP and seller ratings."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:35:08.797Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-ebay-products-by-category-7780ebe9"}