Read public Telegram channels
get_telegram_channel_postsRetrieve recent public Telegram channel posts without a Telegram account, including text, dates, views, reactions, links, and hashtags; apply keyword and date filters.
Instructions
Fetch recent posts from public Telegram channels without a Telegram account: text, date, views, reactions, links, hashtags. Optional keyword filter and date cutoff. Cost on the user's Apify account: $0.002 per call + $0.0015 per post returned.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"channels": "<channels>"
},
"name": "get_telegram_channel_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channels | Yes | Channel usernames or URLs: "durov", "@telegram", "https://t.me/bloomberg". | |
| keywords | No | Only posts containing any of these words (case-insensitive). | |
| sinceDate | No | Optional date (YYYY-MM-DD); older posts are skipped. | |
| maxPostsPerChannel | No | Newest posts first. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | Yes | Apify Actor that produced the data | |
| items | Yes | ||
| runId | Yes | Apify run ID; pass it to get_run_results if finished is false | |
| status | Yes | Apify run status, e.g. SUCCEEDED or RUNNING | |
| finished | Yes | false when the run was still going and items are partial | |
| itemCount | Yes |