# Changelog of Etsy Scraper (`automation-lab/etsy-scraper`) Actor

- **URL**: https://apify.com/automation-lab/etsy-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/automation-lab/etsy-scraper.md

## Changelog

This changelog highlights releases that materially changed Etsy Scraper for users. Dates use UTC; small internal refactors and routine maintenance are intentionally omitted.

### 2026-09-05

*Features*

- Added nullable `reviewCount` values from Etsy search cards, making it easier to compare listing demand without slower listing-page requests.

*Changes*

- Removed the ineffective `category` selector and corrected pagination guidance. Put the desired niche directly in `searchQuery`; existing saved inputs that still include `category` continue to run as query searches.

### 2026-08-18

*Reliability*

- Prevented empty currency-filtered runs by aligning unspecified residential proxy countries with the requested currency. Explicit proxy-country choices remain unchanged.

### 2026-08-15

*Features*

- Added an optional listing-detail enrichment mode for seller activity, social proof, tags, materials, shipping, and personalization fields. Existing search behavior remains the default.

### 2026-06-27

*Features*

- Added ready-to-use public task examples for common Etsy scraping workflows.

### 2026-06-02

*Reliability*

- Restored Etsy search extraction after Etsy changed market page structured data.
- Improved extraction reliability so health-check searches return product items again.

### 2026-05-22

*Reliability*

- Improved listing detail probing and blocked-request recovery so runs finish more reliably when Etsy blocks individual listing pages.

### 2026-05-20

*Reliability*

- Improved variation fields and price-filtering reliability for product results.
- Variant fields now return booleans with a detection source, and runs include a scrape summary.
- Improved variation detection for listings whose size options are only visible after opening the listing page.

### 2026-05-14

*Safety*

- The Actor now respects Apify's maximum charge per run and stops cleanly when the configured spending cap is reached.

### 2026-05-11

*Features*

- Added currency and locale control, digital-download exclusion, keyword include/exclude filters, and variant price detection fields.
- Improved currency enforcement so results are filtered to the selected currency.
- Fixed min/max price filtering and improved pagination behavior when currency filters remove some listings.
- Deduplicated listings across pages and added sale/variation fields such as `originalPrice`, `onSale`, and `hasVariations`.

### 2026-03-22

*Features*

- Initial public release for scraping Etsy marketplace search listings with names, prices, shops, ratings, images, and availability.