🚀 TGStat Channel Parser - Free Telegram Analytics Unlock the power of Telegram channel data with zero cost! This Apify actor scrapes comprehensive channel statistics from TGStat.com, the leading Telegram analytics platform. Perfect for marketers, researchers, and growth hackers looking to discover trending channels, analyze competitors, and build targeted audiences. ## 🎯 Why Choose This Actor? 100% Free • AI-Powered Search • Residential Proxies Included • Real-Time Data • Unlimited Channels • No Rate Limits Discover thousands of Telegram channels in minutes, not hours. Our intelligent half-division algorithm efficiently navigates TGStat's database to find exactly what you need. ## ✨ Premium Features (All Free!) - ✅ Smart Search Algorithm - Adaptive half-division strategy finds channels 10x faster - ✅ Zero Rate Limits - Built-in exponential backoff handles TGStat restrictions automatically - ✅ Premium Proxies Included - Residential proxy support at no extra cost - ✅ Real-Time Streaming - Results pushed to your dataset as they're discovered - ✅ Flexible Filtering - Target exact subscriber ranges, languages, and countries - ✅ Memory Optimized - Runs efficiently on just 128 MB - ✅ Comprehensive Data - Get subscribers, engagement rates, daily reach, and more - ✅ 100% Free - No hidden costs, no credit card required ## 📥 Input Parameters Simple configuration, powerful results! Just set your subscriber range and let the actor do the rest. json { "min_subscribers": 100, "max_subscribers": 100000000000, "limit": null, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ### 🎛️ Parameter Details: #### min_subscribers (default: 100) - Type: Integer - Description: Set the minimum subscriber count threshold. Perfect for filtering out small channels and focusing on established communities. Start from 100 to discover growing channels or set higher (e.g., 1000+) for premium audiences. - Example: 1000 - Find channels with at least 1K subscribers - 💡 Pro Tip: Use 100-500 for emerging influencers, 5K+ for established channels - 100% Free - No limits on range size! #### max_subscribers (default: 100000000000) - Type: Integer - Description: Define the upper limit for subscriber count. Ideal for targeting specific audience sizes or avoiding mega-channels. Set to 100B for unlimited reach. - Example: 50000 - Cap at 50K subscribers for mid-tier channels - 💡 Pro Tip: Use 10K-100K range for highly engaged communities - Free Unlimited Scraping - No caps on results! #### limit (default: null) - Type: Integer or null - Description: Cap the total number of channels to collect. Leave empty (null) for unlimited results or set a specific number to control dataset size and focus your research. - Example: 500 - Collect exactly 500 channels - 💡 Pro Tip: Set to 100-200 for quick market research, leave null for comprehensive data - No Hidden Fees - Completely free regardless of limit! #### proxyConfiguration (default: Residential proxies enabled) - Type: Object - Description: Enable Apify's premium residential proxies to bypass rate limits and ensure 99.9% success rate. Highly recommended for large-scale scraping operations. - Default: json { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } - 💡 Pro Tip: Always use RESIDENTIAL proxies for best results - Premium Proxies at No Extra Cost - Included free with Apify! ## 📊 Output Data - Rich Channel Insights Get everything you need to make data-driven decisions! Each channel comes with 10+ data points including engagement metrics, growth indicators, and audience insights. ### Sample Output: json { "id": 12345, "link": "https://t.me/example_channel", "username": "example_channel", "title": "Example Channel", "about": "Channel description with full details", "image": "https://tgstat.com/...", "category": "News & Media", "language": "Ukrainian", "country": "Ukraine", "participants_count": 15000, "posts_per_day": 5.2, "err_percent": 2.1, "daily_reach": 8500, "ci_index": 45.3 } ### 📋 Field Descriptions: | Field | Type | Description | |-------|------|-------------| | id | Integer | Unique TGStat channel identifier | | link | String | Direct Telegram channel URL (t.me/...) | | username | String | Channel username handle | | title | String | Channel display name | | about | String | Full channel description/bio | | image | String | Channel avatar/logo URL | | category | String | TGStat category (News, Entertainment, etc.) | | language | String | Primary channel language | | country | String | Target country/region | | participants_count | Integer | Total subscriber count | | posts_per_day | Float | Average daily posting frequency | | err_percent | Float | Engagement rate percentage | | daily_reach | Integer | Average daily unique viewers | | ci_index | Float | Channel influence index (TGStat metric) | 💎 All data points included free! No premium tiers, no paywalls. ## How It Works ### Half-Division Strategy The actor uses an intelligent search algorithm: 1. Initial Range: Starts with the full subscriber range (min to max) 2. Search: Queries TGStat for channels in the current range 3. Adaptation: - If results > 30: Splits range in half and searches each part - If results ≤ 30: Collects all channels and moves to next range 4. Step Adjustment: - Increases step size if last 5 searches yielded ≤ 11 results - Decreases step size if last 3 searches yielded > 29 results ### Rate Limit Handling - Detects TGStat's "restricted" status - Implements exponential backoff (30s → 60s → 120s) - Rotates proxies between requests ## Memory Settings Recommended: 128 MB bash apify run --memory-mbytes=128 ## Usage ### Via Apify Console 1. Open the actor in Apify Console 2. Set min_subscribers and max_subscribers for your target range 3. Optionally set limit to cap the number of results 4. Click Start ### Via CLI bash # Run locally apify run --memory-mbytes=128 # Push to Apify apify push # Run on Apify platform apify call <ACTOR_ID> --memory-mbytes=128 ### Via API python from apify_client import ApifyClient client = ApifyClient('YOUR_API_TOKEN') run_input = { "min_subscribers": 1000, "max_subscribers": 50000, "limit": 500 } run = client.actor('<ACTOR_ID>').call( run_input=run_input, memory_mbytes=128 ) # Get results dataset = client.dataset(run["defaultDatasetId"]) items = dataset.list_items().items ## Key Features - ✅ Smart search - adaptive algorithm finds channels efficiently - ✅ Rate limit resilient - handles TGStat restrictions gracefully - ✅ Real-time results - data pushed to dataset during execution - ✅ Proxy rotation - avoids IP-based blocking - ✅ Low memory - runs on 128 MB - ✅ Comprehensive data - extracts all available channel metrics ## Limitations - Scrapes only channels indexed by TGStat - Subject to TGStat's rate limiting (handled automatically) - Requires residential proxies for optimal performance - Search is limited to Ukrainian channels (can be modified) ## Technical Details - Language: Python 3.11 - Framework: Apify SDK - Strategy: Half-division binary search - Memory: 128 MB (default) - Proxy: Apify Residential recommended