# Changelog of TikTok Shop Scraper | Product Data Extractor API (`charitable_aquarium/tiktok-shop-scraper`) Actor

- **URL**: https://apify.com/charitable\_aquarium/tiktok-shop-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/charitable\_aquarium/tiktok-shop-scraper.md

## Changelog

### \[1.2.2] - 2026-04-02

#### Fixed

- **Critical**: Removed `page.evaluateOnNewDocument()` call (Puppeteer-only API, not available in Playwright)
- Fixed timeout warning: use `requestHandlerTimeoutSecs` instead of deprecated `handleRequestTimeoutSecs`
- Cleaned up preNavigationHooks to use only Playwright's `addInitScript()` API

### \[1.2.1] - 2026-04-02

#### Fixed

- Fixed TypeScript compilation errors
- Updated timeout property names for Crawlee v3.x (`handleRequestTimeoutSecs`)
- Fixed retryCount type handling in failedRequestHandler
- Fixed innerText type casting for DOM elements

### \[1.2.0] - 2026-04-02

#### Fixed

- Increased navigation timeout from 45s to 120s to prevent premature timeouts
- Added browser stealth configuration (webdriver spoofing)
- Changed TikTok search URL to use TikTok Shop endpoint (`/shop/search`)
- Reduced max retries to 2 to fail faster on blocks

### \[1.1.0] - 2026-04-02

#### Changed

- Updated actor version to 1.1 for release
- Package version bump to 1.1.0
- Expanded .gitignore to cover all test/build artifacts

### \[1.0.18] - 2026-03-03

#### Added

- Comprehensive extraction of engagement metrics: views, likes, shares, comments, saves
- Author metadata collection: username, nickname, and video creation time
- Detailed dataset schema with organized table views for all stats

#### Changed

- **Complete scraping rewrite**: replaced broken DOM selectors with TikTok internal API interception (`/api/search/general/`)
- Extracts structured JSON data: video description, author, views, likes, shares, comments, saves, hashtags, video URL, creation date
- DOM scraping kept as fallback only

### \[1.0.15] - 2026-03-03

#### Fixed

- Updated visual DOM selectors to match current TikTok layout (`search-card-video-caption`, `search-card-desc`)

### \[1.0.14] - 2026-03-03

#### Fixed

- Enforced residential proxy as default to prevent soft IP blocks
- Updated input schema to default to `RESIDENTIAL` proxy group

### \[1.0.13] - 2026-03-03

#### Fixed

- Dataset schema type error: removed invalid `array` format from hashtags display property
- Removed `output_schema.json` reference from `actor.json` that caused `clean` boolean type error

### \[1.0.11] - 2026-03-03

#### Fixed

- **Critical**: Switched Dockerfile base image from `apify/actor-node:22` to `apify/actor-node-playwright-chrome:22` (Chromium was missing)
- Proper two-stage Docker build: Stage 1 compiles TS with `tsc`, Stage 2 runs compiled JS

### \[1.0.5] - 2026-03-02

#### Added

- Output schema for structured result presentation
- Dataset schema with table view for product listings
- Key-value store schema for debug screenshots
- SEO-optimized actor metadata and description

#### Fixed

- Improved extraction reliability with `__UNIVERSAL_DATA_FOR_REHYDRATION__` payload parsing
- Better captcha/block detection with clear error reporting
- Switched to Playwright-based browser automation for stealth

### \[1.0.0] - 2026-03-02

#### Added

- Initial release of TikTok Shop Product Data Extractor
- Multi-keyword search support
- Configurable result limits and region targeting
- Proxy support including residential proxies
- JSON/CSV export via Apify dataset