{"uid":"cap_fgMlrUedUy8JxcfVrEKVS","slug":"ebay-search-comps-products-live-listings-search-b72b0e95","name":"eBay Search, Comps & Products — Live Listings Search","description":"eBay listings search — live prices, condition, shipping, seller reputation, auctions & Buy It Now across supported regional eBay sites, with category, price band, condition, seller & location filters, sorted, as clean JSON.","url":"https://ebay.use.x402atlas.com/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"page":{"type":"integer","default":1,"minimum":1,"description":"Result page number; follow next_page from a previous response"},"sort":{"enum":["best_match","ending_soonest","newly_listed","price_shipping_lowest","price_shipping_highest","distance_nearest"],"type":"string","default":"best_match","description":"Sort order"},"query":{"type":"string","maxLength":300,"description":"Free-text search query — anything usable in a regular eBay search (e.g. \"iphone 15 pro\")"},"domain":{"enum":["ebay.at","ebay.ca","ebay.ch","ebay.co.uk","ebay.com","ebay.com.au","ebay.com.hk","ebay.com.my","ebay.com.sg","ebay.de","ebay.es","ebay.fr","ebay.ie","ebay.it","ebay.nl","ebay.pl"],"type":"string","default":"ebay.com","description":"eBay regional site to search"},"location":{"enum":["Domestic","Regional","Worldwide"],"type":"string","description":"Preferred item location"},"per_page":{"enum":[25,50,100,200],"type":"integer","default":50,"description":"Results per page"},"condition":{"type":"string","description":"Comma-separated condition ids: 1000 New, 1500 Open box, 2000 Certified refurbished, 2500 Seller refurbished, 3000 Used, 10 Not specified"},"max_price":{"type":"number","minimum":0,"description":"Maximum price filter"},"min_price":{"type":"number","minimum":0,"description":"Minimum price filter"},"buying_format":{"enum":["Auction","BIN","BO"],"type":"string","description":"Buying format: Auction, Buy It Now (BIN) or Accepts Offers (BO)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","domain","page","per_page","items"],"properties":{"note":{"type":"string","description":"Present only on a sample response (empty/omitted query): a hint to pass real parameters. The paid request ran; no upstream call was made."},"page":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"bids":{"type":"integer","description":"Auction bid count"},"link":{"type":"string","description":"The listing's eBay page"},"price":{"type":"object","properties":{"raw":{"type":"string"},"extracted":{"type":"number"}},"description":"Listing price; a from/to range flattens to the range string plus the extracted low bound"},"title":{"type":"string"},"rating":{"type":"number"},"seller":{"type":"object","properties":{"username":{"type":"string"},"review_count":{"type":"integer"},"positive_feedback_percent":{"type":"number"}}},"returns":{"type":"string"},"discount":{"type":"string","description":"Discount label, e.g. \"18% off\""},"location":{"type":"string","description":"Where the item ships from"},"shipping":{"type":"object","properties":{"raw":{"type":"string"},"free":{"type":"boolean"},"extracted":{"type":"number"}},"description":"Shipping cost line"},"subtitle":{"type":"string"},"watchers":{"type":"integer"},"condition":{"type":"string"},"sold_date":{"type":"string","description":"Realized sale date — set on /sold results when the upstream marks it"},"sponsored":{"type":"boolean"},"thumbnail":{"type":"string"},"time_left":{"type":"string","description":"Auction time remaining"},"extensions":{"type":"array","items":{"type":"string"},"description":"Listing badges (e.g. \"Free returns\")"},"product_id":{"type":"string","description":"eBay item id — pass to /product for the full listing"},"details_link":{"type":"string","description":"This API's /product URL for the listing"},"quantity_sold":{"type":"integer"},"reviews_count":{"type":"integer"},"original_price":{"type":"object","properties":{"raw":{"type":"string"},"extracted":{"type":"number"}},"description":"Pre-discount price, when the listing is discounted"}}}},"query":{"type":"string","description":"Echoed search query"},"domain":{"type":"string","description":"eBay site actually searched"},"per_page":{"type":"integer"},"next_page":{"type":["integer","null"],"description":"Pass back as page= for the next page; null when this is the last page"},"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}},"description":"Category facets; pass an id back as category_id to narrow the search"},"total_results":{"type":"integer","description":"Total listings matching the query upstream"},"related_searches":{"type":"array","items":{"type":"string"},"description":"Suggested query refinements"}}}}}}},"responseSchema":{"type":"json","example":{"page":1,"items":[{"link":"https://www.ebay.com/itm/146252519201","price":{"raw":"$489.99","extracted":489.99},"title":"Apple iPhone 15 Pro 128GB Natural Titanium (Unlocked) - Very Good Condition","seller":{"username":"certified.tech.deals","review_count":48213,"positive_feedback_percent":99.2},"returns":"Free returns","location":"United States","shipping":{"raw":"Free shipping","free":true},"condition":"Pre-Owned","sponsored":false,"thumbnail":"https://i.ebayimg.com/images/g/aB0AAOSw1x9mQ2Zx/s-l500.jpg","extensions":["Free returns","Top Rated Plus"],"product_id":"146252519201","details_link":"https://ebay.use.x402atlas.com/product?product_id=146252519201","quantity_sold":412},{"link":"https://www.ebay.com/itm/156733902118","price":{"raw":"$519.00 to $589.00","extracted":519},"title":"Apple iPhone 15 Pro 256GB Blue Titanium Unlocked","rating":4.5,"seller":{"username":"phoneup_store","review_count":10544,"positive_feedback_percent":98.7},"discount":"20% off","location":"United States","shipping":{"raw":"+$12.40 shipping","free":false,"extracted":12.4},"condition":"Pre-Owned","sponsored":false,"thumbnail":"https://i.ebayimg.com/images/g/kQ4AAOSwXy5nGt2p/s-l500.jpg","product_id":"156733902118","details_link":"https://ebay.use.x402atlas.com/product?product_id=156733902118","reviews_count":231,"original_price":{"raw":"$649.00","extracted":649}}],"query":"iphone 15 pro","domain":"ebay.com","per_page":50,"next_page":2,"categories":[{"id":9355,"name":"Cell Phones & Smartphones"},{"id":20349,"name":"Cell Phone & Smartphone Parts"}],"total_results":8347,"related_searches":["iphone 15 pro max","iphone 15 pro unlocked","iphone 14 pro"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.00","successRate":"0.00","reviews":1,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_etEer539rzcjMJ0sLNDm9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search live eBay listings across regional sites with filters for condition, price, buying format, and seller location, returning structured JSON with prices, shipping, and seller info.","exampleAgentPrompt":"Search eBay.com for a used iPhone 15 Pro in Used condition (condition 3000), priced between $400 and $700, Buy It Now only, sorted by lowest price first, and give me the first 50 results as clean JSON.","exampleUseCases":[{"title":"Used electronics price benchmarking","prompt":"Search eBay.com for 'Sony WH-1000XM5 headphones' in Used condition, Buy It Now format, priced under $200, sorted by lowest price — I want to see what they're actually selling for right now."},{"title":"Auction sniping research on UK eBay","prompt":"Find me active auctions on ebay.co.uk for 'Lego Technic 42156' ending soonest, no price filter, worldwide shipping, so I can see what's up for bid and when they close."},{"title":"Cross-region new product price comparison","prompt":"Search ebay.de for 'Dyson V15 Detect' in New condition, Buy It Now, sorted by lowest price including shipping, and return up to 100 results so I can compare German eBay prices to US retail."}],"resultDescription":"A structured JSON object containing the search query metadata (query, domain, page, per_page) and an array of listing items, each with fields such as title, current price, shipping cost, condition label, buying format (Auction/BIN/BO), seller rating, item URL, and for auctions the remaining time or end date.","failureModes":["Invalid or unsupported domain enum value returns an error","Query string exceeding 300 characters is rejected","Conflicting min_price and max_price (min > max) may return empty results or an error","Unsupported condition ID combination returns no results","Rate limiting or payment failure (x402) results in 402 Payment Required","eBay regional site outage causes upstream timeout","Very niche queries may return zero items"],"whenToPreferThis":"Use this endpoint when you need live, current eBay listing data including prices, conditions, and seller info across multiple regional eBay marketplaces. Prefer it over sold-comps endpoints when you want active listings still available to buy (not historical sold prices). Prefer it over a generic web scraper when you need structured, filterable marketplace data with auction timing, condition codes, and seller reputation already parsed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-08-04T15:09:19.265Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:44.192Z","isFirstParty":false}