{"uid":"cap_uiKR8iT54Tq7TEzZZtqox","slug":"etsy-marketplace-scraper-x402-ba35d305","name":"Etsy Marketplace 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/etsy?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["score","created","price-asc","price-desc","highest-reviews"],"type":"string","default":"score","description":"Order listings using a sort supported by the public market pages."},"country":{"enum":["US","GB","CA","AU","NZ","DE","FR","IT","ES","NL","IE","BE","AT","PT","JP","BR","MX","CH","SE","NO","DK","PL"],"type":"string","default":"US","description":"Destination country filter. Prices remain in the currency returned by the page."},"queries":{"type":"array","items":{"type":"string"},"description":"One or more shopper phrases; each phrase opens its public market page. Short phrases work best."},"maxPages":{"type":"integer","default":5,"maximum":30,"minimum":1,"description":"Number of market pages per phrase. These pages showed about eight listing cards each during testing."},"maxPrice":{"type":"number","minimum":0,"description":"Keep listings whose current price is at most this amount in the returned currency."},"minPrice":{"type":"number","minimum":0,"description":"Keep listings whose current price is at least this amount in the returned currency."},"includeAds":{"type":"boolean","default":true,"description":"Include sponsored placements and report their visible page positions."},"maxResults":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many saved listings across all phrases. Set to 0 for no total cap."},"onSaleOnly":{"type":"boolean","default":false,"description":"Keep listings with a visible reduced price."},"freeShippingOnly":{"type":"boolean","default":false,"description":"Keep listings marked with free shipping on the market page."},"dedupeAcrossQueries":{"type":"boolean","default":true,"description":"Save each listing once when it appears under multiple phrases. The first phrase is retained."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"image":null,"price":null,"title":null,"shopId":null,"shopUrl":null,"shopName":null,"listingId":null,"listingUrl":null}],"product":"etsy"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.16","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.16/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.16","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2kVMQt58-f9LfaaVVH8Wr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.16","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Etsy public marketplace pages and returns structured listing data including title, price, shop info, and image for one or more search phrases.","exampleAgentPrompt":"Search Etsy for 'personalized wedding gifts' and 'custom anniversary gifts' in the US, sorted by score, up to 3 pages each, only show listings under $50 with free shipping, and give me the titles, prices, shop names, and URLs.","exampleUseCases":[{"title":"Budget gift discovery for a holiday","prompt":"Search Etsy for 'handmade Christmas ornaments' and 'personalized stocking stuffers' in the US sorted by highest reviews, up to 2 pages per phrase, and only show me listings under $25 with free shipping."},{"title":"Sale hunting across multiple categories","prompt":"Look up 'vintage leather wallet' and 'handmade belt' on Etsy for US shoppers, sort by price low to high, only show me things on sale, and cap the results at 20 total listings."},{"title":"Market research for competitor pricing","prompt":"Pull Etsy listings for 'custom enamel pins' and 'hand-painted badges' sorted by score across 5 pages each in the US — include sponsored listings too and give me all titles, prices, shop names, and listing URLs."}],"resultDescription":"A JSON object with a count of returned listings and an array of items, each containing listing title, listing URL, listing ID, price, shop name, shop URL, shop ID, and image URL, plus the product name ('etsy').","failureModes":["Empty result set (0 items) if search phrases return no matching listings — not charged","Network or scrape failure if Etsy changes its page structure — not charged","Invalid sort enum value returns a validation error","maxPrice/minPrice conflict returns no results if range is impossible","Country enum mismatch returns validation error for unsupported country codes","Rate limiting or blocking by Etsy may cause incomplete page results"],"whenToPreferThis":"Choose this endpoint when you need structured product data from Etsy's public marketplace — titles, prices, shop info, and images — without managing browser automation or scraping infrastructure yourself. It is ideal for price research, gift discovery, competitor analysis, or feeding an agent with real Etsy listings. Prefer it over generic web scrapers when you specifically need Etsy marketplace data with built-in filtering (price range, sale, free shipping, sort order). The pay-per-call model with no charge for failed/empty runs makes it low-risk for exploratory searches.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:59.224Z","isFirstParty":false,"canonicalSlug":"etsy-marketplace-scraper-x402-ba35d305"}