Telegram Channel Posts API
Provide one of: handle, url. Get one page of recent public posts from a Telegram channel or group.
Quick start
cURL
curl --request GET 'https://api.fetchproof.com/v1/telegram/channel/posts?handle=telegram' \
--header 'x-api-key: YOUR_API_KEY' JavaScript
const response = await fetch("https://api.fetchproof.com/v1/telegram/channel/posts?handle=telegram", {
method: 'GET',
headers: {
'x-api-key': process.env.FETCHPROOF_API_KEY,
},
});
const data = await response.json();
console.log(data); Python
import os
import requests
response = requests.get(
"https://api.fetchproof.com/v1/telegram/channel/posts?handle=telegram",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]},
)
print(response.json()) Go
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.fetchproof.com/v1/telegram/channel/posts?handle=telegram", nil)
req.Header.Set("x-api-key", os.Getenv("FETCHPROOF_API_KEY"))
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
} PHP
<?php
$ch = curl_init("https://api.fetchproof.com/v1/telegram/channel/posts?handle=telegram");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
'x-api-key: ' . getenv('FETCHPROOF_API_KEY'),
],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response; {
"success": true,
"credits_remaining": 100,
"credits_charged": 1,
"channel": {
"handle": "telegram",
"name": "Telegram News",
"description": "The official Telegram on Telegram. Much recursion. Very Telegram. Wow.",
"url": "https://t.me/telegram",
"avatar_url": "https://cdn1.telesco.pe/file/mktE6jqCd_p2WJgwpI1v3131_oZ98wUI_nZ8FXSF39uyIUQ_g0DU6crT9qBsigAQA2mFDS9rTBfFxOwN9hM6BxHbhJelulPhgAxIpIkeLsZgUERliQcor_S00-TgLX75qN6aItFisicK5l5trpNNJjAFup8WcuJCBrbBbYvtmtyuHgyc7Igf8RX8TaE1w7_r_F5hKqJyyiDFLFHACMOSG2vIIZNSFHzV0J3aVdL7iidr57UPt3jcLbWO-mIGI38jS_XGxMUI14KhFnGlFekT3g4wx6h4fj1gmKMh7ubrJ39gpUd_6yfaLuchme6MeX9ov7JBcNFVkrLDmo5ZlnkuSQ.jpg",
"is_verified": true,
"subscriber_count": 9100000,
"subscriber_count_text": "9.1M",
"member_count": null,
"member_count_text": null,
"photo_count": 16,
"video_count": 228,
"file_count": null,
"link_count": 378
},
"posts": [
{
"id": "460",
"channel_handle": "telegram",
"url": "https://t.me/telegram/460",
"author_name": null,
"author_url": null,
"text": "For all the info from today's update and a look back at 13 years of Telegram features — check out our blog:\nhttps://telegram.org/blog/welcome-messages-buttons-TG-13\n\nAugust Features\n1 • 2 • 3 • 4 • 5 • More",
"published_at": "2026-08-26T19:12:34+00:00",
"view_count": 2590000,
"view_count_text": "2.59M",
"reactions": [],
"reaction_count": 0,
"forwarded_from": null,
"media": [
{
"type": "photo",
"url": "https://cdn4.telesco.pe/file/UmfUCzZBsibBALzAbSuZUzkFgfl3jXgD2toJoXJ0pQkv5h9s4tusVTLJQ-c9KJWi_cR_PLlPEpeGCrMZPuDw_IyzVnZikLIhzX--LXb5PRslNOVlH_icRTDZ7fTqEBOZ2flLQ3DD8ateJxiZPkQhSeDxB5bCzqmj5yl4vjxtw-ZUKlF-3qpZtbFVM_ztfoC82tgCz4B-NUoG89oX9zvRrz9FA3Gj06WWeXIVD27ILjlR9VlM74hmcX_pOZtc5Kx_QRZjRZBHB3ORxMddQ7j6ILMKbO1LF4Fpos1UqwufjkCPBmlbnesBJ1n4Yu0R2LWZCzmd-6B7gn6eSzQk3usLfQ.jpg"
}
],
"link_preview": null
},
{
"id": "459",
"channel_handle": "telegram",
"url": "https://t.me/telegram/459",
"author_name": null,
"author_url": null,
"text": "Signed Gifts. You can now add your signature and a comment to gifts you buy via the gift marketplace.\n\nAugust Features\n1 • 2 • 3 • 4 • 5 • More",
"published_at": "2026-08-26T19:12:24+00:00",
"view_count": 2290000,
"view_count_text": "2.29M",
"reactions": [],
"reaction_count": 0,
"forwarded_from": null,
"media": [
{
"type": "photo",
"url": "https://cdn1.telesco.pe/file/pQgMA1e_lPQHAEEk6HK0SH-khLtoa7lxb-0Y7foiFbGHXN8msLhcKk74W62Xlpds2WWsTU6_qYqHS1fkINQ6z4u-VJEG5adf2BA6EDxsPpZs5nhXNsr6j82_IK4HrhYmG8mt6gLhTlDVT1TfG009l7ZpqHBYOwdQPRZQSFdMUGliF72qAkIo8WKjTKLf1s0c0Ly0b7-dP1RvAG60OdYfO7icWR9_xw3jJXAW4TDNLCBk80oKqzpCsyFwSfVwDSvvAuY7SmpLgwLHXh2B2sUbtCE-h9gToQRYtXBtfP5NpwaP02oGZUmQ-ThDW1mirrrRKFfVSVGIhcS036_bKoYSoA"
}
],
"link_preview": null
},
{
"id": "458",
"channel_handle": "telegram",
"url": "https://t.me/telegram/458",
"author_name": null,
"author_url": null,
"text": "Placeholders for App Updates. If a user with an outdated app encounters a new feature, they can now instantly tap to download the latest update.\n\nAugust Features\n1 • 2 • 3 • 4 • 5 • More",
"published_at": "2026-08-26T19:12:04+00:00",
"view_count": 1400000,
"view_count_text": "1.4M",
"reactions": [],
"reaction_count": 0,
"forwarded_from": null,
"media": [
{
"type": "photo",
"url": "https://cdn1.telesco.pe/file/D611DjBivf8nEXEyDdVhcWeG5IeyH_cwSW19BC18aEFf89Gjw-eYo_OSeS5qK4lvibEk_KnV2_DIff0je22Jf2B7knAi34kh1npPo5LbRSn7DoWpduKkRbWgY0sPREH_L4APIyt0Zm0r3VtF8N86QKizlEOkqNYmr4JMZSXtk2J71pHFchGQQtpnu_I_lq9IhV89gl41QcLEYWPbxq4JxGKGKrSuOtrJjcRLCGlc0Dp_U8IkavCuyLaOHzua691A9wcGw2X0KTR6pBqepajD1pKNzwWPhD-WLCYg6fE-veTb0CCURAU6_NFxvubaZYAkFv8Y1-ka6kb0td7TE4Zv9Q.jpg"
}
],
"link_preview": null
}
],
"cursor": "441",
"has_more": true
} What it returns
- success boolean
- credits_remaining integer
- credits_charged integer
- channel object
- posts array
- cursor string
- has_more boolean
- cached boolean
- cached_at string
Parameters
Public Telegram handle, @handle, or t.me channel URL.
Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.
Numeric cursor returned by the previous page. Omit it for the latest posts.
Use cases
- Collect public announcements from a release channel
- Build a digest of posts from a selected channel
- Find updates published during a public incident
- Index posts before reviewing cited messages individually
Billing
Errors cost zero credits, and so do cache hits through cache_max_age. Empty results follow this operation’s rules.
Default: 1 credit
An empty result costs 0 credits.
How charges are determined
Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.
A call that fails costs 0 credits. A result served from cache costs 0 credits.
`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.
A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).
A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Related Telegram endpoints
FAQ
How much does the Telegram Channel Posts API cost?
A call costs 1 credit by default. Errors cost 0 credits, and a cached result served through cache_max_age costs 0. New accounts get 100 free credits with no card. After that, credits come in one-time packs that never expire: 25,000 for $27 and 500,000 for $297 (plus any tax). There is no subscription.
What do I need to call it?
An API key in the x-api-key header, plus handle, and one of handle or url. You don't need a Telegram account or developer app.
What does it return?
Typed JSON. Top-level fields include channel, posts, cursor, has_more, cached and cached_at. The full schema and a real sample response are on this page and in the API reference.
Is this an official Telegram API?
No. Fetchproof is an unofficial API that returns public Telegram data only.