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-10-17.

Start for freeSign in to run
3 of 6actions available
From 2 creditsper call
Same formatas every other call

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
You send
platformid or url
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://api.socialtoai.com/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -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
You send
platformusername
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://api.socialtoai.com/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -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
You send
platformusername
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://api.socialtoai.com/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -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.

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

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"    }  ],  "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": [],  "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
Account watchWhat each one posted lately, and which posts beat its usual numbersfrom 9 creditsCreator profileTheir accounts on other platforms, the numbers on each, and how sure the match isfrom 14 creditsBulk link dataOne row per link with its numbers as they are now. Links that no longer work are markedfrom 1 credit per link

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-17.

The same calls work on 17 more.

All platforms and prices
TikTokInstagramXRedditYouTubeFacebookLinkedInThreadsPinterestXiaohongshuDouyinWeiboWeChat ArticlesBilibiliZhihuKuaishouWeChat ChannelsMeta Ad LibraryGoogle Ads Transparency

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

Start for freeDocs

100 credits on sign-up, no card needed