SocialToAIStart freeConsole

Telegram API

Messages, accounts.

The Telegram API lets you read message details, account profiles and an account's messages, with no Telegram account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Telegram does not give the author's follower count with a post, so that field is returned as null. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-16.

3 of 6actions available
From 2 creditsper call
69% fewer tokensfor your AI than the raw JSON (3 interfaces measured)

Last tested: Last updated:

POST/v1/detail200 OK2 credits
platform: "telegram" · id: "telegram/401"
@…·
likes nullcomments nullshares nullcollects nullviews 4,350,000
Always null here:titleauthor.idauthor.verifiedauthor.followers+7
itemsOne object
billingThis call2 credits
Sample dataFull response

3 actions.
One response format.

Open a row to see its request. Its full parameters and response fields are on its own page.

ActionsCredits per call
DetailOne message by ID or link: text, author, views and publish time./v1/detail2 credits≈ $0.0067
You send
platformid or url
Telegram Detail API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "telegram",    "id": "telegram/401"  }'
POST /v1/detailYour key goes in the Authorization header
User ProfileOne account: name, bio and followers./v1/user_profile2 credits≈ $0.0067
You send
platformusername
Telegram User Profile API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "telegram",    "username": "telegram"  }'
POST /v1/user_profileYour key goes in the Authorization header
User PostsThe recent messages of one account./v1/user_posts2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
You send
platformusername
Telegram User Posts API: All parameters and response fields
Sign in to run2 creditsOpens this call in the Playground after you sign in. It never runs by itself, and a failed call is not charged.
cURL
curl https://socialtoai.app/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \  -H "Idempotency-Key: $(uuidgen)" \  -H "Content-Type: application/json" \  -d '{    "platform": "telegram",    "username": "telegram"  }'
POST /v1/user_postsYour key goes in the Authorization header

Not offered on Telegram: search, trending and comments.

Compared with X: Telegram messages do not give author followers, likes, comments, saves, reposts or hashtags; its accounts do not give following or posts.

What a whole job costs.

The jobHow it adds upCreditsAbout
Backfill one Telegram account: a list of 200 messages and 20 in full10 list pages + 20 full reads60 creditsabout $0.20
Watch 1 Telegram account daily, at most a month10 credits × 31 days310 creditsabout $1.03

Priced at the $10 pack; larger purchases bring it down. A watch runs only while it is on, and you can pause it at any time. There is no subscription.

Or skip the parameters.
Just ask.

Connect SocialToAI once over MCP. Your AI picks the calls, and you see what each one cost.

You ask01

How big is this Telegram account, and what has it posted lately?

Your AI calls
  • user_profilethe account you named2 credits
  • user_postsits latest page2 credits
Total4 credits
You ask02

Look up this Telegram account and tell me who it is.

Your AI calls
  • user_profilethe account you named2 credits
Total2 credits
You ask03

Compare these three Telegram accounts by followers and posts.

Your AI calls
  • user_profile3 accounts6 credits
Total6 credits

Telegram MCP Server

Same shape on every platform.
Learn it once.

A Telegram message and a Xiaohongshu note come back with the same field names. What a platform cannot give comes back as null.

Telegramdetail · 2 credits
{  "platform": "telegram",  "id": "…",  "ref": "…",  "approx": [    {      "field": "metrics.views",      "kind": "approximate"    }  ],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "video",  "title": null,  "text": "…",  "published_at": "2021-01-11T21:57:12.000Z",  "author": {    "id": null,    "username": "…",    "name": "…",    "verified": null,    "followers": null  },  "metrics": {    "likes": null,    "comments": null,    "shares": null,    "collects": null,    "views": 4350000,    "reposts": null  },  "images": [],  "hashtags": null,  "is_pinned": null}
Null on Telegram:titleauthor.idauthor.verifiedauthor.followersmetrics.likesmetrics.commentsmetrics.sharesmetrics.collectsmetrics.repostshashtagsis_pinned
Xiaohongshudetail · 12 credits
{  "platform": "xiaohongshu",  "id": "…",  "ref": "…",  "approx": [],  "extra": {},  "type": "content",  "url": "https://example.com/…",  "format": "image",  "title": "…",  "text": "…",  "published_at": "2026-10-09T01:00:34.000Z",  "author": {    "id": "…",    "username": "…",    "name": "…",    "verified": null,    "followers": null  },  "metrics": {    "likes": 927,    "comments": 122,    "shares": 256,    "collects": 59,    "views": null,    "reposts": null  },  "images": ["https://example.com/…", "https://example.com/…"],  "hashtags": ["…", "…"],  "is_pinned": false}
Null on Xiaohongshu:author.verifiedauthor.followersmetrics.viewsmetrics.reposts
Sample dataThe fields are always there; only the values differ.

3 tools read Telegram.

All tools

Does Telegram have an official API?

Telegram's API is open to all developers: anyone with a Telegram account can obtain an API ID at my.telegram.org. It is a full client API that covers channels (which can be public) and message search, and use is subject to Telegram's API Terms of Service.

Source: Telegram's developer documentation, checked 2026-10-30.

Who can use itCostLimitsSource
Bot APIAnyone: each bot gets its own token when it is created.Messaging users is free by default; paid broadcasts above 30 messages a second cost 0.1 Stars a message.An HTTP interface for bots. A bot receives messages only from chats and channels it is a member of; sending too fast returns 429 errors.core.telegram.org, checked 2026-10-30
Telegram API (api_id and api_hash)Anyone with a Telegram account: sign in at my.telegram.org, open API development tools and fill in the form. One api_id per phone number.Telegram's page states no price.A full client API that signs in as a user account. Clients must follow the API Terms of Service; accounts that log in through unofficial clients are put under observation, and flooding or faking counters gets an account banned.core.telegram.org, checked 2026-10-30
SocialToAIAnyone with a key; no Telegram account of yours and no review.From 2 credits a call (≈$0.0067); failed calls are free.Publicly visible content only; up to 20 items a call.Pricing

1,000 messages here: about 50 telegram.user_posts calls (typically 20 a page), 100 credits, $0.33 at the first pack. Estimate your cost

Telegram official API: access, prices and limits

The same calls work on 17 more.

All platforms and prices

Your AI is one URL away
from all of social media.

100 credits on sign-up, no card needed