# Telegram Scraper API: Channels and Posts, JSON | Scrapier (https://scrapier.io/scrapers/telegram/)

> Telegram scraper API with 5 endpoints: public channels, recent messages and posts with views and reactions as typed JSON. 1 credit per call. Get a free API key.

Last updated: 2026-11-11

## Telegram Scraper API: _5 endpoints_, structured JSON

Public channel profiles with their recent messages, and single posts with view counts and reactions: every Telegram endpoint Scrapier ships, each returning typed JSON in the same response envelope. Public data only.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**5**Telegram endpoints

**1**credit per successful call

**0**credits for a failed call

**2**need no Telegram login

Quick answerScrapier returns typed JSON from **5 Telegram endpoints**: public channel profiles, recent channel messages and single posts with views and reactions. Public data only and no proxies; no Telegram login needed. 1 credit per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with Telegram Scraper?

Pick the data you need. Each endpoint takes a channel or post link and gives you clean JSON back, for 1 credit per successful call.

[### Channel and messagesStart here

`**GET**/api/v2/telegram-channel/`

A public channel's title, description, subscriber count, verified flag and recent messages.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/telegram/channel/)[### Single post

`**GET**/api/v2/telegram-single-post/`

One channel post by URL: text, publish time, view count, reactions and media.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/telegram/post/)

### Username lookup

`**IN**usernames`

Whether a Telegram username exists, if it is a user or a channel, with its title, description, photo and member count.

Same API key and JSON envelope

### Email finder

`**IN**keywords`

Public emails found on Telegram pages for a keyword, with the page title, description and URL of each match.

Same API key and JSON envelope

### Phone number finder

`**IN**keywords`

Public phone numbers on Telegram pages for a keyword and country, with the dial code, page title and URL.

Same API key and JSON envelope

Playground

## Try Telegram Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

Telegram**Channel and messages**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping Telegram cost?

Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 Telegram calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | $1.20 |

How to

## How do I use Telegram Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get Telegram data in a few minutes:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**A channel with its recent messages, or one post with its views and reactions.
3. **Add your input**One public channel link, such as `https://t.me/durov`, or one post link per call.
4. **Set how many messages**On `telegram-channel`, `max_items` sets how many recent messages come back with the profile.
5. **Page through the results**When the response has `next_cursor`, pass it back as `cursor` for the next page.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Every endpoint takes the same kind of input.

1

### By URL

You already have the links to the pages you want.

Channel and messages`t.me/durov`

Single post`t.me/durov/543`

Best forknown pages · paste the link as it is

Example requests

