--- title: Etsy Scraper short_description: Etsy listings, prices, details and reviews as CSV/JSON emoji: ๐Ÿท๏ธ colorFrom: yellow colorTo: red sdk: gradio sdk_version: 6.0.2 app_file: app.py pinned: false tags: - etsy - etsy-scraper - ecommerce - price-tracking - product-research - marketplace - reviews - web-scraping - scraper - data-extraction - smolagents - tool - scrape.do --- # Etsy Scraper โ€” Powered by Scrape.do Search Etsy the way a shopper would ("personalized leather wallet") or paste a category link, and get every listing back as a clean table: name, price, original price and discount, rating, review count, shop ID and the Star Seller, Free shipping, Bestseller and Ad flags. Download it as CSV, then open any listing for its full details. ## ๐Ÿ”‘ Get your free API token ๐Ÿ‘‰ **[Sign up free on Scrape.do](https://dashboard.scrape.do/sign-up?utm_source=huggingface&utm_medium=etsy-scraper)** โ€” 1,000 free credits per month, no credit card required. An Etsy page costs 10 credits (residential proxy), so that's about 100 pages. The exact cost of every call is read from Scrape.do's `Scrape.do-Request-Cost` header. ## Three tabs | Tab | Input | Output | | --- | --- | --- | | **Search & categories** | A search phrase, or an Etsy category / search / shop link | Up to 10 pages (about 48 listings each) as cards, a table and a CSV. Sort, price range and free-shipping filters | | **Listing details** | An Etsy listing link or numeric listing ID | Name, description, category, shop, all photos, price, availability, rating and the reviews printed on the page | | **Bulk compare** | Up to 20 listing links or IDs, one per line | A side-by-side comparison table and CSV | Any listing from the search results can be sent to **Listing details** with one click, and the first 20 results can be sent to **Bulk compare** with another. ## Markets Prices, currency and shipping depend on where the shopper is. The market dropdown sets Scrape.do's `geoCode` and Etsy's locale header together: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands and Turkey. ## What to know about reviews Etsy prints only the first page of reviews inside the listing page. That is what the Listing details tab returns. Etsy loads further review pages through internal requests that change often, so there is no full-history option. To follow new reviews over time, run the same listing on a schedule and deduplicate on `review_id`. ## Why an API instead of a headless browser Etsy is protected by DataDome, which checks TLS fingerprints, browser behavior and IP quality. This Space uses [Scrape.do](https://scrape.do/blog/etsy-scraping/) with `super=true` (residential proxies), `geoCode` and an Etsy locale header, so there is no browser to run and nothing to unblock. ## Use as a smolagents Tool ```python from smolagents import CodeAgent, InferenceClientModel from tool import ScrapeDoEtsyTool agent = CodeAgent( tools=[ScrapeDoEtsyTool(api_token="YOUR_SCRAPEDO_TOKEN")], model=InferenceClientModel(), ) agent.run("Find the 10 cheapest handmade ceramic mugs on Etsy with free shipping and a rating above 4.8.") ``` You can also set `SCRAPE_DO_API_TOKEN` in your environment and instantiate `ScrapeDoEtsyTool()` with no arguments. ## Inputs - `mode` *(required)* โ€” `search` or `listing`. - `query` *(required)* โ€” For `search`: a search phrase or an Etsy category / search / shop URL. For `listing`: a listing link or numeric ID. - `country` *(optional)* โ€” `us`, `gb`, `ca`, `au`, `de`, `fr`, `es`, `it`, `nl` or `tr`. Defaults to `us`. - `pages` *(optional, search)* โ€” 1โ€“10 pages of about 48 listings. 10 credits each. - `sort_by` *(optional, search)* โ€” `relevance`, `newest`, `price_low`, `price_high` or `top_reviewed`. - `min_price`, `max_price` *(optional, search)* โ€” Price range in the market's currency. - `free_shipping` *(optional, search)* โ€” Only listings with free shipping. --- Independent tool, not affiliated with or endorsed by Etsy. Learn more at [scrape.do](https://scrape.do/) ยท [Documentation](https://scrape.do/documentation/) ยท [Etsy scraping guide](https://scrape.do/blog/etsy-scraping/)