{"uid":"cap_tI2Eh2p5uMTrJe3BY4kok","slug":"ebay-search-scraper-a4886fc3","name":"eBay Search Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_Ylcn3ltbtTrNiSnr-Lr7m","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":"Scrapes eBay search results and item listings across regional marketplaces, returning structured product data including price, title, and item ID","exampleAgentPrompt":"Search eBay for sold listings of a mechanical keyboard under $150 in used condition, sorted by newest, and give me the first 50 results from ebay.com.","exampleUseCases":[{"title":"Used electronics price research","prompt":"Look up sold eBay listings for an iPhone 14 Pro 256GB in used condition on ebay.com — I want to see the last 50 sold prices so I can figure out what mine is worth."},{"title":"Seller inventory scrape","prompt":"Pull all active listings from eBay seller 'techdeals99' on ebay.com — up to 100 items — sorted by price lowest first, so I can see everything they have for sale."},{"title":"Cross-marketplace deal hunting","prompt":"Search ebay.co.uk for new LEGO Technic sets under £80, Buy It Now only, sorted by best match, and give me the top 60 results."}],"resultDescription":"Returns a JSON object with a count of matched items and an array of listing objects, each containing the item title, URL, item ID, price (as a formatted string), price value (numeric), currency, and original price if discounted. Failed or empty runs are not billed.","failureModes":["Empty results if search query matches no listings — not charged","Invalid category ID returns an error or empty result","Unsupported marketplace enum value causes validation error","Rate limiting or eBay bot detection may cause empty runs — not charged","Invalid start URL format causes extraction failure"],"whenToPreferThis":"Use this endpoint when you need structured eBay listing data — prices, titles, item IDs — for keyword searches or specific seller inventories across regional eBay marketplaces. It supports filtering by condition, listing type, price range, and sort order, and can retrieve both active and sold listings. Prefer this over general web scrapers when you specifically need eBay product data in a clean JSON format with per-item pricing details.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:18.893Z","isFirstParty":false,"canonicalSlug":"ebay-search-scraper-a4886fc3"}