{"uid":"cap_ziluM4ZkWJiEtCoZP_JQ1","slug":"etsy-marketplace-scraper-b4d697d7","name":"Etsy Marketplace Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_ZoO-4lCnDuxv9gx5CjXz-","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":"Scrapes structured product listing data from Etsy's public marketplace pages based on search queries, returning titles, prices, shop info, and listing URLs.","exampleAgentPrompt":"Search Etsy for 'personalized leather wallet' in the US, sorted by highest reviews, only showing items with free shipping and priced between $20 and $80 — pull up to 3 pages and give me the titles, prices, and shop links.","exampleUseCases":[{"title":"Gift idea research for a budget","prompt":"Search Etsy for 'custom name necklace' in the US, sorted by score, priced between $15 and $60, with free shipping only — grab the first 2 pages and list the top results with titles, prices, and listing URLs."},{"title":"Competitor price monitoring for a seller","prompt":"Look up Etsy listings for 'hand-poured soy candle' sorted by price lowest first, in the US market, up to 5 pages — I want to see all the titles, prices, and shop names so I can benchmark my own pricing."},{"title":"Finding on-sale vintage items in a niche","prompt":"Find on-sale vintage typewriter listings on Etsy in the UK, sorted by newest, up to 3 pages — show me items under £150 with their titles, prices, and shop links."}],"resultDescription":"Returns a JSON object with a count of matched listings and an array of items, each containing the listing title, current price, listing URL, listing ID, shop name, shop URL, shop ID, and an image URL. The 'product' field is set to 'etsy'.","failureModes":["Empty results if search phrases return no listings matching filters","Null fields (image, price, title) if Etsy page structure changes","No charge on failed or empty runs","Rate limiting or blocking by Etsy's anti-scraping measures","Invalid enum values for sort or country result in validation errors"],"whenToPreferThis":"Choose this endpoint when you need structured, filterable Etsy marketplace data — product titles, prices, shop info, listing URLs — across multiple search queries and pages, especially when you want server-side filtering by price range, sale status, free shipping, or country, without managing browser automation yourself. Prefer it over generic web scrapers when targeting Etsy specifically with Etsy-native sort options.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:58.043Z","isFirstParty":false,"canonicalSlug":"etsy-marketplace-scraper-b4d697d7"}