Telegram Channel Search: Find Posts by Keyword

What you can do with it

• Find mentions of a brand, token or project across the channels you follow.
• Search a list of news or community channels for a topic.
• Find channels that talk about your niche before buying ads.
• Collect posts about one topic from many channels at once.

What you get

Results come as rows in an Apify dataset, which you can export as JSON, CSV or Excel or read over the API. These are the main fields:

Pricing

This Actor is pay per event. Apify plan tiers set the price: the column for your Apify plan is what you pay, and higher plans pay less per result. Prices are per 1,000 events.

Run start fee: $0.05 per 1,000 runs. Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). Prices come from the Apify Store and can change; the Actor's Apify page always shows the current ones. Platform usage is billed through your Apify account.

Run it from code

Create an API token in Apify Console (Settings, API and Integrations) and replace YOUR_APIFY_TOKEN. This call starts a run with a small input and returns the rows when it finishes. Synchronous calls suit small inputs; for big jobs, start a run and read the dataset later.

curl

curl -X POST "https://api.apify.com/v2/acts/apisamurai~telegram-channel-search/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "channels": [
    "durov",
    "telegram"
  ],
  "keywords": [
    "update"
  ],
  "maxResultsPerSearch": 10
}'

Python (pip install apify-client)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
    "channels": ["durov", "telegram"],
    "keywords": ["update"],
    "maxResultsPerSearch": 10,
}

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

# Read the results from the run's default dataset.
items = client.dataset(run.default_dataset_id).list_items().items
for item in items:
    print(item)

JavaScript (npm install apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const input = {
    channels: ['durov', 'telegram'],
    keywords: ['update'],
    maxResultsPerSearch: 10,
};

// Start the Actor and wait for it to finish.
const run = await client.actor('apisamurai/telegram-channel-search').call(input);

// Read the results from the run's default dataset.
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Client calls follow the Python and JavaScript client docs. The full input reference is on the Actor's Apify page.

FAQ

Do I need a Telegram account?

No. The Actor reads public channel web previews.

Which channels work?

Channels with a public web preview, which is most public channels. Groups, bots and private channels are skipped.

Do rows include the full post?

Yes. Besides the snippet, rows include the full text, media, links, hashtags, reactions by emoji and the forward source.

I need every post, not just matches.

Use the Telegram Channel Scraper instead.

Where do I report a problem?

Email hello@apisamurai.com, or open an issue on the Actor's Apify page.