etsy-scraper / README.md
bugrahans's picture
Upload 4 files
59d0af0 verified
|
Raw History Blame Contribute Delete
4.19 kB

A newer version of the Gradio SDK is available: 6.32.0

Upgrade
metadata
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) — 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 · Documentation · Etsy scraping guide