# Telegram Channel Search and Telegram Group Search Scraper (`cleanscrape/telegram-channel-search-scraper`) Actor

Telegram channel search and Telegram group search by topic or keyword: a Telegram channel finder returning each public channel or group with link, exact subscribers, description, latest post date and verified mark. No login. $2.50 per 1,000 channels plus $0.01 per topic. Maintained by CleanScrape.

- **URL**: https://apify.com/cleanscrape/telegram-channel-search-scraper.md
- **Developed by:** [CleanScrape](https://apify.com/cleanscrape) (community)
- **Categories:** Social media, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 channels

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Telegram Channel Search and Telegram Group Search Scraper

Find public Telegram channels and groups by topic or keyword. Type a topic such as "forex trading" and get one row per channel: name, link, exact subscriber count, description, the date of its latest post and the verified mark. Every row is read from Telegram's own public page for that channel. No login, phone number, bot token or API key.

Telegram has no public channel search of its own. This Actor finds channels through Google's index of Telegram's public pages, then opens each one on Telegram to confirm it is a live public channel or group and to read its details.

**$2.50 per 1,000 channels plus $0.01 per topic searched.** The form's first run (one topic, up to 30 channels) cost $0.04 to $0.07 in tests and cannot cost more than $0.085.

### Start with a small run

1. The form opens with the topic **forex trading**. Keep it, or type your own topics, one per line.
2. **Channels per topic** starts at 30. A topic often has fewer.
3. Start the run and open **Channels** in the Output tab. Export CSV, Excel or JSON.

A channel is kept when at least half of the topic words are in its name or description. Under **Filters** you can turn that off to also get channels that only mention the topic in their posts, or set a minimum number of subscribers.

### Choose a ready-to-run example

Each example opens with its input filled in. Change the input and run it.

| Example | What it does |
| --- | --- |
| [Find Telegram channels about a topic](https://apify.com/cleanscrape/telegram-channel-search-scraper/examples/find-telegram-channels-by-topic) | Channels and groups about forex trading with subscribers, description and latest post date. Replace the topic with yours. |
| [Find large Telegram channels in a niche](https://apify.com/cleanscrape/telegram-channel-search-scraper/examples/find-large-telegram-channels-in-a-niche) | Channels with at least 10,000 subscribers for three topics, for outreach or advertising lists. |
| [Find public Telegram groups by keyword](https://apify.com/cleanscrape/telegram-channel-search-scraper/examples/find-public-telegram-groups-by-keyword) | Public groups for two keywords, with member counts and members online. |

### Writing topics that work

- Use the words a channel would use about itself: "crypto signals", "vegan recipes", "real estate dubai".
- Write the topic in the channels' language. "вакансии python" finds Russian job channels; "python jobs" finds English ones. The topic words are compared with each channel's name and description, so a topic in English will not keep channels that describe themselves in another language.
- Two or three words work better than one very broad word or a long sentence.
- A topic is not a channel name. To read the posts of channels you already know, use the [Telegram Channel Messages Scraper with Comments](https://apify.com/cleanscrape/telegram-channel-messages-scraper).

### Use it from the API

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("cleanscrape/telegram-channel-search-scraper").call(run_input={
    "topics": ["forex trading", "crypto signals"],
    "maxResults": 30,
    "minSubscribers": 1000,
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["subscribers"], row["username"], row["title"])
```

### Input

| Field | Default | What it does |
| --- | --- | --- |
| `topics` | Required | Topics or keywords, one per entry. Up to 100 per run |
| `maxResults` | `30` | The most channels and groups to save per topic (1 to 200) |
| `kind` | `both` | `both`, `channel` or `group` |
| `minSubscribers` | `0` | Skip smaller channels and groups |
| `onlyNameMatches` | `true` | Keep a channel only when at least half of the topic words are in its name or description. `false` also keeps channels matched through their posts |
| `lastPostDate` | `true` | Add the date of each channel's latest post |
| `country` | `us` | Two-letter country code for the Google search behind the discovery |

### Output

One row per channel or group. A channel found by several topics is saved once.

| Field | What it is |
| --- | --- |
| `username`, `url` | The public name and its t.me link |
| `kind` | `channel` or `group` |
| `title`, `description` | Name and description from the channel's Telegram page |
| `subscribers` | Exact subscribers of a channel, or members of a group, when the run read the page |
| `onlineMembers` | Groups only: members online at that moment |
| `verified` | Telegram's verified mark |
| `lastPostAt` | When the channel last posted (UTC). Null for groups and for channels without a public preview |
| `hasPublicPreview` | Whether the channel's posts can be read in a browser without Telegram |
| `photoUrl` | Link to the channel picture. Telegram's picture links expire |
| `topic` | The topic that found the channel |
| `matchedIn` | `name`, `description` or `posts`: where the topic words appear |
| `searchPosition` | Order in which the search found it, 1 first |
| `recordId` | The username in lowercase, a stable key across runs |
| `fetchedAt` | When the run read the channel's page (UTC) |

`matchedIn` tells you how close a match is. `name` and `description` mean the channel describes itself with your topic. `posts` means Google matched it through what it posts and the topic words are not in its name or description. Such rows are saved only when you turn off **Only channels with the topic in their name or description**; in a test with "forex trading", 3 of 26 channels were of this kind and all three were unrelated to forex.

The run report (`SUMMARY` in the key-value store) lists every topic with the channels saved, how many names were checked, what was skipped and why the topic ended.

### What it can and cannot find

- It finds channels and groups that Google has indexed from Telegram's public pages. A channel that is never linked from the open web, or is very new, can be missing.
- Private channels, invite-only groups, bots and personal accounts are not returned.
- Most topics give 5 to 30 channels. In a test of 20 topics on November 15, 2026, 9 reached 10 channels or more and the others gave 2 to 8. Asking for 200 does not make more exist: the broad topic "crypto" gave 32.
- Results differ between runs, because Google's results do. Two runs of "forex trading" a few minutes apart gave 13 and 25 channels, 11 of them the same. Run a topic again, or word it a second way, to collect more.
- The order is Google's, not a ranking by size. Sort by `subscribers` in your export for the biggest first.
- Subscriber counts are exact at the time of the run. View counts, growth history and audience statistics are not included.
- A group's row has no latest post date: Telegram shows no public preview for groups.

### Pricing

| Event | Price |
| --- | --- |
| Channel saved | $0.0025 ($2.50 per 1,000) |
| Topic searched | $0.01 per topic, also when no channel was found |

You pay for the two events only. Apify platform usage is included. Paid Apify plans get a discount on both events (Bronze 10%, Silver 15%, Gold and higher 20%).

Examples:

- One topic, 30 channels: $0.01 + 30 × $0.0025 = $0.085.
- Five topics, 20 channels each: $0.05 + 100 × $0.0025 = $0.30.
- A topic with nothing on Telegram: $0.01.

Not charged: names that turn out to be bots, people or dead links, channels removed by your filters, a channel already saved for another topic in the same run, and topics the search could not be run for.

The run stops at the **Maximum cost per run** you set and says so.

### Speed

One topic takes 45 to 80 seconds. Twenty topics with 10 channels each took just under 4 minutes in a test. Three topics are searched at a time. Google's answers are the slow part and vary; each channel's Telegram page takes about half a second.

### Common questions

#### Does Telegram have an official API for this?

Telegram's API can search channels by name only when you sign in with a phone number and create an app. This Actor needs no account. It reads the same public pages a browser shows.

#### Can I export the results to Excel or CSV?

Yes. Open the Output tab and choose Export, or fetch the dataset through the API in CSV, Excel, JSON or XML.

#### Why did a topic return fewer channels than I asked for?

The limit is a maximum. The search stops when Google has no more new Telegram channels for the topic. Try a second wording of the topic, or the topic in another language, as separate topics.

#### Why is a channel in the results that does not look related?

A channel is kept when at least half of the topic words are in its name or description, so a channel that shares one common word with a two-word topic can get in. Use a more specific topic, or filter the export on the name. If you turned off **Only channels with the topic in their name or description**, rows marked `posts` in `matchedIn` are the loose matches.

#### Do I need to log in or give a phone number?

No. Nothing in this Actor uses a Telegram account.

#### Can I find private channels or group members?

No. Only public channels and groups, and only channel-level facts. No members, no message authors.

#### Can I search for the same topics every week?

Yes. Save the input as a task and add a schedule. `recordId` stays the same for a channel, so new channels are easy to spot by comparing exports.

#### Is it legal to collect this data?

The Actor reads pages that Telegram and Google publish to everyone, and returns facts about channels, not about people. You are responsible for how you use the data and for following the laws and terms that apply to you.

### Support

Questions or a result that looks wrong: open an issue on the Issues tab or email contact.cleanscrape@gmail.com. Include the run ID.

If the Actor was useful, an honest review on its Store page helps other people find it.

This Actor is not affiliated with, endorsed by or sponsored by Telegram or Google.

Maintained by CleanScrape.

### More tools from CleanScrape

- [App Store Reviews & Google Play Reviews Scraper (Play Store)](https://apify.com/cleanscrape/app-store-reviews-scraper): reviews from both app stores in one table
- [Google Trends Scraper API for Interest Over Time](https://apify.com/cleanscrape/google-trends-scraper): search interest over time, by region, related queries and trending searches
- [Map Your Show Exhibitor List Scraper for Trade Shows](https://apify.com/cleanscrape/event-exhibitor-monitor): trade show exhibitor lists and booth changes
- [Shopify Product Reviews Scraper for Judge.me and Okendo](https://apify.com/cleanscrape/shopify-reviews-scraper): Judge.me and Okendo reviews from Shopify product links
- [Google News Scraper and RSS Feed Reader](https://apify.com/cleanscrape/google-news-scraper): headlines from Google News and publisher feeds
- [Pinterest Scraper API for Pins and Pinterest Keyword Search](https://apify.com/cleanscrape/pinterest-scraper): keyword search, public pin links and board previews; search results may lack a pin link
- [Google Hotels Scraper for Google Travel Hotel Prices](https://apify.com/cleanscrape/google-hotels-scraper): hotel prices and booking offers for your dates
- [TikTok Shop Scraper API for Products, Prices and Sales](https://apify.com/cleanscrape/tiktok-shop-product-scraper): US TikTok Shop prices, sellers and ratings
- [Meta Threads Scraper for Posts and Replies](https://apify.com/cleanscrape/threads-scraper): public Threads posts from accounts or post links
- [Likee Scraper API](https://apify.com/cleanscrape/likee-scraper): Likee videos and comments
- [Flashscore Tennis Scraper for Tennis Matches and Stats](https://apify.com/cleanscrape/tennis-match-data): tennis results, statistics, point-by-point and head-to-head
- [Bilibili Scraper for Videos, Comments, Danmaku, Creators](https://apify.com/cleanscrape/bilibili-scraper): Bilibili videos, danmaku, comments and creators
- [Google Jobs Scraper for Job Search and Job Listings API](https://apify.com/cleanscrape/google-jobs-scraper): job listings with salaries and apply links
- [Whatnot Seller Tracker for Top Sellers and Sales](https://apify.com/cleanscrape/whatnot-seller-tracker): top sellers per category, items sold, sales per day and followers over time
- [Whatnot Scraper for Listings and Live Shows](https://apify.com/cleanscrape/whatnot-scraper): Whatnot listings with prices and seller stats, and live shows
- [Kick Sponsor Tracker for Streamers, Brands and Promo Codes](https://apify.com/cleanscrape/kick-sponsor-tracker): which Kick streamers promote which brands, with codes and broadcast hours
- [Casino Bonus Checker for Affiliate and Review Sites](https://apify.com/cleanscrape/casino-bonus-checker): the casino bonus each affiliate and review site shows, with promo codes, 18+ notices and affiliate IDs
- [ATP and WTA Tennis Rankings Scraper](https://apify.com/cleanscrape/tennis-rankings-scraper): current ATP and WTA singles, doubles and race rankings with points and movement
- [Career Site Job Listings from Workday, Greenhouse and Lever](https://apify.com/cleanscrape/career-site-jobs-scraper): open jobs from company career pages, with salaries and new or closed jobs per company
- [Video Frame Extractor for Scene Changes and Thumbnails](https://apify.com/cleanscrape/video-frame-extractor): still images from video files at scene changes, intervals or timestamps, with contact sheets
- [Economic Calendar Scraper for Official Release Dates](https://apify.com/cleanscrape/economic-calendar-api): central bank decisions and economic releases with dates and times
- [Audio Transcription and Speech to Text for Podcasts](https://apify.com/cleanscrape/podcast-transcription): podcast episodes and audio files to text with timestamps and subtitles
- [Google Flights Scraper and Fare Tracker](https://apify.com/cleanscrape/google-flights-scraper): flight prices by route and date, with fare tracking
- [Google Shopping Scraper and Price Tracker](https://apify.com/cleanscrape/google-shopping-scraper): product prices, stores and ratings from Google Shopping, each store’s price for a product, and price changes on a schedule
- [Telegram Channel Messages Scraper with Comments](https://apify.com/cleanscrape/telegram-channel-messages-scraper): public Telegram channel posts with views, reactions and comments
- [Google Trends Trending Now Scraper for Trending Searches](https://apify.com/cleanscrape/google-trends-trending-now): every search trending on Google now, per country, with volume and related searches
- [App Store Search and Google Play Search Scraper](https://apify.com/cleanscrape/app-store-google-play-search-scraper): apps for a keyword in the App Store and Google Play, in store order, with ratings, installs and developer contact

# Actor input Schema

## `topics` (type: `array`):

What the channels should be about, one topic per line: a few words such as "forex trading", "vegan recipes" or "вакансии python". Write the topic in the language the channels use.

## `maxResults` (type: `integer`):

The most channels and groups to save for each topic. A topic often has fewer: the search finds what Google lists on Telegram's public pages.

## `kind` (type: `string`):

Channels broadcast posts to subscribers. Groups are public chats with members.

## `minSubscribers` (type: `integer`):

Skip channels with fewer subscribers and groups with fewer members. 0 keeps all.

## `onlyNameMatches` (type: `boolean`):

On: keeps a channel when at least half of the topic words are in its name or description. Off: also keeps channels that Google matched through their posts only (marked "posts" in the Matched in column); some of those are unrelated to the topic.

## `lastPostDate` (type: `boolean`):

Reads each channel's public preview to tell when it last posted, so dead channels are easy to spot. Turn off for a slightly faster run. No extra charge.

## `country` (type: `string`):

Two-letter country code for the Google search behind the discovery, such as us, gb, de, in or br. It shifts which channels come first; it does not limit channels to that country.

## Actor input object example

```json
{
  "topics": [
    "forex trading"
  ],
  "maxResults": 30,
  "kind": "both",
  "minSubscribers": 0,
  "onlyNameMatches": true,
  "lastPostDate": true,
  "country": "us"
}
```

# Actor output Schema

## `channels` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "topics": [
        "forex trading"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("cleanscrape/telegram-channel-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "topics": ["forex trading"] }

# Run the Actor and wait for it to finish
run = client.actor("cleanscrape/telegram-channel-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "topics": [
    "forex trading"
  ]
}' |
apify call cleanscrape/telegram-channel-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,cleanscrape/telegram-channel-search-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ZYQ5PjardmSj0pMAm/builds/i6x4rLDbOcY5O5vKl/openapi.json
