Etsy Scraper | Listings Shops Categories Prices

Scrape Etsy product listings, keyword search, shops, categories, featured hubs, and listing detail pages — then download structured marketplace data as Excel, CSV, or JSON.

Use this Actor as a practical Etsy product data API for price monitoring, seller research, and handmade/vintage assortment tracking. Pick a ship-to market, choose a mode, set filters, and get Dataset rows with listingId, prices (sale / original / % off), ratings, images, shop names, and ad badges.

• Scrape Etsy search, shop search, category & subcategory PLPs (/c/jewelry or /c/jewelry/necklaces), listing PDP, shop pages, featured / curated hubs, and the category taxonomy
• Cover 30+ ship-to markets (US, GB, CA, AU, DE, FR, …) with locale, currency, and residential egress aligned to the market
• Extract title, price, currency, salePrice, originalPrice, discountPercent, ratingValue, reviewCount, imageUrl, shopName, badges, isAd
• Optional PDP enrich (enrichDetails) for shipping text, shop sales / years, more images, and variations
• Filter by price range, ships from, ready to ship, Star Seller, free shipping, and digital download
• Export to Excel / CSV / JSON, or connect Make, n8n, Zapier, Python, or the Apify API
• Pay per event — Actor start + each Dataset result; platform usage is included (you do not pay separate Apify compute on top)

Unofficial tool. This Actor is not affiliated with, endorsed by, or sponsored by Etsy, Inc. It collects publicly reachable listing and shop surfaces and does not log in, checkout, place orders, or access private buyer/seller accounts. Login-only pricing and full review-pagination APIs are out of scope.

---

What does the Etsy Scraper do?

Etsy Scraper lets you extract structured listing and shop data from Etsy.com without running your own anti-bot browser fleet. Give it a keyword, category slug, listing ID, shop name, or featured path, then start a run.

Under the hood, the Actor:

1. Validates your input (mode, ship-to market, query / category / listing / shop, filters)
2. Enforces free-tier caps when you are on a free Apify plan
3. Calls a managed Cloud Run worker that opens Etsy with residential egress and browser automation
4. Parses SERP cards (DOM + optional listingCards intercept) and PDP JSON-LD
5. Pushes Dataset rows ready for Excel / CSV / JSON export
6. Writes RUN_SUMMARY (and ERROR_SUMMARY on failure) to the key-value store

You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations.

---

What Etsy data can I extract?

Data	Search	Shop search	Category	Listing PDP	Shop	Featured	Categories
listingId / URL	✅	—	✅	✅	✅	✅	—
Title / name	✅	shop	✅	✅	✅	✅	✅
Price / sale / original / % off	✅	—	✅	✅	✅	✅	—
Currency (by ship-to)	✅	—	✅	✅	✅	✅	—
shopName / shopUrl	✅	✅	✅	✅	✅	✅	—
imageUrl / images	✅	—	✅	✅	✅	✅	—
ratingValue / reviewCount	✅	—	✅	✅	shop meta	✅	—
badges / isAd	✅	—	✅	—	✅	✅	—
shipping / sales / years	enrich	—	enrich	✅	shop meta	enrich	—
variations / material	enrich	—	enrich	✅	—	enrich	—
categorySlug / path	—	—	✅	✅	—	—	✅

---

Why scrape Etsy?

Etsy is the leading marketplace for handmade, vintage, and craft goods. Teams scrape Etsy for price monitoring, competitor analysis, product research, and seller lead generation:

• Monitor Etsy search results and category PLPs across ship-to markets and currencies
• Track sale vs original price, discount %, Star Seller / ad badges, and ratings
• Pull shop listings with shop-level rating and sales text
• Map the category taxonomy (depth 2+) for assortment planning
• Enrich listings with PDP JSON-LD (images, availability, variations)
• Feed BI dashboards, pricing tools, or AI agents with structured Etsy rows

Compared with keyword-only Etsy scrapers, this Actor covers search + shop search + nested categories + PDP enrich + shops + featured + taxonomy with multi-market ship-to prefs in one input surface.

---

How to scrape Etsy listings (no code required)

1. Create a free Apify account
2. Open Etsy Scraper
3. Choose a shipTo market (e.g. US, GB, AU, DE)
4. Choose a mode: search, search_shops, category, listing, shop, categories, or featured
5. Enter a query, categorySlug (jewelry or jewelry/necklaces), listingId, shopName, or featuredPath
6. (Optional) Set order, priceMin / priceMax, starSeller, readyToShip, shipsFrom, enrichDetails, maxResults
7. Click Start and download the Dataset as JSON, CSV, Excel, or JSONL

Start with maxResults: 5–10 to verify the query, then scale up.

---

How much does it cost to scrape Etsy?

