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.
Last tested: Last updated:
/v1/detail200 OK2 creditsplatform: "telegram" · id: "telegram/401"nullcomments nullshares nullcollects nullviews 4,350,000titleauthor.idauthor.verifiedauthor.followers+73 actions.
One response format.
Open a row to see its request. Its full parameters and response fields are on its own page.
DetailOne message by ID or link: text, author, views and publish time./v1/detail2 credits≈ $0.0067
platformid or urlcurl 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 headerUser ProfileOne account: name, bio and followers./v1/user_profile2 credits≈ $0.0067
platformusernamecurl 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 headerUser PostsThe recent messages of one account./v1/user_posts2 credits≈ $0.0067$0.33 per 1,000 (up to 20 a page)
platformusernamecurl 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 headerNot 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 job | How it adds up | Credits | About |
|---|---|---|---|
| Backfill one Telegram account: a list of 200 messages and 20 in full | 10 list pages + 20 full reads | 60 credits | about $0.20 |
| Watch 1 Telegram account daily, at most a month | 10 credits × 31 days | 310 credits | about $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.
How big is this Telegram account, and what has it posted lately?
- user_profilethe account you named2 credits
- user_postsits latest page2 credits
Look up this Telegram account and tell me who it is.
- user_profilethe account you named2 credits
Compare these three Telegram accounts by followers and posts.
- user_profile3 accounts6 credits
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.
{ "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}titleauthor.idauthor.verifiedauthor.followersmetrics.likesmetrics.commentsmetrics.sharesmetrics.collectsmetrics.repostshashtagsis_pinned{ "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}author.verifiedauthor.followersmetrics.viewsmetrics.reposts3 tools read Telegram.
All toolsDoes 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 it | Cost | Limits | Source | |
|---|---|---|---|---|
| Bot API | Anyone: 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 |
| SocialToAI | Anyone 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 MCP serverLet your AI read Telegram.