Social & video

Telegram Scraper

t.me

Public Telegram channels are served through a dedicated plugin endpoint rather than the generic page fetch. Give it a channel - a username like durov, @durov or a t.me link - and it reads the channel's public web preview and returns it already parsed: the channel's title, @username, description, avatar and verified mark with its subscriber, photo, video and link counts, and its posts newest first, each with id, URL, date, the text as plain text and as Telegram's own HTML, views, the author signature, an edited flag, the channel a post was forwarded from, the post it replies to, media (photos, videos, round videos, voice notes and stickers with their Telegram CDN links, audio files and documents with their title and size), polls, link previews, reactions with their counts, inline buttons, and the links, hashtags and mentions in the text. Without max_posts a call reads one page, the newest posts (about 20); with it, the plugin pages back through the channel's history until it has up to 500, while before, after and since bound the range, q searches inside the channel and post_id (or a post link) returns one post. It works for public channels with a web preview only: users, bots, groups and private channels have none, and comments, which live in a separate discussion group, are not included. No Telegram account, bot token or API key is involved.

What you can extract

• Channel title, @username, description, avatar and verified mark
• Subscriber count and the photo, video and link counters
• Post id, URL, date (ISO-8601 UTC), plain text and Telegram text HTML
• Views, author signature and an edited flag
• Forwarded-from and reply-to references
• Media: photos, videos, round videos, voice notes and stickers with Telegram CDN links, thumbnails and durations; audio files and documents with title and size
• Polls, link previews, reactions with their counts and inline buttons
• Links, hashtags and mentions found in the text
• One page of the newest posts by default, up to 500 per call with max_posts, bounded by before, after or since, and search inside a channel with q

Dedicated endpoints

How to scrape it

curl -X POST \
  -H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
  "https://api.scrapeunblocker.com/social/telegram-channel?channel=durov&max_posts=40"

import requests

resp = requests.post(
    "https://api.scrapeunblocker.com/social/telegram-channel",
    headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
    params={"channel": "durov", "max_posts": "40"},
)
print(resp.text)

import { ScrapeUnblockerClient } from 'scrapeunblocker';

const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });

const channel = await su.telegramChannel('durov', {
  maxPosts: 40,
});
console.log(channel);

Requests are POST and take their parameters in the query string. Browser rendering always happens - there is no flag to enable.

Example response

{
  "channel": {
    "username": "durov",
    "url": "https://t.me/durov",
    "title": "Pavel Durov",
    "description": "Founder of Telegram.",
    "avatar": "https://cdn4.telesco.pe/file/ZmgDSnVaNbJG2t9mSNAUKDOGVg0AEDnNQRnooGnt_A3z8M832bl...jpg",
    "verified": true,
    "subscribers": 10500000,
    "subscribersRaw": "10.5M",
    "counters": { "subscribers": 10500000, "photos": 102, "videos": 46, "links": 200 }
  },
  "query": { "maxPosts": 40 },
  "posts": [
    {
      "id": 546,
      "url": "https://t.me/durov/546",
      "channel": "durov",
      "type": "message",
      "date": "2026-08-31T16:30:15Z",
      "text": "🏳️ Gram Wallet in Telegram is ready and is now accessible to a select group of users...",
      "textHtml": "...Gram Wallet in Telegram is ready and is now accessible to a select group of users.<br/><br/>...",
      "views": 3210000,
      "viewsRaw": "3.21M",
      "author": "Pavel Durov",
      "edited": false,
      "media": [
        {
          "type": "video",
          "url": "https://cdn4.telesco.pe/file/e0b2769474.mp4?token=Eb2XGKYH0FySr2g4...",
          "thumbnail": "https://cdn4.telesco.pe/file/uz8d2sdnRZENi9ZLOZPbWHDwy8fQsxO...jpg",
          "duration": "0:20",
          "durationSeconds": 20,
          "postId": 546
        }
      ],
      "reactions": [
        { "emoji": "⭐", "paid": true, "count": 35600, "countRaw": "35.6K" },
        { "customEmojiId": "5399847211989246390", "count": 26800, "countRaw": "26.8K" },
        { "emoji": "😺", "customEmojiId": "5373223594484587136", "image": "https://telegram.org/img/emoji/40/F09F98BA.png", "count": 8740, "countRaw": "8.74K" }
      ]
    },
    {
      "id": 526,
      "url": "https://t.me/durov/526",
      "channel": "durov",
      "type": "message",
      "date": "2026-06-13T20:15:20Z",
      "text": "🖥 Don't be surprised if you see tables, nested lists, inline media, formulas, headers and more in Telegram messages...",
      "views": 23100000,
      "viewsRaw": "23.1M",
      "author": "Pavel Durov",
      "edited": false,
      "media": [
        {
          "type": "animation",
          "url": "https://cdn4.telesco.pe/file/1fd3fed61d.mp4?token=Qif8hzjy6bgdJB-4...",
          "thumbnail": "https://cdn4.telesco.pe/file/dMPQRD-QbGCA0oD3YfM4HEFI03Sb23m...jpg",
          "postId": 526
        }
      ],
      "reactions": [
        { "emoji": "⭐", "paid": true, "count": 5980, "countRaw": "5.98K" },
        { "customEmojiId": "5465587407350942612", "count": 45900, "countRaw": "45.9K" }
      ],
      "links": ["https://core.telegram.org/bots/api#rich-message-formatting-options"]
    }
  ],
  "postsReturned": 40,
  "pagesFetched": 3,
  "hasMore": true,
  "nextBefore": 507
}

Read the API docs

Frequently asked questions

Related scrapers