Telegram
Telegram API, Telegram Channel API, Telegram Scraper, MTProto API, Telegram message history, channel members, user profiles, global search, Telegram OSINT, channel monitoring, Telegram analytics, MCP for AI agents, n8n, LangChain. Real-time access to public Telegram data — no bot token, no phone number. ## Real-Time Access to Public Telegram Data TG Gateway API gives developers programmatic…
Telegram endpoints
| Method | Endpoint | Description |
|---|---|---|
| health | ||
| GET |
health /health |
Returns 200 if the process is up. |
| Channels, Chats, Users | ||
| GET |
getChannelMessages /v1/channels/{peer_id}/messages |
Returns the listed message ids from a single channel. |
| GET |
getReplies /v1/peers/{peer_id}/messages/{msg_id}/replies |
Returns the discussion thread for a channel post. Use the `next_page`/`prev_page` cursors from the response to paginate. Fails with 404 if the post has no discussion thread. |
| GET |
getChannelRecommendations /v1/channels/recommendations |
Returns channels similar to `peer_id`. Omit `peer_id` for generic recommendations. |
| GET |
getDiscussionMessage /v1/peers/{peer_id}/messages/{msg_id}/discussion |
Returns the root message of a channel post's linked discussion thread. Fails with 404 if the post has no discussion thread. |
| GET |
getFullChannel /v1/channels/{peer_id} |
Returns the extended profile for a channel or supergroup. Fails with 404 if the channel does not exist. |
| GET |
getHistory /v1/peers/{peer_id}/history |
Returns paginated message history for a peer. Use the `next_page`/`prev_page` cursors from the response, or pass `offset_id` directly. |
| GET |
getFullUser /v1/users/{peer_id} |
Returns the extended profile for a user. Fails with 404 if the user does not exist. |
| GET |
getChannels /v1/channels |
Returns channel records for the listed ids. Unresolvable ids appear in `skipped[]`. |
| Discovery | ||
| GET |
resolveUsername /v1/usernames/{username} |
Returns the peer reference for a public username. Fails with 404 if the username is not registered. |
| GET |
resolvePhone /v1/phones/{phone} |
Returns the peer reference for a phone number in international format. Fails with 404 if no public profile is associated with the number. |
| GET |
globalSearch /v1/messages/search |
Returns public messages matching the query, sorted by recency. Use the `next_page`/`prev_page` cursors from the response (or pass `offset_id` directly) to paginate. |
| GET |
searchContacts /v1/contacts/search |
Returns matching peers from the public directory. |
| MCP | ||
| POST |
mcp /v1/mcp |
Streamable HTTP MCP transport. Body is a JSON-RPC 2.0 envelope; see https://modelcontextprotocol.io. |
| Files and photos | ||
| GET |
downloadFile /v1/files/{file_id} |
Streams the bytes of a file referenced by `file_id`. The id is obtained from a prior message, channel, or user response (look for `media.photo.id` or `media.document.id` in… |
| Other endpoints | ||
| GET |
getOpenAPIDocument /v1/openapi.json |
Returns this OpenAPI document. Cache-friendly. |
Telegram pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO | $9.99 / month | — |
|
| ULTRA | $29.99 / month | — |
|
| MEGA | $79.99 / month | — |
|