---
title: "Telegram Channel API: Read Posts, No api_id · SocialToAI"
canonical: https://socialtoai.app/platforms/telegram/
updated: 2026-10-30
---

# Telegram API

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.

- Page: https://socialtoai.app/platforms/telegram/
- Last updated: 2026-10-30
- Last tested: 2026-11-16

## Actions

| Action | What it returns | Selected by | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- | --- |
| `detail` | One message by ID or link: text, author, views and publish time. | — | `telegram.detail` | 2 | [Telegram Detail API](https://socialtoai.app/telegram-detail-api.md) |
| `user_profile` | One account: name, bio and followers. | — | `telegram.user_profile` | 2 | [Telegram User Profile API](https://socialtoai.app/telegram-user-profile-api.md) |
| `user_posts` | The recent messages of one account. | — | `telegram.user_posts` | 2 | [Telegram User Posts API](https://socialtoai.app/telegram-user-posts-api.md) |

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.

Lighter for your AI: across 3 interfaces measured on the same recorded data, the platform's raw JSON is about 18,151 tokens and SocialToAI's answers about 5,456, 69% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
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"
  }'
```

## Fields Telegram cannot give

These fields are always null on the calls named, and are listed in the response's `unavailable`.

| Field | On |
| --- | --- |
| `title` | detail, user_posts |
| `author.id` | detail, user_posts |
| `author.verified` | detail, user_posts |
| `author.followers` | detail, user_posts |
| `metrics.likes` | detail, user_posts |
| `metrics.comments` | detail, user_posts |
| `metrics.shares` | detail, user_posts |
| `metrics.collects` | detail, user_posts |
| `metrics.reposts` | detail, user_posts |
| `hashtags` | detail, user_posts |
| `is_pinned` | detail, user_posts |
| `id` | user_profile |
| `following` | user_profile |
| `posts_count` | user_profile |

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

## Ask in your AI

- How big is this Telegram account, and what has it posted lately? → user_profile, user_posts: 4 credits

- Look up this Telegram account and tell me who it is. → user_profile: 2 credits

- Compare these three Telegram accounts by followers and posts. → user_profile × 3: 6 credits

[Telegram MCP Server](https://socialtoai.app/mcp/telegram.md)

## Ready-made tools that read Telegram

- [Account snapshot](https://socialtoai.app/tools/account-watch.md): What each one posted lately, and which posts beat its usual numbers
- [Creator profile](https://socialtoai.app/tools/creator-card.md): Their accounts on other platforms, the numbers on each, and how sure the match is
- [Bulk link data](https://socialtoai.app/tools/batch-stats.md): One row per link with its numbers as they are now. Links that no longer work are marked

## 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](https://core.telegram.org/api/obtaining_api_id), 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](https://core.telegram.org/bots/faq), 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](https://core.telegram.org/api/obtaining_api_id), 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. | https://socialtoai.app/pricing.md |

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](https://socialtoai.app/free-tools/api-cost-estimator.md)

[Telegram official API: access, prices and limits](https://socialtoai.app/does-telegram-have-an-api.md)

- [Telegram MCP server](https://socialtoai.app/mcp/telegram.md): Let your AI read Telegram.
