Spaces:
Sleeping
Download README.md from bugrahans/etsy-scraper: direct link, hf CLI and curl.
- Browser
- Download file 4.19 kB
-
https://huggingface.co/spaces/bugrahans/etsy-scraper/resolve/main/README.md
- Command line
-
hf download hf://spaces/bugrahans/etsy-scraper/README.md
-
curl -L -o README.md https://huggingface.co/spaces/bugrahans/etsy-scraper/resolve/main/README.md
A newer version of the Gradio SDK is available: 6.32.0
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 — 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
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
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) —searchorlisting.query(required) — Forsearch: a search phrase or an Etsy category / search / shop URL. Forlisting: a listing link or numeric ID.country(optional) —us,gb,ca,au,de,fr,es,it,nlortr. Defaults tous.pages(optional, search) — 1–10 pages of about 48 listings. 10 credits each.sort_by(optional, search) —relevance,newest,price_low,price_highortop_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 · Documentation · Etsy scraping guide