This Actor uses pay-per-event pricing. You are charged for:

Event	Price
Actor Start (apify-actor-start)	$0.005 per start
Result (apify-default-dataset-item)	$3.00 / 1,000 results ($0.003 each)

Platform usage costs are included — you do not pay separate Apify compute/proxy usage for this Actor on top of the event prices above (User pays platform usage costs = No).

Example cost estimates

Results collected	Approx. event cost*
100	~$0.31
1,000	~$3.01
10,000	~$30.01

*Assumes one Actor start at default memory billing for start events, plus $0.003 per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one).

Free plan limits

On a free Apify plan, this Actor enforces developer limits of 10 runs and 200 results per run. Upgrade to a paid Apify plan for unlimited runs (event prices still apply).

---

Input examples

Keyword search (US)

{
  "mode": "search",
  "query": "ceramic mug",
  "shipTo": "US",
  "maxResults": 40,
  "order": "price_asc",
  "starSeller": true
}

Nested category (GB)

{
  "mode": "category",
  "categorySlug": "jewelry/necklaces",
  "shipTo": "GB",
  "order": "price_asc",
  "maxResults": 30
}

Listing PDP enrich

{
  "mode": "listing",
  "listingId": "591039492",
  "shipTo": "US",
  "enrichDetails": true
}

Shop listings

{
  "mode": "shop",
  "shopName": "hardwoodcase",
  "shipTo": "US",
  "maxResults": 50
}

Search shops / featured

{
  "mode": "search_shops",
  "query": "woodworking",
  "shipTo": "US",
  "maxResults": 20
}

{
  "mode": "featured",
  "featuredPath": "/featured/hub",
  "maxResults": 20
}

---

Coverage matrix

Dimension	Coverage
Host	www.etsy.com
Markets (shipTo)	30+ ISO markets + ROW (prefs + proxyCountry)
Modes	search · search_shops · category · listing · shop · categories · featured
Category	/c/{slug} and nested /c/{a}/{b}
Sort	Verified: most_relevant · price_asc · price_desc · date_desc
Filters	price · instantDownload · shipsFrom · readyToShip · starSeller · freeShipping
Enrich	PDP JSON-LD + shipping / sales / years / images / variations
Identity	listingId

---

Output example

{
  "listingId": "1150212096",
  "title": "14 Color Ceramic Spoon Rest, Handmade Pottery",
  "price": 18.8,
  "salePrice": 18.8,
  "originalPrice": 47,
  "discountPercent": 60,
  "currency": "USD",
  "ratingValue": 4.8,
  "reviewCount": "3k",
  "imageUrl": "https://i.etsystatic.com/…/il_255x319….jpg",
  "shopName": "ZEEMRusticHomeDecor",
  "shopUrl": "https://www.etsy.com/shop/ZEEMRusticHomeDecor",
  "isAd": true,
  "badges": ["Ad"],
  "url": "https://www.etsy.com/listing/1150212096",
  "shipTo": "US",
  "recordType": "listing"
}

---

Runtime

Setting	Value
Default memory	1024 MB
Min / max memory	512 / 4096
Proxy	Worker-owned residential egress (WORKER_PROVIDES_PROXY=1)
Standby	Live View OpenAPI enabled

---

FAQ

Is this an official Etsy API?

No. This is an unofficial scraper for publicly reachable Etsy pages. It is not the Etsy Open API and is not affiliated with Etsy.

Why scrape Etsy instead of using the Open API?

The Open API requires seller OAuth apps and does not expose the same anonymous SERP / category / featured surfaces. This Actor targets public search, category, shop, and listing pages for market research workflows.

Can I scrape Etsy by category or shop?

Yes. Use mode=category with categorySlug (including nested paths like jewelry/necklaces), or mode=shop with shopName. mode=categories returns the taxonomy tree.

Does ship-to / currency work?

Yes. Set shipTo (e.g. GB, DE, AU). The worker applies locale/currency preferences and aligns residential egress to the market. Rows include currency when available (or filled from the market default).

Why did my free run stop?

Free-plan users get 10 runs and 200 results/run — a developer-set policy, not an Apify platform error. Upgrade to a paid Apify plan for unlimited runs (PPE event prices still apply).

DataDome / empty results?

Etsy blocks bare HTTP. The worker uses browser automation + residential egress. Hard blocks surface as worker status=blocked (HTTP 403), not silent empty success.

What is not included?

Login-only member pricing, full review pagination APIs, and official Open API access are out of scope.

---

Integrations

• Apify API / Python / JS client
• Make, Zapier, n8n, and other webhooks via Dataset / run events
• Schedules for recurring price or category monitors

---

Support

Questions or feature requests? Open an issue on the Actor page or contact the developer via Apify Console.