# Monitor Telegram channels for new posts

**Use case:** 

Get only the posts published since the last run from a list of public Telegram channels. Schedule this task hourly or daily and send new posts to Slack, email or Google Sheets. With one run of the watch at a time, you pay only for posts it has not returned before.

## Input

```json
{
  "channels": [
    "telegram",
    "durov"
  ],
  "maxPostsPerChannel": 50,
  "maxResultsPerKeyword": 20,
  "keywordCountry": "US",
  "keywordLanguage": "en",
  "keywordFreshness": "any",
  "readMatchingPosts": true,
  "maxChannelsPerKeyword": 10,
  "originalPostsOnly": false,
  "onlyNewPosts": true,
  "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 "Monitor Telegram channels for new posts". [Sign up or log in](https://console.apify.com/create-task-from-example/2kVQaGvbBxQGQB1YY) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Monitor Telegram channels for new posts" 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 "Monitor Telegram channels for new posts" 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 "Monitor Telegram channels for new posts" task via API](https://apify.com/fetchwright/telegram-channel-scraper.md).

## FAQ

### How does this task know which Telegram posts are new?

It records, per channel, which posts it returned; each run returns only newer ones, and the rest first after an early stop. Run one at a time: two overlapping runs can return a post again. Changing the watch's filters starts a new watch.

### How much does the Telegram Channel Scraper cost?

Telegram Channel Scraper charges per post saved: $0.30 per 1,000 posts on the Free plan, down to $0.22 on Business. Platform usage is included, and a scheduled run that finds no new posts costs only the $0.00005 start fee.

### Does the Telegram Channel Scraper need a Telegram account?

No. Telegram Channel Scraper reads only what Telegram shows to anyone on the web and needs no account, phone number or login.

### 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 this task's input fields (channels, maxPostsPerChannel, onlyNewPosts). 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`).
