Social — entry 030 of 39
Telegram Bot
The Telegram Bot API is a plain HTTP/JSON interface at api.telegram.org that lets developers build bots for messaging, inline queries, payments, and media without implementing the full MTProto client protocol — every request is scoped to a single bot token issued by @BotFather. It's free to use, with the only monetized surface being optional in-chat payments via Telegram Stars.
GreatAPIs Score
Embed this badge
<a href="https://greatapis.com/api/telegram-bot/"><img src="https://greatapis.com/badge/telegram-bot.svg" alt="Scored 84 on greatapis.com"></a>Auth quickstart
- Sign up with the provider to get an API key.
- Send it on every request as a header
Authorization: <key> - The exact header isn't documented — Authorization is a common default; confirm in the provider's docs.
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
addStickerToSet1
POST/addStickerToSet
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
answerCallbackQuery1
POST/answerCallbackQuery
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
answerInlineQuery1
POST/answerInlineQuery
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
answerPreCheckoutQuery1
POST/answerPreCheckoutQuery
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
answerShippingQuery1
POST/answerShippingQuery
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
close1
POST/close
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
copyMessage1
POST/copyMessage
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
createNewStickerSet1
POST/createNewStickerSet
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
deleteChatPhoto1
POST/deleteChatPhoto
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
deleteChatStickerSet1
POST/deleteChatStickerSet
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
deleteMessage1
POST/deleteMessage
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
deleteStickerFromSet1
POST/deleteStickerFromSet
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
deleteWebhook1
POST/deleteWebhook
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
editMessageCaption1
POST/editMessageCaption
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
editMessageLiveLocation1
POST/editMessageLiveLocation
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
editMessageMedia1
POST/editMessageMedia
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
editMessageReplyMarkup1
POST/editMessageReplyMarkup
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
editMessageText1
POST/editMessageText
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
exportChatInviteLink1
POST/exportChatInviteLink
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
forwardMessage1
POST/forwardMessage
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getChat1
POST/getChat
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getChatAdministrators1
POST/getChatAdministrators
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getChatMember1
POST/getChatMember
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getChatMembersCount1
POST/getChatMembersCount
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getFile1
POST/getFile
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getGameHighScores1
POST/getGameHighScores
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getMe1
POST/getMe
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getMyCommands1
POST/getMyCommands
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getStickerSet1
POST/getStickerSet
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getUpdates1
POST/getUpdates
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getUserProfilePhotos1
POST/getUserProfilePhotos
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
getWebhookInfo1
POST/getWebhookInfo
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
kickChatMember1
POST/kickChatMember
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
leaveChat1
POST/leaveChat
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
logOut1
POST/logOut
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
pinChatMessage1
POST/pinChatMessage
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
promoteChatMember1
POST/promoteChatMember
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
restrictChatMember1
POST/restrictChatMember
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendAnimation1
POST/sendAnimation
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendAudio1
POST/sendAudio
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendChatAction1
POST/sendChatAction
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendContact1
POST/sendContact
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendDice1
POST/sendDice
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendDocument1
POST/sendDocument
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendGame1
POST/sendGame
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendInvoice1
POST/sendInvoice
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendLocation1
POST/sendLocation
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendMediaGroup1
POST/sendMediaGroup
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendMessage1
POST/sendMessage
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendPhoto1
POST/sendPhoto
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendPoll1
POST/sendPoll
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendSticker1
POST/sendSticker
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendVenue1
POST/sendVenue
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendVideo1
POST/sendVideo
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendVideoNote1
POST/sendVideoNote
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
sendVoice1
POST/sendVoice
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setChatAdministratorCustomTitle1
POST/setChatAdministratorCustomTitle
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setChatDescription1
POST/setChatDescription
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setChatPermissions1
POST/setChatPermissions
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setChatPhoto1
POST/setChatPhoto
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setChatStickerSet1
POST/setChatStickerSet
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setChatTitle1
POST/setChatTitle
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setGameScore1
POST/setGameScore
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setMyCommands1
POST/setMyCommands
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setPassportDataErrors1
POST/setPassportDataErrors
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setStickerPositionInSet1
POST/setStickerPositionInSet
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setStickerSetThumb1
POST/setStickerSetThumb
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
setWebhook1
POST/setWebhook
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
stopMessageLiveLocation1
POST/stopMessageLiveLocation
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
stopPoll1
POST/stopPoll
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
unbanChatMember1
POST/unbanChatMember
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
unpinAllChatMessages1
POST/unpinAllChatMessages
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
unpinChatMessage1
POST/unpinChatMessage
application/json (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
uploadStickerFile1
POST/uploadStickerFile
multipart/form-data (required)
| Status | Description | Schema |
|---|---|---|
200 | — | |
default | Error |
Try it
Developer reference
https://api.telegram.org/bot{token}Telegram's Bots FAQ (core.telegram.org/bots/faq), not the API reference itself, sets the effective ceilings: avoid more than one message per second in a single chat (short bursts are tolerated before 429 errors start), no more than 20 messages per minute in the same group, and bulk/broadcast sends across different users capped at about 30 messages per second by default -- bot owners can raise that broadcast ceiling to up to 1,000 messages per second by enabling paid broadcasts via @BotFather, billed at 0.1 Telegram Stars per message beyond the free 30/sec allowance.
- POST/getMe
- POST/sendMessage
- POST/getUpdates