Telegram Public API
## Real-Time Access to Public Telegram Data TG Gateway API gives developers programmatic access to public Telegram data through **12 read-only REST endpoints** — powered by MTProto, not the limited Bot API. Read Telegram channel messages, get channel info and member lists, search across public channels, resolve usernames, and fetch full user profiles. All responses are sanitized and returned as…
8.8/10 popularity
985 ms avg latency
73% success rate
16 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Telegram Public API endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
/mcp /mcp |
Streamable HTTP MCP transport. Same X-RapidAPI-Proxy-Secret auth as REST. Body is a JSON-RPC 2.0 envelope; see https://modelcontextprotocol.io. |
| GET |
/healthz /healthz |
Returns 200 if the process is up. No upstream dependency. |
| GET |
/v1/channels /v1/channels |
channels.getChannels — fetch a batch of channels by id. The response's per-session errors[] array is stripped. |
| GET |
/health /health |
Returns 200 if the process is up. No upstream dependency. |
| GET |
/v1/peers/{peer_id}/messages/{msg_id}/replies /v1/peers/{peer_id}/messages/{msg_id}/replies |
messages.getReplies. |
| GET |
/v1/users/{peer_id} /v1/users/{peer_id} |
users.getFullUser for the given peer_id. |
| GET |
/v1/phones/{phone} /v1/phones/{phone} |
Look up a phone number (international format) and return its profile envelope. |
| GET |
/v1/usernames/{username} /v1/usernames/{username} |
Look up a public username and return its profile envelope. |
| GET |
/v1/peers/{peer_id}/messages/{msg_id}/discussion /v1/peers/{peer_id}/messages/{msg_id}/discussion |
messages.getDiscussionMessage. |
| GET |
/v1/peers/{peer_id}/history /v1/peers/{peer_id}/history |
messages.getHistory for a peer. |
| GET |
/v1/messages/search /v1/messages/search |
Search messages across the upstream session's accessible scope. |
| GET |
/v1/channels/{peer_id}/messages /v1/channels/{peer_id}/messages |
channels.getMessages — fetch the listed message IDs from a channel. |
| GET |
/v1/channels/{peer_id} /v1/channels/{peer_id} |
channels.getFullChannel for the given peer_id. |
| GET |
/v1/openapi.json /v1/openapi.json |
Returns this OpenAPI document. |
| GET |
/v1/channels/recommendations /v1/channels/recommendations |
Recommendations for a specific channel (peer_id query) or generic if omitted. |
| GET |
/v1/contacts/search /v1/contacts/search |
Hybrid contact + global directory search. |
