# Telegram Scraper API - Channel Posts, Views & Media (`sndzcc/telegram-channel-scraper`) Actor

Telegram channel scraper with no login, phone or API key: scrape messages from any public Telegram channel with text, date, views, reactions, links, photos and videos, plus channel stats.

- **URL**: https://apify.com/sndzcc/telegram-channel-scraper.md
- **Developed by:** [Sndz Data](https://apify.com/sndzcc) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 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.

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 Scraper API: Channel Posts, Views & Media

Scrape any **public Telegram channel** without an account, phone number or API key. Get every post with its **text, date, views, reactions, links, photos and videos**, plus the channel's **subscriber count**.

Fast and cheap: no browser, no login. Thousands of posts per minute.

### Why this one?

- **No Telegram account needed.** No phone number, no API ID, no risk of getting your account banned.
- **Full history.** Goes back post by post as far as you need, newest first.
- **Engagement data:** views and reactions (by emoji, including paid Stars) on every post.
- **Media and links:** photo and video URLs, links in the text, forwarded-from channel.
- **Filters:** posts since a date and keyword matching, so you only pay for what you need.
- **Pay per post**, no start fees.

### Use cases

- **Crypto and trading signals:** track announcements and calls from many channels in one dataset.
- **Brand and media monitoring:** follow news, competitors and communities that live on Telegram.
- **Research and OSINT:** archive public channels for analysis, fact-checking or journalism.
- **Marketing:** compare channels by subscribers, views and reactions before buying ads or partnering.
- **AI and NLP:** clean post text, ready for sentiment analysis, summaries or RAG.

### Input

| Field | What it does |
|---|---|
| **Channels** | Public channel links (`https://t.me/durov`), `@usernames` or names. |
| **Max posts per channel** | Newest first. Set a large number for the full history. |
| **Posted since** | Only posts on or after this date. |
| **Keywords** | Only posts containing any of these words. |
| **Add channel info** | Channel title and subscribers on every post, plus a channel record. |

```json
{
  "channels": ["https://t.me/durov", "@telegram"],
  "maxPostsPerChannel": 500,
  "postedSince": "2026-01-01",
  "keywords": ["update", "launch"]
}
```

### Output

```json
{
  "channel": "durov",
  "messageId": 531,
  "url": "https://t.me/durov/531",
  "date": "2026-07-16T20:45:25Z",
  "text": "Telegram now has a Rich Text Editor. It supports tables, headings, inline media...",
  "views": 5840000,
  "reactionsTotal": 95110,
  "reactions": [{ "emoji": "stars", "count": 6300 }, { "emoji": "custom emoji", "count": 54600 }],
  "author": "Pavel Durov",
  "forwardedFrom": null,
  "photos": [],
  "videos": ["https://cdn4.telesco.pe/file/....mp4"],
  "hasMedia": true,
  "links": [],
  "edited": false,
  "channelTitle": "Pavel Durov",
  "subscribers": 10300000,
  "scrapedAt": "2026-10-24T10:00:00Z"
}
```

Views and reactions are rounded the way Telegram shows them (for example 5.84M). Each channel's description, avatar and photo, video and link counters are saved in the run's key-value store as `CHANNEL-<name>`.

### Good to know

- Only **public channels** with a web preview can be read. Private channels, groups and user chats need membership, so they're skipped (and not charged).
- Photo and video links come from Telegram's CDN and expire after a while: download the files you need soon after the run.

### Integrations

Schedule it every hour or day and send new posts to Google Sheets, Slack, Discord, Zapier, Make, n8n or your own API.

### How to use it

1. Click **Try for free** (or **Start**) at the top of this page.
2. Fill in the input, or keep the example to see it working in seconds.
3. Click **Start** and wait for the run to finish.
4. Download the results as **Excel, CSV, JSON or HTML**, or get them through the Apify API.

### How much does it cost?

**$0.0007 per post** ($0.70 per 1,000). No start fee, no monthly fee, and you only pay for the results saved to your dataset.

| Example | Cost |
|---|---|
| Last 200 posts of 5 channels | about $0.70 |
| Full history of a big channel | about $14.00 |

Apify's free plan includes monthly credit, so you can try it for free.

### FAQ

**Do I need a Telegram account or API key?**

No. No account, phone number or API ID, so there is no risk for your own account.

**Can I scrape private channels or groups?**

No. Only public channels with a web preview (t.me/s/name) can be read.

**Can I get only recent posts or posts with a keyword?**

Yes. Use "Posted since" and "Keywords", and you only pay for the posts you keep.

**Can I monitor channels every hour?**

Yes. Schedule it in Apify and send new posts to Slack, Discord, Google Sheets or your API.

### More tools from Sndz Data

- [BORME Scraper API - Spain New Company Leads Daily](https://apify.com/sndzcc/borme-spain-companies): every new company registered in Spain, daily
- [App Store & Google Play Reviews Scraper API](https://apify.com/sndzcc/app-reviews-scraper): App Store and Google Play reviews in one run
- [Job Scraper API - Greenhouse, Lever, Ashby & Workable](https://apify.com/sndzcc/ats-jobs-scraper): all open jobs from Greenhouse, Lever, Ashby and more
- [Google News Scraper API - Articles with Real URLs](https://apify.com/sndzcc/google-news-scraper): news by keyword or topic, with real article URLs
- [Email & Contact Scraper API - Emails, Phones & Socials](https://apify.com/sndzcc/contact-details-scraper): emails, phones and social profiles from any website
- [Brand Monitoring API - Mentions Radar for News & Reddit](https://apify.com/sndzcc/brand-mentions-radar): brand mentions across 9 sources, with sentiment
- [AI Image Upscaler API - Upscale & Enhance Photos 4x](https://apify.com/sndzcc/ai-image-upscaler): upscale and enhance photos 4x with AI
- [Keyword Research API - Google, YouTube & Amazon Ideas](https://apify.com/sndzcc/keyword-ideas-machine): hundreds of keyword ideas from 5 search engines
- [Tech Stack Detector API - Wappalyzer & BuiltWith Alternative](https://apify.com/sndzcc/tech-stack-detector): the technologies behind any website, in bulk
- [Polymarket & Kalshi API - Prediction Market Odds](https://apify.com/sndzcc/prediction-markets-scraper): live odds from Polymarket and Kalshi in one dataset
- [WHOIS & Domain Lookup API - DNS, SSL & Availability](https://apify.com/sndzcc/domain-intel): WHOIS, availability, DNS and SSL for any list of domains
- [Bluesky Scraper API - Posts, Profiles & Followers](https://apify.com/sndzcc/bluesky-scraper): posts, profiles and followers from Bluesky, no login
- [SEO Audit API - Broken Links, Meta Tags & Site Crawler](https://apify.com/sndzcc/seo-audit): SEO audit and broken link checker for any website
- [OCR API - Image & PDF to Text Extractor, 100+ Languages](https://apify.com/sndzcc/image-pdf-to-text): text from images and scanned PDFs, 100+ languages

### Support

Missing a field or found a bug? Open an issue on the **Issues** tab and it will be fixed quickly.

If this Actor saves you time, a quick ⭐ review helps a lot and keeps it maintained. Thank you!

# Actor input Schema

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

Public Telegram channels: links (https://t.me/durov), @usernames or names. Private channels and groups can't be read without joining.

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

Newest posts first. Use a large number for a channel's full history.

## `postedSince` (type: `string`):

Only posts published on or after this date (YYYY-MM-DD).

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

Only posts whose text contains any of these words.

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

Channel title and subscribers on every post, plus a CHANNEL-<name> record with description, avatar and counters.

## Actor input object example

```json
{
  "channels": [
    "https://t.me/durov",
    "@telegram"
  ],
  "maxPostsPerChannel": 50,
  "includeChannelInfo": true
}
```

# Actor output Schema

## `overview` (type: `string`):

One row per post: channel, date, text, views, reactions and link.

## `allData` (type: `string`):

Every field, including reactions by emoji, photos, videos and links in the text.

# 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 = {
    "channels": [
        "https://t.me/durov",
        "@telegram"
    ],
    "maxPostsPerChannel": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("sndzcc/telegram-channel-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 = {
    "channels": [
        "https://t.me/durov",
        "@telegram",
    ],
    "maxPostsPerChannel": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("sndzcc/telegram-channel-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 '{
  "channels": [
    "https://t.me/durov",
    "@telegram"
  ],
  "maxPostsPerChannel": 50
}' |
apify call sndzcc/telegram-channel-scraper --silent --output-dataset

```

## MCP server setup

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