{"slug":"ebay-use-x402atlas-com-search-475727","title":"eBay listings search — live prices, condition, shipping, seller reputation, auct","host":"ebay.use.x402atlas.com","method":"GET","resource":"https://ebay.use.x402atlas.com/search","category":"commerce","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.","price_listed":0.02,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":3,"reported_payers_30d":2,"networks":["eip155:137","eip155:42161","eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"buying_format":"BIN","condition":"3000","domain":"ebay.com","location":"Domestic","max_price":800,"min_price":100,"page":1,"per_page":50,"query":"iphone 15 pro","sort":"price_shipping_lowest"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"buying_format":{"description":"Buying format: Auction, Buy It Now (BIN) or Accepts Offers (BO)","enum":["Auction","BIN","BO"],"type":"string"},"condition":{"description":"Comma-separated condition ids: 1000 New, 1500 Open box, 2000 Certified refurbished, 2500 Seller refurbished, 3000 Used, 10 Not specified","type":"string"},"domain":{"default":"ebay.com","description":"eBay regional site to search","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"},"location":{"description":"Preferred item location","enum":["Domestic","Regional","Worldwide"],"type":"string"},"max_price":{"description":"Maximum price filter","minimum":0,"type":"number"},"min_price":{"description":"Minimum price filter","minimum":0,"type":"number"},"page":{"default":1,"description":"Result page number; follow next_page from a previous response","minimum":1,"type":"integer"},"per_page":{"default":50,"description":"Results per page","enum":[25,50,100,200],"type":"integer"},"query":{"description":"Free-text search query — anything usable in a regular eBay search (e.g. \"iphone 15 pro\")","maxLength":300,"type":"string"},"sort":{"default":"best_match","description":"Sort order","enum":["best_match","ending_soonest","newly_listed","price_shipping_lowest","price_shipping_highest","distance_nearest"],"type":"string"}},"required":["query"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"categories":{"description":"Category facets; pass an id back as category_id to narrow the search","items":{"properties":{"id":{"type":"integer"},"name":{"type":"string"}},"type":"object"},"type":"array"},"domain":{"description":"eBay site actually searched","type":"string"},"items":{"items":{"properties":{"bids":{"description":"Auction bid count","type":"integer"},"condition":{"type":"string"},"details_link":{"description":"This API's /product URL for the listing","type":"string"},"discount":{"description":"Discount label, e.g. \"18% off\"","type":"string"},"extensions":{"description":"Listing badges (e.g. \"Free returns\")","items":{"type":"string"},"type":"array"},"link":{"description":"The listing's eBay page","type":"string"},"location":{"description":"Where the item ships from","type":"string"},"original_price":{"description":"Pre-discount price, when the listing is discounted","properties":{"extracted":{"type":"number"},"raw":{"type":"string"}},"type":"object"},"price":{"description":"Listing price; a from/to range flattens to the range string plus the extracted low bound","properties":{"extracted":{"type":"number"},"raw":{"type":"string"}},"type":"object"},"product_id":{"description":"eBay item id — pass to /product for the full listing","type":"string"},"quantity_sold":{"type":"integer"},"rating":{"type":"number"},"returns":{"type":"string"},"reviews_count":{"type":"integer"},"seller":{"properties":{"positive_feedback_percent":{"type":"number"},"review_count":{"type":"integer"},"username":{"type":"string"}},"type":"object"},"shipping":{"description":"Shipping cost line","properties":{"extracted":{"type":"number"},"free":{"type":"boolean"},"raw":{"type":"string"}},"type":"object"},"sold_date":{"description":"Realized sale date — set on /sold results when the upstream marks it","type":"string"},"sponsored":{"type":"boolean"},"subtitle":{"type":"string"},"thumbnail":{"type":"string"},"time_left":{"description":"Auction time remaining","type":"string"},"title":{"type":"string"},"watchers":{"type":"integer"}},"type":"object"},"type":"array"},"next_page":{"description":"Pass back as page= for the next page; null when this is the last page","type":["integer","null"]},"note":{"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.","type":"string"},"page":{"type":"integer"},"per_page":{"type":"integer"},"query":{"description":"Echoed search query","type":"string"},"related_searches":{"description":"Suggested query refinements","items":{"type":"string"},"type":"array"},"total_results":{"description":"Total listings matching the query upstream","type":"integer"}},"required":["query","domain","page","per_page","items"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"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.","last_updated":"2026-09-15T06:32:06.897Z","schemes":["exact"]}