# Find Telegram channels and posts by keyword

**Use case:** 

Type a keyword such as bitcoin etf and get the public Telegram channels and posts that web search has found for it, then the matching posts from each channel found, with views, reactions and cashtags. On 12 November 2026 this input returned 10 found pages, 10 channels and 60 posts in 44 seconds for $0.01805. Found pages are free for now. It shows what search has indexed, not all of Telegram.

## Input

```json
{
  "channels": [
    "telegram"
  ],
  "maxPostsPerChannel": 20,
  "findByKeyword": [
    "bitcoin etf"
  ],
  "maxResultsPerKeyword": 10,
  "keywordCountry": "US",
  "keywordLanguage": "en",
  "keywordFreshness": "any",
  "readMatchingPosts": true,
  "maxChannelsPerKeyword": 3,
  "originalPostsOnly": false,
  "onlyNewPosts": false,
  "trackChannelChanges": false,
  "notifyWhenNothingFound": false,
  "includeChannelInfo": true,
  "textFormat": "text",
  "maxConcurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

## Output

```json
{
  "firstPhotoUrl": {
    "label": "Photo",
    "format": "string"
  },
  "channel": {
    "label": "Channel",
    "format": "string"
  },
  "postId": {
    "label": "Post",
    "format": "integer"
  },
  "date": {
    "label": "Published",
    "format": "string"
  },
  "text": {
    "label": "Text",
    "format": "string"
  },
  "views": {
    "label": "Views",
    "format": "integer"
  },
  "reactionsTotal": {
    "label": "Reactions",
    "format": "integer"
  },
  "isForwarded": {
    "label": "Forwarded",
    "format": "boolean"
  },
  "url": {
    "label": "Post",
    "format": "string"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Telegram Channel Scraper: Monitor Posts & Keyword Search Actor is ready to run with the inputs already set for "Find Telegram channels and posts by keyword". [Sign up or log in](https://console.apify.com/create-task-from-example/cIe3nKwi6jnDUvgrD) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Find Telegram channels and posts by keyword" task

The Telegram Channel Scraper: Monitor Posts & Keyword Search Actor will start running based on the input automatically. You can also change all the input fields, like channels, maximum posts per channel, and more, to match your specific use case.

### 3. Receive the "Find Telegram channels and posts by keyword" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as photo, channel, post, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Find Telegram channels and posts by keyword" task via API](https://apify.com/fetchwright/telegram-channel-scraper.md).

## FAQ

### How does Telegram keyword search find channels?

It returns the public Telegram channels and posts a web search finds for your keyword, and keeps only pages whose channel is public. It is not a complete search of Telegram: pages a search engine has not indexed are not found.

### What does a Telegram keyword search cost?

Found pages and channel rows are free for now. Posts cost $0.30 per 1,000 on the Free plan, plus $0.00005 per run: this task's run saved 60 posts, 60 x $0.0003 + $0.00005 = $0.01805. A channel is read at most once per run.

### Can I get only the channels, without posts?

Yes. Turn off Also read the matching posts and the run returns only the pages found, with title, snippet, link and rank, and no post charges.

### Can an AI agent or my own code run this task?

Yes. Run fetchwright/telegram-channel-scraper through the Apify API or the Apify MCP server with findByKeyword (a list of keywords) and your limits. The result is JSON rows, also available as CSV or Excel.

## About this Actor

This example demonstrates how to use [Telegram Channel Scraper: Monitor Posts & Keyword Search](https://apify.com/fetchwright/telegram-channel-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/fetchwright/telegram-channel-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/fetchwright/telegram-channel-scraper.md

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`).
