Telegram Channel and Group Directory Scraper (tgstat, telegramic)

Collects Telegram channel and group listings from two public directories, tgstat and telegramic, and returns them in one row shape. Each row has the name, @handle, t.me link, category and member count, plus growth, post reach, language and country where the directory reports them.

---

Telegram Directory Scraper Features

• Combine tgstat rankings and the telegramic directory in a single run and a single dataset
• Choose channels, groups or both
• Filter by category with one list that works across both directories
• Read tgstat's regional rankings for Ukraine, Belarus, Uzbekistan, Kazakhstan, Kyrgyzstan, Iran, China, India and Ethiopia
• Pull growth rankings (today, yesterday, 7 days, 30 days) to see which channels are rising
• Get post reach and citation index for tgstat channels, monthly active users and weekly messages for tgstat groups
• Get language, about text and user rating for telegramic listings
• Export a clean t.me link and handle for every public listing

---

Who needs Telegram directory data?

• OSINT and social-graph analysts - map the biggest channels and groups in a topic or a country
• Growth marketers - find audiences by language, category and size before buying or partnering
• Crypto and fintech community trackers - follow which communities are gaining members
• Researchers - build a sample of channels per category and region with comparable counts
• Lead and outreach teams - assemble a list of public communities with their handles

---

How Telegram Directory Scraper Works

1. You pick the directories, channel or group, categories, countries and ranking orders.
2. The actor reads each matching listing page and collects every entry on it.
3. For telegramic, it opens each entry to read the member count, language and about text.
4. Duplicates are removed and every row is returned in the same shape, tagged with its source directory.

---

Input

{
    "sources": ["tgstat", "telegramic"],
    "groupTypes": ["channel", "group"],
    "categories": ["crypto"],
    "regions": ["global"],
    "rankings": ["members"],
    "maxItems": 15
}

Field	Type	Default	Description
sources	array	["tgstat", "telegramic"]	Directories to read. Empty means both.
groupTypes	array	["channel", "group"]	Channels, groups or both. Empty means both.
categories	array	["crypto"]	Categories to keep. A directory without the category you pick adds nothing for it. Empty means all.
regions	array	["global"]	tgstat country rankings. Each row records the country it was ranked in. Not used for telegramic.
rankings	array	["members"]	tgstat ranking orders. Each one surfaces a different top 100. Not used for telegramic.
maxItems	integer	15	Maximum number of listings to return.
resumeCursor	string	none	Cursor from a previous run's Output, to continue a crawl that stopped early.

tgstat lists the top 100 for each combination of country, channel or group, category and ranking. To go wide, select more categories, countries and ranking orders. telegramic lists every page of each category.

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes, because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted, start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window. On the free tier, that is roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque, so supply it unmodified.

---

Telegram Directory Scraper Output Fields

{
    "source_directory": "tgstat",
    "listing_id": "blumcrypto",
    "group_name": "Blum: All Crypto – One App",
    "telegram_handle": "blumcrypto",
    "telegram_url": "https://t.me/blumcrypto",
    "description": null,
    "category": "Cryptocurrencies",
    "language": null,
    "country": null,
    "member_count": 13323823,
    "member_growth": null,
    "growth_period": null,
    "average_post_reach": 123900,
    "citation_index": 3309,
    "monthly_active_users": null,
    "messages_7d": null,
    "rating": null,
    "is_channel": true,
    "source_url": "https://tgstat.com/ratings/channels/crypto?sort=members"
}

Field	Type	Description
source_directory	string	tgstat or telegramic
listing_id	string	The directory's identifier for the listing (the handle when public)
group_name	string	Channel or group name
telegram_handle	string	Telegram handle without the at sign. Empty for private tgstat listings
telegram_url	string	t.me link. Empty for private tgstat listings
description	string	About text. telegramic only
category	string	Category as the directory labels it
language	string	Language the directory reports. telegramic only
country	string	Country of the tgstat regional ranking the listing was found in
member_count	integer	Members or subscribers
member_growth	integer	Member change over growth_period. Present when a tgstat growth ranking was read
growth_period	string	Window member_growth covers: today, yesterday, 7d or 30d
average_post_reach	integer	Average views of a channel post. tgstat channels only
citation_index	number	tgstat citation index. tgstat channels only
monthly_active_users	integer	Monthly active members. tgstat groups only
messages_7d	integer	Messages posted in the last 7 days. tgstat groups only
rating	number	Average user rating out of 5. telegramic only
is_channel	boolean	true for a channel, false for a group
source_url	string	Directory page the listing was read from

Fields marked with one directory are empty for the other. A listing that appears in more than one growth window or country is returned once per window and country, so the figures stay comparable.

---

FAQ

How do I scrape tgstat and telegramic with Telegram Directory Scraper?

Telegram Directory Scraper needs no account and no API key. Choose the directories, whether you want channels or groups, and the categories. Run it and it returns one dataset in a single shape.

What data can I get from tgstat and telegramic?

Telegram Directory Scraper returns name, handle, t.me link, category and member count for every listing. tgstat adds growth, post reach, citation index, monthly active users and weekly messages. telegramic adds language, about text and user rating.

Can I filter by category or country?

Yes. Telegram Directory Scraper takes a category list that is translated to each directory's own categories, and a country list that selects tgstat's regional rankings. Language is reported by telegramic but is not available as a filter.

How many listings can one run return?

tgstat shows the top 100 for each combination of country, channel or group, category and ranking order, so combining more of those returns more. telegramic lists every page of each category, which is roughly 1,800 channels and 500 groups for the unfiltered lists.

Does it include private channels?

Private tgstat channels appear with their name and counts but without a handle or t.me link, because they have none.

---

Need More Features?

Need another directory or another field? Send a request through the actor's Issues tab.

Why Use Telegram Directory Scraper?

• One row shape for two directories - rankings and browse listings arrive in the same fields with the source tagged
• Growth, reach and activity where they exist - tgstat's ranking statistics are kept, not flattened away
• Wide coverage from simple inputs - categories, countries and ranking orders multiply the listings you reach
• Clean output - numbers are real numbers, handles and t.me links are separate fields, duplicates are removed