// GET /api/v2/telegram-channel/
{
  "urls": "https://t.me/durov",
  "max\_items": "10",
  "timeout": "30"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Channel URL | `urls` | Channel title, description, subscribers, media counts and recent messages |
| Channel URL + limit | `urls` · `max_items` | The same, with up to that many recent messages |
| Post URL | `urls` | That post's text, publish time, views, reactions and media |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/telegram-channel/?urls=https://t.me/durov
// one item of data.channel · catalog sample
{
  "username": "durov",
  "title": "Pavel Durov",
  "verified": true,
  "subscribers": "10 497 798 subscribers",
  "description": "Founder of Telegram.",
  "profile\_image": "https://cdn4.telesco.pe/file/nQJ2NBa7Jhv9KNN2AKCyd7OFHVjkY4U...jpg",
  "url": "https://t.me/durov",
  "media\_count": 0,
  "video\_count": 2,
  "link\_count": 0,
  "messages": \[
    {
      "text": "⛔️The UK government wants to ban social media for children under 16.But banning social media for kids only puts them ...",
      "date": "",
      "url": "https://t.me/durov/528",
      "has\_media": false,
      "is\_video": false,
      "links": \[\]
    }
  \],
  "scraped\_at": "2026-12-01T12:00:00.000Z",
  "input\_url": "https://t.me/durov"
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with Telegram data?

Public Telegram data powers channel research, market and crypto monitoring, news tracking and post performance reports. Here are four common jobs, and the Telegram scraper endpoints each one chains together.

01

### Channel research and vetting

Before you buy an ad or partner with a channel, check its subscriber count, verified flag and recent messages. Compare channels in a niche side by side.

1. _1_channel
2. Shortlist

WeeklySheets, CRM

02

### Market and crypto signal monitoring

Many projects, traders and analysts announce on Telegram first. Pull new messages from the channels you follow on a schedule, then open key posts for views and reactions.

1. _1_channel
2. _2_single-post
3. Signal feed

HourlyDatabase, alerts

03

### News and announcement tracking

Follow the public channels of companies, media outlets and public figures and keep every new message in one archive you can search and summarize.

1. _1_channel
2. Message archive

DailyDatabase, LLM

04

### Post performance reports

Track views and reactions on your own channel's posts, or on a sponsored post you paid for, to see how each one performed over time.

1. _1_single-post
2. Performance sheet

DailySheets, dashboard

Features

## Features

Telegram Scraper fetches clean, structured data from public Telegram channels at low cost: built for channel research, monitoring and AI agents.

### Live data, every call

Each request reads Telegram at call time, and the response says when in `scraped_at`.

### Typed, consistent JSON

Same field names on every call, view and reaction counts as numbers, ready for code, sheets or an LLM.

### Profile and messages together

One channel call returns the profile and its recent messages; `max_items` sets how many.

### 5 endpoints, one shape

Channels and posts share the same envelope and auth as every other Scrapier platform.

### MCP-ready for AI agents

The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### No account to manage

Public channels only. Neither live endpoint needs a Telegram account, phone number, bot or api\_id.

### Maintained for you

When Telegram changes its public pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

1 credit per call, however many messages the page holds. Failed calls are never billed.

Why Scrapier

## Why choose this Telegram Scraper?

The official Telegram Bot API only reads chats a bot has been added to, and the full Telegram API needs a user account, a phone number and an api\_id. Scrapier reads any public channel or post with one API key, at a price you know before the call runs.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$1.20**Per 1,000 calls on Scale

At 1 credit a call. Flat per-call pricing, no compute units or bandwidth to estimate.

**0**Setup steps on Telegram

No bot, phone number, api\_id or channel admin rights.

**1 key**For 35 platforms

The same key and JSON envelope cover X, Bluesky, Threads, Reddit and more.

| Feature | Scrapier Telegram Scraper | Telegram Bot API | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Any public channel | Chats the bot is added to | Any public channel |
| Setup | One API key | Bot token; an admin adds the bot | Proxies, parsers, or a user account |
| Maintenance | Handled by Scrapier | Bot updates and webhooks | Breaks on page changes |
| Cost | From $1.20 per 1,000 calls | Free | Servers and engineering time |
| AI agents | MCP server included | None | Build your own |

FAQ

## Frequently asked questions

### Do I need a Telegram account to use the Telegram scraper?

No. Both live Telegram endpoints read public channels and posts from their t.me links. You only need your Scrapier API key in the X-API-Key header; no phone number, bot token or api\_id.

### Can I scrape private Telegram groups or chats?

No. Scrapier reads public data only: public channels and their posts. Private groups, private channels and direct chats are not returned, and Scrapier does not join chats on your behalf.

### How many messages does a channel call return?

telegram-channel returns the channel profile with its recent messages; max\_items sets how many, 10 by default. When the response carries next\_cursor, pass it back as cursor for the next page. Each call is 1 credit.

### What does a single post return?

telegram-single-post takes a post link such as https://t.me/durov/543 and returns the text, publish time, view count as a number and as shown, each reaction with its count, the forwarded-from source and media.

### Why is the subscriber count a string?

The channel sample shows subscribers as Telegram prints it, for example "10 497 798 subscribers". Strip the spaces and the word to get a number. View counts on posts come back as numbers, with view\_count\_text beside them.

### Is it legal to scrape Telegram?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Some of it can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use.

### Can I connect Telegram data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON response.

### Can I get Telegram data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right Telegram endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### Telegram Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.

### How much does the Telegram scraper cost?

Each Telegram endpoint costs 1 credit per successful call, however many messages the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### What are the Telegram scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.

### How do I scrape Telegram with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/telegram-channel/", headers={"X-API-Key": key}, params={"urls": "https://t.me/durov"}, timeout=210). The response is JSON, so read r.json()\["data"\]\["channel"\] directly; there is no HTML to parse. Loop over your list for more channels.

Other platforms

## You might also like

[### X (Twitter)

6 endpoints](https://scrapier.io/scrapers/x-twitter/)[### Bluesky

3 endpoints](https://scrapier.io/scrapers/bluesky/)[### Threads

6 endpoints](https://scrapier.io/scrapers/threads/)[### Truth Social

4 endpoints](https://scrapier.io/scrapers/truth-social/)[### Reddit

9 endpoints](https://scrapier.io/scrapers/reddit/)[### Facebook

20 endpoints](https://scrapier.io/scrapers/facebook/)

Get started

## Start pulling Telegram data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[See the Channel endpoint](https://scrapier.io/scrapers/telegram/channel/)

---
Canonical page: https://scrapier.io/scrapers/telegram/
Site index for AI agents: https://scrapier.io/llms.txt
