{"uid":"cap_prybCR9QW_w3hdY3aRI9x","slug":"ebay-search-scraper-x402-142af4ea","name":"eBay Search Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/ebay-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["active","sold","both"],"type":"string","default":"active","description":"Collect active listings, sold listings, or both. Sold listings are shown as eBay reports them on search pages."},"seller":{"type":"string","description":"Restrict a keyword search to one public seller username."},"sortBy":{"enum":["best_match","ending_soon","newest","price_asc","price_desc"],"type":"string","default":"best_match","description":"Result order for keyword searches."},"category":{"type":"string","description":"Restrict a keyword search to a numeric eBay category ID."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Total cap across all searches and modes. Set 0 for no cap."},"maxPrice":{"type":"number","minimum":0,"description":"Maximum price in the marketplace currency for keyword searches."},"minPrice":{"type":"number","minimum":0,"description":"Minimum price in the marketplace currency for keyword searches."},"condition":{"enum":["any","new","open_box","refurbished","used","for_parts"],"type":"string","default":"any","description":"Condition filter for keyword searches. Start URLs retain their own filters."},"startUrls":{"type":"array","description":"Optional eBay search URLs or individual item URLs. Regional eBay domains are supported."},"listingType":{"enum":["all","auction","bin","best_offer"],"type":"string","default":"all","description":"Auction, Buy It Now, or Best Offer filter for keyword searches."},"marketplace":{"enum":["ebay.com","ebay.co.uk","ebay.de","ebay.fr","ebay.it","ebay.es","ebay.ca","ebay.com.au","ebay.nl","ebay.at","ebay.ch","ebay.ie","ebay.pl","ebay.com.hk","ebay.com.my","ebay.ph","ebay.com.sg"],"type":"string","default":"ebay.com","description":"Regional eBay site for keyword searches. A start URL uses its own domain."},"searchQuery":{"type":"string","description":"Keywords to search, such as mechanical keyboard. Combine with the marketplace and filters below."},"freeShipping":{"type":"boolean","default":false,"description":"Request listings marked for free shipping in keyword searches."},"detailedItems":{"type":"boolean","default":false,"description":"Visit each active item page to add brand, color, gallery images, and listing status when its structured product data is available. Slower and uses more requests."},"returnsAccepted":{"type":"boolean","default":false,"description":"Request listings with accepted returns in keyword searches."},"maxPagesPerSearch":{"type":"integer","default":10,"maximum":50,"minimum":1,"description":"Maximum search result pages to request for each source and listing mode."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"price":null,"title":null,"itemId":null,"currency":null,"priceValue":null,"originalPrice":null,"originalPriceValue":null}],"product":"ebay-search"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ue9RgCK6t0uzad-QG3CnS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches eBay listings and returns structured product data including prices, titles, and item IDs, with pay-per-call billing via x402.","exampleAgentPrompt":"Search eBay for used mechanical keyboards under $150, sorted by price low to high, and give me the top 50 active listings with their prices and URLs from ebay.com.","exampleUseCases":[{"title":"Price research for resale arbitrage","prompt":"Search eBay for sold listings of 'Nintendo Switch OLED' on ebay.com, condition any, up to 100 results — I want to know what they're actually selling for."},{"title":"Competitor product monitoring","prompt":"Search eBay for active listings of 'Lego Technic 42171' on ebay.co.uk, sorted by newest, give me up to 50 results with prices in GBP."},{"title":"Seller inventory audit","prompt":"Pull all active eBay listings from seller 'techdeals99' on ebay.com, up to 200 items, sorted by price descending — I need titles, prices, and item URLs."}],"resultDescription":"Returns a JSON object with a count of items and an array of listing objects, each containing the item title, URL, item ID, price (formatted), price value (numeric), currency, and original price if discounted. Failed or empty searches are not charged.","failureModes":["Empty result set if no listings match filters (not charged)","Invalid category ID returns error or empty results","Unsupported marketplace domain returns error","Rate limiting or eBay anti-scrape measures may cause partial results","Invalid startUrls format causes parsing failure","Payment failure via x402 prevents execution"],"whenToPreferThis":"Choose this endpoint when you need structured eBay listing data programmatically — price research, inventory analysis, resale arbitrage, or market value estimation — especially when you want filtering by price range, condition, seller, listing type, or regional eBay marketplace. Prefer over manual scraping or generic web scrapers because it returns clean JSON with numeric price fields and only charges on successful non-empty runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:31.349Z","isFirstParty":false,"canonicalSlug":"ebay-search-scraper-x402-142af4ea"}