{"uid":"cap_9monx8POovw6P559SmHqi","slug":"etsy-search-scraper-x402-7d8144b2","name":"Etsy 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/etsy-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many listings across all terms. Zero means no total cap."},"maxPrice":{"type":"number","minimum":0,"description":"Keep listings priced at or below this amount in the displayed currency. Applied after fetching search pages."},"minPrice":{"type":"number","minimum":0,"description":"Keep listings priced at or above this amount in the displayed currency. Applied after fetching search pages."},"searchTerms":{"type":"array","items":{"type":"string"},"description":"One or more buyer search phrases. Each phrase is paged and ranked separately."},"maxPagesPerTerm":{"type":"integer","default":50,"maximum":100,"minimum":1,"description":"Maximum search pages to visit per phrase. A page currently shows about eight organic listings."},"maxResultsPerTerm":{"type":"integer","default":50,"maximum":500,"minimum":1,"description":"Maximum organic listings to save for each search phrase."},"includeDescription":{"type":"boolean","default":false,"description":"Open each listing page to add its description, stock quantity, category, item rating, review count, and availability. Adds one request per result."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"page":null,"rank":null,"image":null,"price":null,"title":null,"listingId":null,"searchTerm":null}],"product":"etsy-search"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.12","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.12/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-uD4hPuAOpPVJ3l7SPXui","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.12","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Etsy for product listings by keyword and returns structured data including title, price, image, URL, and rank, with optional listing detail enrichment.","exampleAgentPrompt":"Search Etsy for 'personalized leather wallet' and 'monogram keychain', return up to 30 listings each, keep only items priced between $15 and $60, and include the full listing descriptions so I can see ratings and review counts.","exampleUseCases":[{"title":"Gift idea price comparison","prompt":"Search Etsy for 'custom birth flower necklace' and 'personalized name ring', get up to 20 listings per term, filter to items between $20 and $80, and include descriptions so I can see the ratings and stock levels."},{"title":"Competitor product research","prompt":"Pull the top 50 Etsy listings for 'macrame wall hanging' and 'boho wall art' — I want titles, prices, images, and URLs so I can analyze what's selling and at what price points."},{"title":"Trending handmade items discovery","prompt":"Search Etsy for 'cottagecore candle' and return up to 40 listings, no price filter, just show me the titles, ranks, prices, and images from the first 5 pages so I can see what's trending."}],"resultDescription":"A JSON object containing a count of matched listings and an array of items, each with listing ID, title, price, image URL, listing URL, page number, rank, and search term. If includeDescription is true, each item also includes the full description, stock quantity, category, item rating, review count, and availability status.","failureModes":["Empty results if search terms return no Etsy listings (not charged)","Etsy rate limiting or blocking may reduce result counts","Price filters applied post-fetch may reduce output count significantly","maxPagesPerTerm cap may truncate results for broad queries","Listing detail fetch failures if includeDescription is true and individual pages are unavailable"],"whenToPreferThis":"Use this endpoint when you need structured Etsy marketplace data — product titles, prices, images, and rankings — for one or more search terms, especially when building shopping assistants, doing e-commerce competitive research, or powering gift recommendation agents. It is pay-per-call with no charge for failed or empty runs, making it cost-efficient for exploratory queries. Prefer this over generic web scrapers when Etsy-specific structured output (listing ID, rank, price filters) is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:22.653Z","isFirstParty":false,"canonicalSlug":"etsy-search-scraper-x402-7d8144b2"}