{"uid":"cap_hVlWfyiyjApmBffc6LfUv","slug":"ebay-product-search-scraper-x402-f29061c0","name":"eBay Product 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?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["best_match","ending_soonest","newly_listed","price_low","price_high"],"type":"string","default":"best_match","description":"How eBay orders search results."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many products across all searches. Zero means no total cap."},"maxPrice":{"type":"integer","minimum":0,"description":"Maximum listing price in the marketplace currency."},"minPrice":{"type":"integer","minimum":0,"description":"Minimum listing price in the marketplace currency."},"condition":{"type":"array","items":{"enum":["new","open_box","refurbished","used","for_parts"],"type":"string","enumTitles":["New","Open box","Refurbished","Used","For parts"]},"default":[],"description":"Only include selected conditions. Leave empty for all."},"listingType":{"enum":["all","auction","buy_it_now"],"type":"string","default":"all","description":"Include all listings or only auction or fixed-price results."},"marketplace":{"enum":["US","UK","DE","FR","IT","ES","CA","AU"],"type":"string","default":"US","description":"Marketplace domain and currency context for the search."},"searchQueries":{"type":"array","items":{"type":"string"},"description":"Search terms to run separately. Enter at least one keyword."},"maxSearchPages":{"type":"integer","default":5,"maximum":20,"minimum":1,"description":"Maximum search pages per keyword, with up to 60 listings on each page."},"maxRequestRetries":{"type":"integer","default":5,"maximum":10,"minimum":2,"description":"Maximum browser attempts per search page when access fails."},"maxProductsPerSearch":{"type":"integer","default":100,"minimum":1,"description":"Maximum results to save for each keyword."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"type":null,"price":null,"title":null,"itemId":null,"priceMax":null,"marketplace":null,"priceString":null,"listPriceString":null}],"product":"ebay"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wTpuwYVLDbc2i8Dj6-Nyn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","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 US for 'Sony WH-1000XM5 headphones', show me up to 20 results sorted by lowest price, only new or refurbished condition, buy-it-now listings only, between $150 and $350.","exampleUseCases":[{"title":"Price check before buying electronics","prompt":"Look up eBay listings for 'iPhone 15 Pro 256GB' on the US marketplace — I want buy-it-now only, new or open-box condition, sorted by lowest price, capped at $900, show me the top 15 results."},{"title":"Scouting auction deals on collectibles","prompt":"Search eBay for 'vintage Rolex Submariner' — auction listings only, used condition, sorted by ending soonest, on the UK marketplace, up to 30 results please."},{"title":"Reseller inventory research","prompt":"Run eBay searches for 'LEGO Technic 42171', 'LEGO City 60388', and 'LEGO Star Wars 75375' on the US marketplace, sorted by best match, up to 50 results per search, all conditions included, so I can compare current market prices."}],"resultDescription":"Returns a JSON object with a count of matched listings and an array of items, each containing the product title, item ID, price (numeric and formatted string), list price string, listing type, and marketplace. Empty or failed runs are not billed.","failureModes":["No listings found for the query (not charged)","eBay blocks scraping attempt after max retries exhausted (not charged if empty)","Invalid marketplace code returns validation error","Search query array is empty — at least one keyword required","maxSearchPages exceeds 20 — capped at schema maximum","Payment failure via x402 prevents request from being processed"],"whenToPreferThis":"Use this endpoint when you need structured eBay listing data — prices, titles, item IDs — without building your own scraper or managing browser automation. Prefer it over generic web scraping tools when you specifically need eBay marketplace data with built-in retry logic, condition and listing-type filters, and multi-marketplace support. Its pay-per-call model (no charge for failed/empty runs) makes it cost-effective for exploratory or low-volume queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:47.358Z","isFirstParty":false,"canonicalSlug":"ebay-product-search-scraper-x402-f29061c0"}