{"uid":"cap_4Wv46j4MCUFPksuanQwfP","slug":"etsy-search-scraper-f085e4d8","name":"Etsy Search Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_asgmZ0SUPMEQ0bG0Uc0rx","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":"Scrapes Etsy search results for one or more search terms, returning structured listing data including title, price, image, rank, and URL.","exampleAgentPrompt":"Search Etsy for 'personalized wedding gifts' and 'custom name necklace', return up to 30 listings each priced between $15 and $80, and include the full description and review counts for each listing.","exampleUseCases":[{"title":"Handmade gift sourcing for holiday shopping","prompt":"Search Etsy for 'personalized ornament' and 'custom stocking', show me up to 20 listings per term priced under $40, and include descriptions so I can read what each seller offers."},{"title":"Competitor pricing research for Etsy sellers","prompt":"Pull the top 50 Etsy listings for 'macrame wall hanging' and 'boho wall decor' so I can see what prices and titles my competitors are using — no need for descriptions, just the basics."},{"title":"Niche product market analysis","prompt":"Scrape Etsy search results for 'cottagecore candle' across up to 10 pages, filter to listings between $10 and $60, and give me the titles, prices, and rankings so I can analyze what's trending."}],"resultDescription":"Returns a JSON array of structured Etsy listing objects, each containing the listing ID, title, price, image URL, listing URL, search term used, page number, and organic rank. When includeDescription is true, also returns the listing description, stock quantity, category, item rating, review count, and availability. The response includes a total count of results and a product identifier.","failureModes":["Empty results if search terms return no Etsy listings","Etsy anti-scraping measures may block requests, returning an empty or failed run (not charged)","Price filtering is applied after fetching, so maxResultsPerTerm may be reduced after filtering","Rate limiting or network errors may result in partial results","Invalid or misspelled search terms return zero listings"],"whenToPreferThis":"Choose this endpoint when you need structured Etsy marketplace data — product titles, prices, images, and rankings — for one or more search terms, especially for competitive research, price comparison, gift sourcing, or trend analysis. It supports multiple search terms in a single call with per-term result caps, price range filtering, and optional deep-fetch of descriptions and reviews. Prefer it over generic web scrapers when you specifically need Etsy search result data in a clean, consistent schema without building your own scraper.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:14.736Z","isFirstParty":false,"canonicalSlug":"etsy-search-scraper-f085e4d8"}