We offer two kinds of APIs for developers. The Bot API allows you to easily create programs that use Telegram messages for an interface. The Telegram API and TDLib allow you to build your own customized Telegram clients. You are welcome to use both APIs free of charge.
You can also add Telegram Widgets to your website.
This API allows you to connect bots to our system. Telegram Bots are special accounts that do not require an additional phone number to set up. These accounts serve as an interface for code running somewhere on your server.
To use this, you don't need to know anything about how our MTProto encryption protocol works — our intermediary server will handle all encryption and communication with the Telegram API for you. You communicate with this server via a simple HTTPS-interface that offers a simplified version of the Telegram API.
Bot developers can also make use of our Payments API to accept payments from Telegram users around the world.
Even if you're looking for maximum customization, you don't have to create your app from scratch. Try our Telegram Database Library (or simply TDLib), a tool for third-party developers that makes it easy to build fast, secure and feature-rich Telegram apps.
TDLib takes care of all network implementation details, encryption and local data storage, so that you can dedicate more time to design, responsive interfaces and beautiful animations.
TDLib supports all Telegram features and makes developing Telegram apps a breeze on any platform. It can be used on Android, iOS, Windows, macOS, Linux and virtually any other system. The library is open source and compatible with virtually any programming language.
This API allows you to build your own customized Telegram clients. It is 100% open for all developers who wish to create Telegram applications on our platform. Feel free to study the open source code of existing Telegram applications for examples of how things work here. Don't forget to register your application in our system.
How to get your application identifier and create a new Telegram app.
How to register a user's phone to start using the API.
How to login to a user's account if they have enabled 2FA, how to change password.
QR code login flow
How to handle API return errors correctly.
How to connect to the closest DC access point for faster interaction with the API, and things to watch out for when developing a client.
How to subscribe to updates and handle them properly.
How to subscribe and handle them properly.
How to handle channels, supergroups, gigagroups, basic groups, and what's the difference between them.
Telegram allows creating forums with multiple distinct topics.
Telegram offers detailed channel statistics for channels and supergroups.
Additional options for calling methods.
How to transfer large data batches correctly.
How to fetch results from large lists of objects.
The MTProto API has multiple client configuration parameters that can be fetched with the appropriate methods.
Important checks required in your client application.
Binding temporary authorization key to permanent ones.
Ways to boost API interactions.
A list of available high-level methods.
Text and JSON-presentation of types and methods used in API.
A list of available schema versions.
How to work with bots using the MTProto API.
Bots offer a set of commands that can be used by users in private, or in a chat.
Users can interact with your bot via buttons or even inline buttons, straight from inline messages in any chat.
Bots can choose the behavior of the menu button shown next to the text input field.
Users can interact with your bot via inline queries, straight from the text input field in any chat.
Bots can offer users HTML5 games to play solo or to compete against each other in groups and one-on-one chats; how to work with games in the MTProto API.
Bots can offer users interactive HTML5 mini apps to completely replace any website.
Bots can install attachment menu entries, offering conveniently accessible, versatile mini apps.
Telegram users and channels can easily post and view stories through the API.
The API offers a method to obtain a list of similarly themed public channels, selected based on similarities in their subscriber bases.
Telegram users and channels can change the accent color and background pattern of their profile page and their messages!
Telegram allows users to specify granular privacy settings, choosing which users can or can't interact with them in certain ways.
Telegram allows applying detailed message filters while looking for messages in chats. This allows the server to filter messages based on a text query, and even on their type, and this feature is often used by graphical clients to implement features like the chat gallery, chat profile pictures and more.
Telegram allows sending polls and quizzes, that can be voted on by thousands, if not millions of users in chats and channels.
Telegram allows users to react on any message using specific emojis, triggering cute lottie animations.
Telegram allows users to set an emoticon or a custom emoji as status, to show next to their name in chats and profiles.
Channels, basic groups and supergroups may have a public username or a private invite link: private invite links may be further enhanced with per-user join requests.
How to handle admin permissions, granular bans and global permissions in channels, groups and supergroups.
Both supergroups and channels offer a so-called admin log, a log of recent relevant supergroup and channel actions, like the modification of group/channel settings or information on behalf of an admin, user kicks and bans, and more.
Telegram allows pinning multiple messages on top of a specific chat.
Telegram allows mentioning other users in case of urgent duckling matters, and quickly navigating to those mentions in order to read them as swiftly as possible.
Telegram allows scheduling messages.
Telegram allows sending the live geolocation of a user in a chat, optionally setting a proximity alert.
How to delete a Telegram account.
Telegram allows importing messages and media from foreign chat apps.
How to work with Telegram Passport directly using the MTProto API.
How to work with Telegram Payments directly using the MTProto API.
How to create styled text with message entities
Telegram clients support displaying animated, static and video stickers.
Telegram allows including custom animated, static and video emojis directly inside of messages.
Graphical telegram clients should transform emojis into their respective animated version.
Telegram supports sending animated dice emojis.
How to handle message drafts
Working with folders
If enabled, the rating of top peers indicates the relevance of a frequently used peer in a certain category (frequently messaged users, frequently used bots, inline bots, frequently visited channels and so on).
How to handle file references.
Handle Seamless Telegram Login URL authorization requests.
How to work with chat backgrounds.
How to work with chat notification sounds.
How to transcribe voice messages.
Telegram allows translating chat messages, and Telegram Premium users may even enable real-time chat translation.
Admins of supergroups with a certain number of members can choose to unleash the full proactive power of Telegram's own antispam algorithms – turning on the new Aggressive mode for the automated spam filters.
Telegram users can make it easy for others to contact them or find their public groups and channels via usernames: clients can also assign multiple collectible usernames to accounts, supergroups and channels they own.
Sometimes, when interacting with Telegram users via private or secret chats, an action bar must be shown on top of the chat, offering convenient action buttons or notices regarding the user.
The Saved Messages chat allows users to bookmark messages and media: it's a personal cloud storage for any messages or media you may want to send or forward there.
Working with contacts in the API.
Working with the blocklist.
How to work with geolocation-based features like geochats and the nearby users feature.
When interacting with HTML5 games and the websites of payment gateways, Telegram apps should expose the following JS APIs.
Telegram's API allows users to export all of their information through the takeout API.