🚀 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.

{
  "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:

  {
    "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:

{
  "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

$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

# 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

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