New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →

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.

Copy for your AI agent
5Telegram endpoints
1credit per successful call
0credits for a failed call
2need 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 callView →Page soon

Single post

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

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

1 credit per callView →Page soon

Username lookup

INusernames

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

INkeywords

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

INkeywords

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.

TelegramChannel and messagesLive

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 →
PlanPrice / moCredits / moPer 1,000 calls
Free$0Free tier—
Hobby$2915,000$1.93
Pro$7950,000$1.58
Scale$299250,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:

  1. Create a free Scrapier accountSign up with your email and copy your API key.
  2. Pick the endpoint for your dataA channel with its recent messages, or one post with its views and reactions.
  3. Add your inputOne public channel link, such as https://t.me/durov, or one post link per call.
  4. Set how many messagesOn telegram-channel, max_items sets how many recent messages come back with the profile.
  5. Page through the resultsWhen the response has next_cursor, pass it back as cursor for the next page.
  6. Run the requestOne GET with your key in the X-API-Key header, or ask your AI agent over MCP.
  7. Save the resultsJSON 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 messagest.me/durov
Single postt.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 thisParameterAnd you can get
Channel URLurlsChannel title, description, subscribers, media counts and recent messages
Channel URL + limiturls · max_itemsThe same, with up to that many recent messages
Post URLurlsThat 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. 1channel
  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. 1channel
  2. 2single-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. 1channel
  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. 1single-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.

0Credits for a failed call

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

$1.20Per 1,000 calls on Scale

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

0Setup steps on Telegram

No bot, phone number, api_id or channel admin rights.

1 keyFor 35 platforms

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

FeatureScrapier Telegram ScraperTelegram Bot APIDIY scraper
Whose dataAny public channelChats the bot is added toAny public channel
SetupOne API keyBot token; an admin adds the botProxies, parsers, or a user account
MaintenanceHandled by ScrapierBot updates and webhooksBreaks on page changes
CostFrom $1.20 per 1,000 callsFreeServers and engineering time
AI agentsMCP server includedNoneBuild 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.

Get started

Start pulling Telegram data in 60 seconds

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