Changelog
2025-03-29 / v1.3.1
🚀 Improved proxy handling to prevent excessive logs and infinite loops
⏱️ Reduced ad details timeout from 8s to 5s for faster processing
🚄 Increased parallel processing to 12 ads for faster scraping
🔥 Optimized performance while maintaining reliability
🔄 Added state persistence to handle Apify host migrations
2025-03-24 / v1.2.4
⏰ Added minimum date validation (2022-10-01) for TikTok Ads Library
🎨 Improved logs readability with better formatting
⚠️ Added warning message for dates before 2022-10-01
2025-03-20 / v1.1.8
🧙♂️ Added circuit breaker pattern to avoid problematic proxies
⚡ Reduced request timeout from 10s to 5s for faster error recovery
🦄 Implemented intelligent session management with shorter session IDs
2025-03-19 / v1.0.5
🔄 Fixed pagination issue by setting API limit to 12 to match TikTok's actual response limit
2025-03-15 / v0.9.4
🚫 Added proper handling for empty results with user-friendly messages
🖼️ Enhanced media URL retrieval from details API when missing in search results
2025-03-11 / v0.8.6
🔗 Added direct links to ad detail pages for each ad
👥 Enhanced targeting data with detailed region, age, and gender information
💰 Added "Ad paid for by" sponsor information for better transparency
⚡ Optimized performance with parallel processing for faster data extraction
2025-03-09 / v0.6.1
🚀 First stable release of TikTok Ads Library Scraper with comprehensive ad data extraction
🏗️ Structured data format with standardized fields for easy analysis
🔍 Advanced search capabilities: keyword, exact match, and advertiser ID search options
🌐 Support for all TikTok-supported regions with region-specific targeting
🖼️ Complete media asset extraction including videos and cover images