{"uid":"cap_0b2BS2-jNYxgx_gwz2Xyb","slug":"agents-openwebninja-com-ebay-product-search-f8e47c8b","name":"eBay Product Search","description":"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.","url":"https://agents.openwebninja.com/real-time-ebay-data/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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\":\"Brand\",\"value\":\"Apple\"}]`\n`[{\"name\":\"Storage Capacity\",\"value\":[\"128 GB\",\"256 GB\"]}]`\n`[{\"name\":\"Model\",\"value\":\"Samsung Galaxy A02s\"},{\"name\":\"Network\",\"value\":\"Unlocked\"}]`"},"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`\n\n**Examples:**\n`new`\n`used,refurbished`"},"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."},"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":{"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"}}},"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_nYsRacBwPNwytT2JYe-Fk","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":"Search eBay listings by keyword and return up to 60 products per page with pricing, seller info, shipping details, and condition filters.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Price research for electronics resale","prompt":"Search eBay for iPhone 15 Pro Max 256GB in new condition, bought now only, and tell me the current prices and top seller ratings so I can figure out what to list mine for."},{"title":"Vintage collectibles market check","prompt":"Find vintage Rolex Submariner listings on eBay — both new and used — sorted by best match, and show me prices, seller feedback, and how many watchers each one has."},{"title":"International marketplace comparison","prompt":"Search eBay Germany for a KitchenAid stand mixer and show me the prices and shipping details — I want to see if it's cheaper buying from de than from the US site."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:37:05.407Z","isFirstParty":false,"canonicalSlug":"agents-openwebninja-com-ebay-product-search-f8e47c8b"}