# Telegram Keyword Search Scraper - Mention Alerts, No Login (`datalume/telegram-keyword-search-scraper`) Actor

Search public Telegram channels for any keyword from $1.50 per 1,000 matching posts - finds recent posts Google hasn't indexed, exact-phrase matching, only-new mode for mention alerts. No login or API key; posts that don't match are free.

- **URL**: https://apify.com/datalume/telegram-keyword-search-scraper.md
- **Developed by:** [Greg](https://apify.com/datalume) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 matching posts

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 Keyword Search Scraper - Mention Alerts, No Login

Find every public Telegram post that mentions your keyword - a brand, a coin, a product or a person. Give it keywords; it finds the channels that talk about them, searches inside each channel and returns only the posts that really contain your keyword. No Telegram account, phone number or API key.

**From $1.50 per 1,000 matching posts.** Posts that don't match, channels that can't be read and failed requests are free.

### What it does

1. **Finds channels for each keyword** using Google (`site:t.me "your keyword"`, all time + past week, plus a second results page when needed). If Google returns only a few channels, it also searches the channels that matching posts were forwarded from or link to - at no extra cost.
2. **Searches inside every channel** with Telegram's own channel search, page by page, newest first - so it also finds recent posts that Google hasn't indexed yet.
3. **Keeps only real matches.** Telegram's search also returns posts where the words appear separately. By default the Actor keeps posts that contain your keyword as written (case-insensitive) or as a #hashtag, and tells you how each post matched.
4. **Only new posts (mention alerts).** Turn it on and schedule the Actor: each run returns only posts published since the previous run - a feed of new mentions you pay for only once.

You can also add your own list of channels; they are searched for every keyword, with or without automatic finding.

### What makes it different

Compared with the 10 most-used Telegram keyword search Actors in Apify Store (checked 15 November 2026 from their public READMEs and pricing):

| | This Actor | Top 10 keyword search Actors |
|---|---|---|
| Searches inside each channel (finds posts Google hasn't indexed) | ✅ | 4 of 10 |
| Only new posts since the previous run | ✅ | 4 of 10 |
| Price per 1,000 results | $1.50 | $1 - $5 (most $2 - $5) |

Also included:

- **Exact-phrase check** - Telegram's search also matches the words separately; this Actor keeps only posts with your keyword as written or as a #hashtag and tells you how each post matched (`matchType`).
- **Channel discovery reused for 24 hours** - a scheduled hourly run pays the keyword discovery fee at most once a day.
- **Your own channel list** - add channels you already follow, with or without automatic discovery.
- **Free when nothing matches** - non-matching posts, unreadable channels and failed requests are not charged.

### Why search inside channels?

We compared the two approaches on 15 November 2026 with the same keywords (exact-phrase matches only):

| Keyword | Posts found via Google's index | Posts found by searching inside channels | Newest post via Google / inside channels |
|---|---|---|---|
| bitcoin ETF | 8 | 53 | 2025-12-03 / 2026-11-13 |
| Solana | 0 | 59 | - / 2026-11-12 |
| Hyperliquid | 28 | 102 | 2026-11-13 / 2026-11-13 |

Google mostly indexes channel pages, not single posts, and it lags behind new posts. This Actor uses Google only to discover channels and then reads the channels themselves.

Test run of this Actor on 15 November 2026 (keywords `bitcoin ETF`, `Solana`, `Hyperliquid`, 100 posts per keyword): **259 matching posts from 19 channels in 2 minutes**, newest post a few hours old, 98 posts from the last 7 days. 211 search results that did not contain the exact phrase were filtered out (and not charged).

### Input

| Field | What it does |
|---|---|
| **Keywords** | Words or phrases to find, e.g. `Hyperliquid`, `bitcoin ETF`. Each keyword is searched separately. |
| **Find channels automatically** | On by default. Uses Google to find channels for each keyword. |
| **Channels to search** | Optional. Usernames, `@username` or `t.me` links that are always searched. |
| **Max channels found per keyword** | How many discovered channels to search (default 10). |
| **Match** | `Exact phrase or #hashtag` (default), `All words, in any order`, or `Everything Telegram search returns`. |
| **Max posts per keyword / per channel** | Limits. Newest posts come first. |
| **Posts from / until** | A date (`2026-11-01`) or a period (`7 days`, `24 hours`). |
| **Only new posts (mention alerts)** | Return only posts published since the previous run. |
| **Add channel details** | Channel description, verified badge, photo and counters. |
| **Reuse found channels for (hours)** | Default 24. Channels found on Google are reused for this long; 0 = search Google on every run. |

Example:

```json
{
  "keywords": ["Hyperliquid", "bitcoin ETF"],
  "maxChannelsPerKeyword": 10,
  "matchMode": "phrase",
  "dateFrom": "7 days",
  "onlyNewPosts": false
}
```

### Output

One row per matching post (a post that matches two keywords appears once per keyword). A real row from a test run on 15 November 2026 (long text shortened):

```json
{
  "keyword": "Hyperliquid",
  "matchType": "phrase",
  "matchedText": "…yer on HIP-3* markets. Payward will use Hyperliquid as the infrastructure layer to deploy perpetual futures markets for …",
  "channel": "hyperliquid_announcements",
  "channelSource": "discovered",
  "channelTitle": "Hyperliquid Announcements",
  "channelSubscribers": 27000,
  "postId": 598,
  "postUrl": "https://t.me/hyperliquid_announcements/598",
  "date": "2026-10-26T17:36:53+00:00",
  "text": "Payward, the parent company of Kraken, announced its intention to be the first CFTC-regulated deployer on HIP-3* markets. Payward will use Hyperliquid as the in…",
  "views": 15200,
  "reactionsTotal": 236,
  "reactions": [{"emoji": "🔥", "count": 156, "paid": false}, {"emoji": "❤‍🔥", "count": 35, "paid": false}],
  "mediaType": "text",
  "photoUrls": [],
  "links": [],
  "hashtags": [],
  "forwarded": false,
  "scrapedAt": "2026-11-15T09:24:04+00:00"
}
```

`matchType` is `phrase`, `hashtag`, `allWords` or `telegram`. `channelSource` is `input` (your list), `discovered` (found on Google) or `expanded` (found in matching posts: forwarded from, linked or @mentioned). Run statistics per keyword (channels found, searched, skipped) are saved as `RUN_STATS` in the key-value store.

### Pricing

Pay per event:

| Event | Price |
|---|---|
| Matching post | $0.0015 (from $0.0012 on higher Apify plans) - $1.50 per 1,000 |
| Keyword discovery | $0.015 per keyword, only when Google is searched and at least one channel is found. Found channels are reused for 24 hours, so a scheduled keyword is charged at most once a day |
| Actor start | $0.00005 per GB of memory |

Example: 3 keywords with 100 matching posts each = 3 × $0.015 + 300 × $0.0015 = **$0.495**.

Mention alerts example: 1 keyword checked every hour with *Only new posts*, about 70 new matching posts a day = 30 × $0.015 + 2,100 × $0.0015 ≈ **$3.60 per month**.

Not charged: posts that don't match your keyword, duplicates, channels with the web preview turned off, failed requests, and keywords where no channel was found.

### Use cases

- **Brand and product monitoring** - schedule hourly with *Only new posts* and send new mentions to Slack, email or a webhook with Apify integrations. Channels found for a keyword are reused for 24 hours, so hourly runs don't pay for discovery again.
- **Crypto research** - who is talking about a coin or project, how many views and reactions the posts get.
- **Search your own channel list** - turn off automatic finding and add the channels you follow.
- **Last 7 days of mentions** - set *Posts from* to `7 days`.

### Limits

- Only public channels with the web preview (t.me/s/…) turned on. Private channels, group chats and comments are not available.
- Automatic finding depends on what Google has indexed; add channels you already know to make sure they are searched.
- Telegram's channel search matches words; the Actor then checks the exact phrase. Very short keywords (2-3 letters) can match many unrelated posts in `All words` / `Everything` modes.

### FAQ

**Do I need a Telegram account?** No. The Actor reads public web pages that anyone can open without logging in.

**Can it search all of Telegram?** No tool without an account can. This Actor covers the public channels it finds for your keyword plus any channels you add.

**Why did a run return no posts?** The status message says why: no channels found, no posts in the date range, no new posts since the last run, or search results that didn't contain the exact phrase (try `All words`).

> Need every post from specific channels, not just keyword matches? Use **[Telegram Channel Scraper](https://apify.com/datalume/telegram-channel-scraper)**.

### Tutorial

[How to Search Telegram for a Keyword Without Logging In (and Why Google Misses Most Posts)](https://dev.to/datalume/how-to-search-telegram-for-a-keyword-without-logging-in-and-why-google-misses-most-posts-2oe9) — Google `site:t.me` vs searching inside channels, measured on the same keywords, and the traps in exact-phrase matching.

### Feedback

If this Actor saved you time, a short review on the Store page helps others find it. If something is off, please open an issue first so I can fix it.

### More from datalume

Reliable public-data scrapers - verified results, no charge for failures: **[apify.com/datalume](https://apify.com/datalume)**

***

*This Actor is not affiliated with, endorsed by or sponsored by Telegram or Google. "Telegram" is a trademark of Telegram FZ-LLC. It collects publicly available channel posts only.*

# Actor input Schema

## `keywords` (type: `array`):

Words or phrases to find in public Telegram channels, e.g. a brand, coin, product or person. Each keyword is searched separately; phrases like bitcoin ETF are matched as a whole phrase by default.

## `discoverChannels` (type: `boolean`):

Find public channels that talk about each keyword using Google (site:t.me), then search inside them. If Google returns few channels, channels that matching posts were forwarded from or link to are searched too. Charged once per keyword only when Google is searched and at least one channel is found; found channels are reused for 24 hours.

## `channels` (type: `array`):

Optional. Public channels that are always searched for every keyword: username, @username or t.me link. Use this alone (with automatic finding turned off) to search only your own channel list.

## `maxChannelsPerKeyword` (type: `integer`):

How many automatically found channels (Google + channels found in matching posts) are searched for each keyword. Your own channels are always searched.

## `matchMode` (type: `string`):

Telegram's own search also returns posts where the words appear separately. 'Exact phrase' keeps only posts that contain the keyword as written (case-insensitive) or as a #hashtag. Every row says how it matched in matchType.

## `maxPostsPerKeyword` (type: `integer`):

Stop collecting a keyword after this many matching posts. 0 = no limit.

## `maxPostsPerChannel` (type: `integer`):

Matching posts per channel and keyword. Newest posts come first.

## `dateFrom` (type: `string`):

Optional. A date (2026-11-01) or a period like '7 days', '2 weeks', '24 hours'.

## `dateTo` (type: `string`):

Optional. A date (2026-11-15) or a period like '1 day'.

## `onlyNewPosts` (type: `boolean`):

Return only posts published since the previous run of this keyword in each channel. Schedule the Actor (e.g. every hour) to get a feed of new mentions and pay only for what is new.

## `includeChannelInfo` (type: `boolean`):

Channel description, verified badge, photo and counters in a channelInfo field.

## `discoveryCacheHours` (type: `integer`):

Channels found on Google for a keyword are reused for this many hours, so scheduled runs search Google (and charge keyword discovery) at most once per period. 0 = search Google on every run.

## `proxyConfiguration` (type: `object`):

Not needed in most cases. If Telegram slows the run down, it switches to Apify datacenter proxy automatically.

## Actor input object example

```json
{
  "keywords": [
    "Hyperliquid"
  ],
  "discoverChannels": true,
  "channels": [],
  "maxChannelsPerKeyword": 5,
  "matchMode": "phrase",
  "maxPostsPerKeyword": 10,
  "maxPostsPerChannel": 50,
  "onlyNewPosts": false,
  "includeChannelInfo": false,
  "discoveryCacheHours": 24,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `posts` (type: `string`):

One row per matching post: keyword, channel, date, matched text, views, reactions.

## `full` (type: `string`):

Full post text, photos, videos, links, hashtags and mentions.

## `runStats` (type: `string`):

Channels found and searched per keyword, pages, charged posts.

# 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 = {
    "keywords": [
        "Hyperliquid"
    ],
    "channels": [],
    "maxChannelsPerKeyword": 5,
    "maxPostsPerKeyword": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("datalume/telegram-keyword-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 = {
    "keywords": ["Hyperliquid"],
    "channels": [],
    "maxChannelsPerKeyword": 5,
    "maxPostsPerKeyword": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("datalume/telegram-keyword-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 '{
  "keywords": [
    "Hyperliquid"
  ],
  "channels": [],
  "maxChannelsPerKeyword": 5,
  "maxPostsPerKeyword": 10
}' |
apify call datalume/telegram-keyword-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datalume/telegram-keyword-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/W2WybiiWOsg89Rsf1/builds/uWMq0PNHKGuAC0Sw6/openapi.json
