{"uid":"cap_Cgm7vE77AyJ4W9JyBS2tW","slug":"etsy-shop-reviews-scraper-7ea707bd","name":"Etsy Shop Reviews Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/etsy-reviews?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"itemLimit":{"type":"integer","default":100,"minimum":0,"description":"Maximum reviews across all shops; 0 means no limit."},"shop_name":{"type":"array","description":"Public shop names or shop URLs to collect reviews from."},"maxReviewsPerShop":{"type":"integer","default":0,"minimum":0,"description":"Maximum reviews from each shop; 0 means no per-shop limit."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"rating":null,"review":null,"reviewId":null,"receiptId":null,"reviewKey":null,"reviewedAt":null,"buyerUserId":null,"buyerRealName":null}],"product":"etsy-reviews"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zRSU1fpI1Y6dKlUoBI7HK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and returns structured customer review data from one or more Etsy shops, with configurable limits per shop and in total.","exampleAgentPrompt":"Can you scrape the customer reviews from the Etsy shop 'SunflowerCeramics' — grab up to 200 reviews total, no more than 50 per shop — and give me the ratings, review text, and reviewer names?","exampleUseCases":[{"title":"Competitor review analysis for Etsy sellers","prompt":"Pull up to 500 customer reviews from the Etsy shops 'VelvetVineJewelry' and 'RusticRootDecor' — max 250 per shop — so I can analyze what buyers love and complain about."},{"title":"Reputation monitoring for a single Etsy store","prompt":"Get me the latest 100 reviews from the Etsy shop 'MapleMorningCandles' including their ratings, review text, and dates so I can track how our reputation has changed recently."},{"title":"Aggregating multi-shop review dataset for research","prompt":"Scrape reviews from these three Etsy shops — 'CedarAndSageStudio', 'BlueBirchCeramics', and 'GoldenThreadEmbroidery' — with no per-shop limit and a total cap of 300 reviews, and give me the full structured data including buyer IDs and receipt IDs."}],"resultDescription":"Returns a JSON object with a count of collected reviews and an array of review items, each containing rating, review text, review ID, receipt ID, review key, timestamp of review, buyer user ID, and buyer real name. Failed or empty runs are not billed.","failureModes":["Shop name not found or misspelled — returns empty items array","Shop has no public reviews — returns count 0 with empty items","Rate limiting or access restrictions on Etsy — may return partial or empty data","Invalid input schema (e.g. negative itemLimit) — request rejected","Network timeout scraping large shops — partial results or empty response"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable review data from Etsy shops at scale, especially for multiple shops in a single call. It is well-suited for competitive intelligence, sentiment analysis pipelines, or reputation monitoring workflows where you need raw review fields (rating, text, buyer info, timestamps). Prefer it over manual scraping or generic web scrapers because it returns normalized JSON and only charges on successful, non-empty runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T13:02:10.781Z","isFirstParty":false,"canonicalSlug":"etsy-shop-reviews-scraper-7ea707bd"}