# Telegram Keyword Search Scraper: Posts From Public Channels (`themineworks/telegram-keyword-search-scraper`) Actor

Search public Telegram channel posts by keyword: post text, channel, subscribers, date, views, reactions, forwarded from, links and post URL. Finds the channels for you or searches your list. Only posts holding your words are charged. No login, phone number or API key.

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

## Pricing

from $1.35 / 1,000 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: Posts From Public Channels

[![30 Telegram posts about bitcoin etf with views and links in 19 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/telegram-keyword-search-scraper-hero.png)](https://console.apify.com/actors/z5cMXehm9KZIulCDx/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

From **The Mine Works**, makers of [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 290,000 runs across 310+ public actors.

Updated 4 Nov 2026: first release. Keyword search across public Telegram channels, your own channel list, date, views and subscriber filters, deep scan of older posts, and a monitor mode for schedules. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Every row is a post that holds your words.** A post is read and checked before it is delivered, not just the latest post of a page that mentioned your topic. Telegram's own search is loose: in our test, "remote python jobs" brought back 78 posts and only 26 held all three words. Posts without your words are dropped and never charged.
- **The channels are found for you, and you can add your own.** Give a keyword and the actor finds public channels that talk about it, on the web and from the channels that matching posts were forwarded from. List channels you already know and they are searched first.
- **A search that finds nothing costs nothing.** No start fee and no per-keyword fee on an empty run. You pay per post, plus a small flat fee only on runs that delivered a post. No Telegram account, phone number, API key or cookies.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/z5cMXehm9KZIulCDx/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Social media and video family:** [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### What this actor can and cannot see

Telegram has no public search across all channels. Its app can do more, but that needs an account, and this actor never logs in. So it works in two steps, and you should know the limit of each:

1. **It reads only channels it has found.** Channels come from web search results, a public index of Telegram posts, and forwards. A channel none of these name is not read. In a spot check on two keywords, 6 of 20 active channels we knew carried the keyword were found (4 of 10 for "bitcoin etf", 2 of 10 for "openai"). Treat results as a strong sample of the conversation, not a census. If certain channels must be covered, list them in `channels`: a listed channel is always searched.
2. **Telegram answers about 22 newest matches per channel and keyword.** To go further back, set `deepScanPages`, which reads the channel's history page by page and matches it here.

Private channels, private groups, direct messages and channels whose owner turned off the web preview cannot be read. About 1 in 4 names found on the web had no preview; they are skipped and never charged.

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 30 posts about "bitcoin etf". It took 19 seconds in our test run:

```json
{
  "keywords": ["bitcoin etf"],
  "maxItems": 30
}
```

Put several keywords on separate lines to run several searches at once. A post that two of your keywords find is delivered and charged once.

Apify's free plan includes $5 of credit every month, which covers about 2,200 posts at this actor's Free tier price.

#### Copy to your AI assistant

```text
themineworks/telegram-keyword-search-scraper on Apify. Searches public Telegram channel posts by keyword with no login and returns one flat row per post: text, channel, subscribers, date, views, reactions, forwarded from, links and post URL. Telegram has no public search across all channels, so it finds channels on the web, or uses a list you give, and searches inside each (about 22 newest matches per channel). Call ApifyClient("TOKEN").actor("themineworks/telegram-keyword-search-scraper").call(run_input={"keywords": ["bitcoin etf"], "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Rows with a _type field are summary, info or error rows. Optional: channels, discoverChannels, postedAfter ("7 days"), minViews, minSubscribers, deepScanPages, monitorMode.
```

### Key features

- **Real matches, checked word by word.** Each post, its link preview and its file name are checked for every word of your keyword. Word endings are allowed for, so "нефть" also finds "нефти". Each row says so in `keyword_in_text`. Turn `requireAllWords` off to take everything Telegram returned.
- **Search syntax.** Plain words are all required, `"spot etf"` in quotes needs that exact phrase, `#airdrop` searches a hashtag and `-scam` drops posts holding that word. Any language works; our test keywords included Russian and Chinese.
- **Channel context on every row.** Subscribers, title, bio and verified badge sit next to each post, so a mention can be weighed by reach.
- **Filters before billing.** `postedAfter`, `postedBefore`, `minViews` and `minSubscribers` drop posts and channels before you pay for them.
- **Deep scan for older posts.** `deepScanPages` walks a channel's history, 20 posts a page, and matches it here. Our test reached posts well past Telegram's newest 22 at the same price per post.
- **Monitor mode.** On a schedule, `monitorMode` delivers and charges only posts your account has not received from this actor before.
- **Stops cleanly.** Eight opened channels in a row with no match end a keyword, a page gets two tries at most, and a blocked run stops within four requests. The summary row says why a run ended.

### How to use it

#### Basic: what is being said about a topic

```json
{
  "keywords": ["lab grown diamonds"],
  "maxItems": 100
}
```

Sort by `channel_subscribers` or `views` to see which mentions reached people.

#### Brand monitoring on a schedule

```json
{
  "keywords": ["your brand", "\"your product name\""],
  "postedAfter": "7 days",
  "monitorMode": true,
  "maxItems": 200
}
```

Save it as a task and schedule it daily. Only new posts arrive and only new posts are charged.

#### Search only the channels you follow

```json
{
  "keywords": ["airdrop", "listing"],
  "channels": ["cointelegraph", "@WatcherGuru", "https://t.me/bitcoinnews"],
  "discoverChannels": false
}
```

No web search is used. Each listed channel is asked for each keyword.

#### Reach further back in known channels

```json
{
  "keywords": ["telegram"],
  "channels": ["durov", "telegram", "tginfo"],
  "discoverChannels": false,
  "deepScanPages": 10,
  "maxPostsPerChannel": 100,
  "postedAfter": "3 years"
}
```

Deep scan reads up to 10 extra history pages per channel. In a shorter test with 3 pages, 47 of 100 posts came from the history scan.

#### Larger channels only

```json
{
  "keywords": ["remote python jobs"],
  "minSubscribers": 1000,
  "minViews": 100
}
```

A simple way to leave out small and spam channels. Some search results are low quality channels, so this filter is worth using for commercial keywords.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `keywords` | array of strings | required | What to search for. Up to 100 keywords per run. |
| `channels` | array of strings | empty | Public channels to search first: `durov`, `@durov` or `https://t.me/durov`. |
| `discoverChannels` | boolean | `true` | Find channels on the web. Off: only your list is searched. |
| `maxItems` | integer | `100` | Most posts per keyword, 1 to 10,000. |
| `maxChannelsPerKeyword` | integer | `50` | Most channels opened per keyword, your list included. |
| `maxPostsPerChannel` | integer | `20` | Most posts from one channel per keyword. Above 22 needs deep scan. |
| `deepScanPages` | integer | `0` | History pages per channel to read and match, 20 posts a page. |
| `postedAfter` | string | empty | `2026-10-01`, or `7 days`, `2 weeks`, `1 month` back from today. |
| `postedBefore` | string | empty | Same forms; keeps older posts. |
| `minViews` | integer | `0` | Drop posts with fewer views. |
| `minSubscribers` | integer | `0` | Skip channels with fewer subscribers. |
| `requireAllWords` | boolean | `true` | Only posts holding every word. Off: all Telegram returned, flagged in `keyword_in_text`. |
| `monitorMode` | boolean | `false` | Deliver and charge only posts not delivered to your account before. |

### What data do you get?

One row per post. Post rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

| Field | What it is |
|---|---|
| `post_url`, `post_id` | Direct link to the post, and its number in the channel |
| `keyword`, `keyword_in_text` | The keyword that found it, and whether every word is in the post |
| `text` | Full post text |
| `posted_at`, `edited` | When it was posted (UTC), and whether it was edited |
| `views`, `views_label` | Views as a number, and as Telegram shows them (`6.79K`). Telegram rounds large counts |
| `reactions`, `reactions_total` | Reactions by emoji, and their sum |
| `forwarded_from`, `forwarded_from_url` | Where a forwarded post came from |
| `reply_to_url`, `author` | The post it replies to, and the author signature when the channel signs posts |
| `links` | Outbound links in the text and link preview; Telegram's own links are left out |
| `link_preview_url`, `link_preview_title`, `link_preview_description`, `link_preview_site` | The preview card |
| `hashtags`, `mentions`, `emails` | Hashtags, usernames and email addresses in the post |
| `has_media`, `media_types`, `photo_urls`, `video_urls`, `document_title` | Media in the post. Media links expire after a while |
| `channel`, `channel_url`, `channel_title` | The channel |
| `channel_subscribers`, `channel_verified`, `channel_description` | Its reach, badge and bio |
| `discovered_via` | How the channel was reached: `your_list`, `duckduckgo`, `lyzem`, `forwarded_from` or `google` |
| `match_source` | `telegram_search` or `history_scan` |
| `scraped_at` | When the row was written |

**Forward counts are not included.** Telegram's public web preview does not show how many times a post was forwarded, only where a forwarded post came from, which is in `forwarded_from`.

**Summary row** (`_type: "summary"`, never charged): `keywords_requested`, `keywords_read`, `channels_opened`, `channels_with_matches`, `channels_no_preview`, `channels_blocked`, `posts_seen`, `posts_without_all_words`, `posts_filtered_out`, `posts_already_delivered`, `duplicates_skipped`, `posts_delivered`, `charged_for`, `http_requests`, `stopped_by_max_cost`, `stopped_by_block_guard`, `ended_on_deadline`, `shortfall_reason` when fewer posts came back than asked, and `per_keyword`, one entry per keyword with channels found and opened, posts delivered, what each source gave and why it stopped. The same summary is saved as the `OUTPUT` record of the run's key-value store.

**Error rows** (`_type: "error"`, never charged): one per input that could not be read, with `error_type` (`invalid_channel`, `invalid_date`), `identifier` and `reason`.

#### Stable fields for automations

These were present in every post row of our test runs, and their names will not change:

| Field | What it is |
|---|---|
| `post_url` | The key to store and join on |
| `post_id` | Post number in the channel |
| `keyword` | Search that found it |
| `keyword_in_text` | Every word present |
| `text` | Post text |
| `posted_at` | Date and time, UTC |
| `views` | View count |
| `channel` | Channel username |
| `channel_url` | Channel link |
| `channel_title` | Channel name |
| `channel_subscribers` | Subscribers |
| `channel_verified` | Verified badge |
| `has_media` | Has media |
| `discovered_via` | How the channel was reached |
| `match_source` | How the post was matched |
| `scraped_at` | When the row was written |

Optional, present only when the post has a value. In a test of 1,640 posts: `links` 952, `reactions` 844, `media_types` 801, `photo_urls` 707, `hashtags` 451, `link_preview_url` 336, `mentions` 186, `author` 84, `forwarded_from` 75, `video_urls` 52, `emails` 35, `reply_to_url` 26, `document_title` 21.

#### Output examples

One post from a "bitcoin etf" search (test run, 4 Nov 2026):

```json
{
  "post_url": "https://t.me/WatcherGuru/13287",
  "post_id": 13287,
  "keyword": "bitcoin etf",
  "keyword_in_text": true,
  "text": "JUST IN: $3.5 trillion Goldman Sachs files for Bitcoin Premium Income ETF.\n\n📰 Full Story\n\n@WatcherGuru",
  "posted_at": "2026-04-14T15:11:36+00:00",
  "edited": false,
  "views": 123000,
  "views_label": "123K",
  "reactions": [
    { "emoji": "🔥", "count": 664 },
    { "emoji": "❤", "count": 215 },
    { "emoji": "💩", "count": 102 },
    { "emoji": "🤡", "count": 63 },
    { "emoji": "🤯", "count": 19 }
  ],
  "reactions_total": 1063,
  "links": ["https://watcher.guru/news/goldman-sachs-files-for-bitcoin-premium-income-etf"],
  "mentions": ["WatcherGuru"],
  "has_media": true,
  "media_types": ["photo"],
  "channel": "WatcherGuru",
  "channel_url": "https://t.me/WatcherGuru",
  "channel_title": "Watcher Guru",
  "channel_subscribers": 631000,
  "channel_verified": true,
  "discovered_via": "duckduckgo",
  "match_source": "telegram_search",
  "scraped_at": "2026-11-04T14:06:56.094Z"
}
```

The summary row of the "Try it" run, trimmed:

```json
{
  "_type": "summary",
  "keywords_requested": 1,
  "channels_opened": 5,
  "channels_with_matches": 5,
  "posts_seen": 101,
  "posts_without_all_words": 1,
  "posts_delivered": 30,
  "http_requests": 6,
  "http_blocked": 0,
  "per_keyword": [
    { "keyword": "bitcoin etf", "channels_found": 7, "channels_opened": 5, "posts_delivered": 30, "stopped": "max_items_reached" }
  ],
  "run_seconds": 19
}
```

### Pricing

Pay per event: you pay for the posts you receive, plus a flat $0.003 on runs that delivered a post, whatever memory you choose. Finding channels costs nothing extra, and neither does deep scan.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `post-found` | Once per post row stored in your dataset | $2.25 per 1,000 | $1.90 per 1,000 | $1.60 per 1,000 | $1.35 per 1,000 |
| `run-start` | Once per run, after the first post was delivered | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one post is the price per 1,000 divided by 1,000.

Never charged:

- posts that do not hold your words (with `requireAllWords` on, the default);
- posts and channels your filters leave out;
- a post that a second keyword of the same run finds again;
- in monitor mode, posts your account already received;
- channels with no preview, private chats and invite links;
- the summary, info and error rows;
- a run that delivered nothing: no start fee, no per-keyword fee;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. Add `"monitorMode": true` so each run delivers and charges only new posts.
3. In the task, open **Schedules**, click **Add schedule** and pick how often (every hour, every Monday at 08:00 and so on).
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### Does this search all of Telegram?

No. Telegram offers no public search across channels without an account. This actor finds channels first, then searches inside each, so a channel it did not find is not covered. See "What this actor can and cannot see" above. To be sure of a channel, list it in `channels`.

#### How many posts can I get?

Up to 10,000 per keyword and 100 keywords per run, as far as the channels found allow. Telegram answers about 22 newest matches per channel and keyword. In our test of 10 keywords with a limit of 200 each, 7 reached the 200 and the narrow ones returned 54 to 95. More channels in `channels`, `deepScanPages` or a broader keyword bring more.

#### Why are some posts old?

Telegram returns each channel's newest matches, and in a quiet channel those can be years old. Of 1,640 test posts, 478 were from the last 30 days and 1,105 from the last year. Use `postedAfter` to keep only recent ones; older posts are then not charged.

#### Why did a channel I expected not appear?

It may not be named by any source, it may have no web preview (its owner can turn this off), or its posts may not hold every word. The summary's `per_keyword` shows what was found and opened. List the channel in `channels` to search it directly.

#### Are forward counts available?

No. Telegram's web preview does not publish them. `forwarded_from` shows where a forwarded post came from. Views and reactions are the reach numbers available.

#### Are the results clean of spam?

Not fully. Public channels include promotions and spam, and they can hold your words like anything else. `minSubscribers` and `minViews` remove most of it, and `discovered_via` shows where a channel came from.

#### What is the difference from Telegram Channel Scraper and Telegram Channel Finder?

[Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) returns channels for a keyword, not posts. [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) returns everything a known channel posted. This actor returns the posts that hold your keyword, across channels.

#### How long does a run take?

In our tests: 19 seconds for the "Try it" input, 24 seconds for 100 posts from 3 listed channels with deep scan, about 80 seconds per keyword for 200 posts when the web search has to dig deep. An empty keyword ends in about 5 seconds. The default time limit is 3,600 seconds; the actor stops before it and keeps every row.

#### Do I need an account, phone number or proxy?

No. The actor reads public web pages over Apify Proxy, which is included. Nothing to set up.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has three ready views: Posts, Reach and engagement, and Links and contacts.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/telegram-keyword-search-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http telegram-keyword-search-scraper "https://mcp.apify.com/?tools=themineworks/telegram-keyword-search-scraper"`

#### Is it legal to scrape Telegram?

The actor reads only public channel previews that anyone can open in a browser without an account. It does not read private chats or log in. Posts can contain personal data, so you are responsible for how you use the data, including Telegram's terms and data protection law such as GDPR and CCPA. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's posts to a sheet with Apify's Google Sheets integration; one row per post fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new posts naming our brand, every morning, to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Twitter / X Scraper](https://apify.com/themineworks/twitter-x-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [YouTube Transcript](https://apify.com/themineworks/youtube-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Xiaohongshu (RED) Scraper](https://apify.com/themineworks/xiaohongshu-explore-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Pinterest Profile Scraper](https://apify.com/themineworks/pinterest-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a keyword that returns fewer posts than you expected, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search public Telegram channels by keyword and get one row per post that holds your words, with text, channel, subscribers, date, views, reactions, forwarded from and links, no login.*

# Actor input Schema

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

What to search for, one per line, in any language. All words are required by default. Use "an exact phrase" in quotes, #hashtag, and -word to exclude a word. Up to 100 keywords per run.

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

Public channels you already know, searched first. Accepts durov, @durov or https://t.me/durov. Invite links lead to private chats and cannot be read.

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

On: public channels about the keyword are found on the web and searched too. Off: only your channel list is searched, and no search engine is used.

## `maxItems` (type: `integer`):

The most posts to return for each keyword, 1 to 10,000. Example: 200.

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

The most channels to open for each keyword, 1 to 500, your own list included.

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

The most posts to take from one channel for one keyword. Telegram's search answers about 22 newest matches per channel, so a value above 22 needs deep scan. Lower it to spread results over more channels.

## `deepScanPages` (type: `integer`):

0 is off. Above 0: after Telegram's search, up to this many pages of the channel's history (20 posts a page) are read and matched here, to reach matches older than the newest 22. Slower, same price per post.

## `postedAfter` (type: `string`):

Keep posts from this date on: 2026-10-01, or a range back from today such as 7 days, 2 weeks, 1 month.

## `postedBefore` (type: `string`):

Keep posts older than this date: 2026-10-01, or a range such as 1 year.

## `minViews` (type: `integer`):

Drop posts with fewer views. Dropped posts are not charged.

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

Skip channels with fewer subscribers, for example 1000 to drop small and spam channels. Skipped channels are not charged.

## `requireAllWords` (type: `boolean`):

On: a post must hold every word of the keyword (word endings are allowed for). Off: everything Telegram's search returned is delivered and charged, and keyword_in_text says which posts really hold the words.

## `monitorMode` (type: `boolean`):

On a schedule: deliver and charge only posts your account has not received from this actor before.

## Actor input object example

```json
{
  "keywords": [
    "bitcoin etf"
  ],
  "discoverChannels": true,
  "maxItems": 30,
  "maxChannelsPerKeyword": 50,
  "maxPostsPerChannel": 20,
  "deepScanPages": 0,
  "requireAllWords": true,
  "monitorMode": false
}
```

# Actor output Schema

## `results` (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 = {
    "keywords": [
        "bitcoin etf"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/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": ["bitcoin etf"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/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": [
    "bitcoin etf"
  ],
  "maxItems": 30
}' |
apify call themineworks/telegram-keyword-search-scraper --silent --output-dataset

```

## MCP server setup

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