# Telegram API — UnifAPI

> Public channels, posts, reactions. Read public Telegram channels and groups with subscriber counts, a channel's posts with views and reactions, and single posts by id.

- Category: Social platforms
- API base URL: https://api.unifapi.com
- Auth: `Authorization: Bearer <UnifAPI API key>` (OAuth recommended for MCP clients)
- MCP server: https://mcp.unifapi.com
- Developer docs: https://docs.unifapi.com/api/telegram
- OpenAPI spec: https://unifapi.com/openapi.json
- HTML page: https://unifapi.com/apis/telegram
- Full catalog: https://unifapi.com/apis.md

## Agent workflows

- Monitor public Telegram channels for announcements, news and community sentiment in crypto, finance and media.
- Rank a channel's posts by views and emoji reactions to see which messages reach the audience.
- Track forwarded posts and replies to follow how a message spreads between public channels.

## Endpoints (3)

Every endpoint returns the UnifAPI JSON envelope (`request_id`, `data`, `pagination` on lists, `billing`) and bills max(records × credits per record, minimum) in credits.

### Get a Telegram channel or group

`GET /telegram/channels/{username}`

Returns a public Telegram channel or group by username: title, description, subscriber or member count, online count and avatar. Returns `not_found` when the username does not exist or the entity is restricted.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path)
- Details: https://unifapi.com/apis/telegram/channels/username/get
- Docs: https://docs.unifapi.com/api/telegram/channels/username/get

### List posts from a Telegram channel

`GET /telegram/channels/{username}/posts`

Returns recent public posts from a Telegram channel, newest first: text, views, reactions, media and forwards. Groups are not supported. Paginate with `cursor`.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path)
- Details: https://unifapi.com/apis/telegram/channels/username/posts/get
- Docs: https://docs.unifapi.com/api/telegram/channels/username/posts/get

### Get a Telegram channel post

`GET /telegram/channels/{username}/posts/{id}`

Returns one public post from a Telegram channel by channel username and post id (the number at the end of a t.me link). Returns `not_found` when the post does not exist.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path), `id` (path)
- Details: https://unifapi.com/apis/telegram/channels/username/posts/id/get
- Docs: https://docs.unifapi.com/api/telegram/channels/username/posts/id/get

## Related APIs

- [Truth Social API](https://unifapi.com/apis/truth-social/index.md) — Profiles, posts, engagement
- [Snapchat API](https://unifapi.com/apis/snapchat/index.md) — Public profiles, Spotlight videos, comments
- [Twitch API](https://unifapi.com/apis/twitch/index.md) — Channels, videos, clips, schedules
- [Pinterest API](https://unifapi.com/apis/pinterest/index.md) — Pins, boards, search
- [Rumble API](https://unifapi.com/apis/rumble/index.md) — Videos, channels, search, comments, transcripts
- [Bluesky API](https://unifapi.com/apis/bluesky/index.md) — Profiles, posts, replies