# Telegram API

> Public channels and their messages.

Canonical page: https://okdata.online/apis/telegram/

3 endpoints, $0.002 to $0.002 per call. Region: Global. No Telegram login or cookies needed.

| Endpoint | ID | Returns | Price |
|---|---|---|---|
| [Telegram channel profile](https://okdata.online/apis/telegram/channels/get/) | `telegram.channels.get` | Account | $0.002 per call |
| [Telegram channel messages](https://okdata.online/apis/telegram/channels/messages/list/) | `telegram.channels.messages.list` | Post[] | $0.002 per call · about 20 posts per page |
| [Telegram message detail](https://okdata.online/apis/telegram/messages/get/) | `telegram.messages.get` | Post | $0.002 per call |

## Good for

- Competitor monitoring: `telegram.channels.get`, `telegram.channels.messages.list`
- Creator discovery: `telegram.channels.get`
- Content research: `telegram.channels.messages.list`, `telegram.messages.get`

## At a glance

3 Telegram endpoints covering channels and messages, from $0.002 a call. No Telegram account or cookie needed, and a failed call costs nothing.

Categories: [Social media](https://okdata.online/categories/social/)

- **Endpoints**: 3 endpoints. In 2 groups, one response format.
- **Lowest price**: From $0.002. A call, paid from a prepaid balance.
- **Freshness**: Live. Read from the platform when you call.
- **Failed calls**: $0. Errors and timeouts are never charged.

- [Start free](https://okdata.online/console/)
- Try one: [Telegram channel profile](https://okdata.online/apis/telegram/channels/get/)
- Telegram in Claude, Cursor and other agents: [Telegram MCP](https://okdata.online/mcp/telegram/)

## Endpoints by group

### Channels (2)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Channel profile](https://okdata.online/apis/telegram/channels/get/) | `GET /v1/telegram/channels/get` | Account | $0.002 per call |
| [Channel messages](https://okdata.online/apis/telegram/channels/messages/list/) | `GET /v1/telegram/channels/messages/list` | Post[] | $0.002 per call |

### Messages (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Message detail](https://okdata.online/apis/telegram/messages/get/) | `GET /v1/telegram/messages/get` | Post | $0.002 per call |

- [Telegram API pricing](https://okdata.online/pricing/telegram/)
- [Telegram in your AI (MCP)](https://okdata.online/mcp/telegram/)
- [Live status](https://okdata.online/status/)

## What people do with Telegram data

- [Competitor monitoring](https://okdata.online/solutions/competitor-monitoring/): “What did our competitors post this week, and what took off?” [Channel profile](https://okdata.online/apis/telegram/channels/get/) $0.002, [Channel messages](https://okdata.online/apis/telegram/channels/messages/list/) $0.002
- [Content research](https://okdata.online/solutions/content-research/): “What do the top posts on this topic have in common?” [Channel messages](https://okdata.online/apis/telegram/channels/messages/list/) $0.002, [Message detail](https://okdata.online/apis/telegram/messages/get/) $0.002
- [Creator discovery](https://okdata.online/solutions/creator-discovery/): “Who are the mid-size creators in camping gear?” [Channel profile](https://okdata.online/apis/telegram/channels/get/) $0.002

## Start in three steps

1. Get a key: [open the console](https://okdata.online/console/). A new key comes with $0.10 to try, no card.
2. Connect your AI with this sentence (swap in your key), or call the API yourself:

   > Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.

3. Make the first call (Telegram channel profile). Items arrive in data.items, the next page in page.next_cursor, the charge in meta.billing.amount.

```bash
curl -G "https://api.okdata.online/v1/telegram/channels/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'username=telegram'
```

## Questions about the Telegram API

### What does the Telegram API cost?

Each of the 3 endpoints has its own price, $0.002 a call; the cheapest is Telegram channel profile at $0.002. You pay per call from a prepaid balance, with no subscription, and a failed call is not charged.

### Do I need a Telegram account or cookie?

No. You call https://api.okdata.online with one okdata key and get public Telegram data back; no Telegram account, cookie or QR login is involved.

### How fresh is the data?

Every endpoint reads Telegram at the moment you call; nothing is served from an old copy.

### Can my AI agent use the Telegram API?

Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 3 endpoints with their prices, and its call tool runs them on your key.

### Can I try it for free?

New accounts get $0.10 of trial credit with no card: enough for 50 calls to Telegram channel profile.

## Other platforms

[Douyin API](https://okdata.online/apis/douyin/) · [Xiaohongshu (RedNote) API](https://okdata.online/apis/xiaohongshu/) · [WeChat Official Accounts API](https://okdata.online/apis/wechat_mp/) · [Bilibili API](https://okdata.online/apis/bilibili/) · [Weibo API](https://okdata.online/apis/weibo/) · [TikTok API](https://okdata.online/apis/tiktok/) · [X (Twitter) API](https://okdata.online/apis/x/) · [YouTube API](https://okdata.online/apis/youtube/) · [Meta Ad Library API](https://okdata.online/apis/meta/) · [Google Ads Transparency API](https://okdata.online/apis/google/) · [Instagram API](https://okdata.online/apis/instagram/) · [Reddit API](https://okdata.online/apis/reddit/) · [Kuaishou API](https://okdata.online/apis/kuaishou/) · [Zhihu API](https://okdata.online/apis/zhihu/) · [WeChat Channels API](https://okdata.online/apis/wechat_channels/) · [WeChat Search API](https://okdata.online/apis/wechat/)