Get recent posts from a Telegram channel or group
curl --request GET \
--url https://api.scraperize.com/v1/telegram/channel/posts \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/telegram/channel/posts"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/telegram/channel/posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/telegram/channel/posts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/telegram/channel/posts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/telegram/channel/posts")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/telegram/channel/posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"posts": [
{
"id": 460,
"url": "https://t.me/telegram/460",
"handle": "telegram",
"channelId": -1005640892,
"date": "2026-08-26T19:12:34.000Z",
"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",
"views": 1160000,
"author": "Telegram News",
"authorUrl": "https://t.me/telegram",
"authorPhotoUrl": "https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg",
"verified": false,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [],
"linkPreview": {
"url": "https://telegram.org/blog/welcome-messages-buttons-TG-13",
"siteName": "Telegram",
"title": "Welcome Messages, Buttons in Messages and Signed Gifts",
"description": "Introducing Welcome Messages to greet new members of groups or channels, Buttons in Messages to make any text interactive, Inline Documents in Messages and much more.",
"imageUrl": "https://cdn4.telesco.pe/file/Hm0oiqWmOdvVJZnDTu-5Oporg5lXLRegzo_yNBPsLR8qjsdDSVXOPGk5Ad5LXgFsfpLsotH5d_WvcBn7UPFL0H3YhFHP8wj0ROuxI_Y0hnkWnf3Qpiv0IVzRK1QPk_KND51ZkcjYscq6vHK_Ii6YX_G1eypAZfKHjUJFXC1FspFb8lpXg6CfqRV69ADDlHdp8yfmGgHRq0VekqjRHXoMTWDY9_OuxYEHTTEWdetWg7sLiKikVLqKZ1537MQ1xKdXwxS_NtCRfgAn_1M_9C2s37JX7QQ4qTmwimS6JQGpu_UFWFIjbjZZsyo602npIj42OVrcJkk_KAReVYArYiIUVw.jpg"
},
"reactions": []
},
{
"id": 459,
"url": "https://t.me/telegram/459",
"handle": "telegram",
"channelId": -1005640892,
"date": "2026-08-26T19:12:24.000Z",
"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",
"views": 1030000,
"author": "Telegram News",
"authorUrl": "https://t.me/telegram",
"authorPhotoUrl": "https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg",
"verified": false,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [
{
"type": "video",
"url": "https://cdn1.telesco.pe/file/6efb59a075.mp4?token=Mp8wYHzBRmQJrNqbtMWI5lgEkw9y55dKc65A4gxDhheBu36MO_6JfMCSFvQAY6FW0ECOk1Z5JoieEbQFgJ9k_ZX17TTwpHlBO4FkogDf-jzTqf0-vxOp_a2im0EFGpWeDYdCjsL1czVW8TcjnGIFlq-lncXwcCUBDZCtcKHqpPgo-mUMuKfLmxry9hDj-gM-c7N2dqc1WD-NQsXkfk00e-21T1gn7WEH7vlgbhXEb6PjIt5ffPDb58cDEAfduKrGR7Yr40pjk4eP9XJU3DyqJjfrhDnc4kMjOcAYEXTj53pImqjTXyfxJlq3fGlbJXtkfq-sOk9i870ALenDtywMAw",
"thumbnailUrl": "https://cdn1.telesco.pe/file/plXiZXTLCnNgLWbomr6_t_x4DvqWOq-0VxjGFS3wJ52-e7xfPlJ2lVwQE3IiqxKFNP8dQBxqwUUh2nrIiGXyMdPnsVSwrZugIuGjfS4Ytg46n8VkzfdYZ5DKiPq1gTebgessVz-ST5xK7idzVZYT7-BMjjYBccUz8U9RUB_mqewVxCzuiycPpGKWfLd4dtylYbvmKZJJ7cLPT-6xXEavQZ72lkAe-qHbg6k9V9gwlbJOBmycDAWp6gTXHwM2S_gtvo-uhWVyzuuS6LqT6Uub2P306HI23sJINxXgYdGehhy8Gq59govii_e2mTLnsbTPXYuJPr0X6OYYMxMUZ-rtXQ",
"duration": "0:12"
}
],
"linkPreview": null,
"reactions": []
},
{
"id": 458,
"url": "https://t.me/telegram/458",
"handle": "telegram",
"channelId": -1005640892,
"date": "2026-08-26T19:12:04.000Z",
"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",
"views": 688000,
"author": "Telegram News",
"authorUrl": "https://t.me/telegram",
"authorPhotoUrl": "https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg",
"verified": false,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [
{
"type": "photo",
"url": "https://cdn1.telesco.pe/file/g1Lxu_K1sEq4MksNdTbEMfTQiPfnsgdaHS2guVzZ4nE1OJO6bAskOTBi_HUhRo_4oZY43cVVdKsxzZfJ3yeFTGKIS39G-R0gGAiGn4mEa_tUGTfRyoOaPgoWJlsrxZMwpw0e_T-6UTbQ_pqbv44wthrZ3Q8swCjgEDxQB9FS9bvED2T6bPsehUk19tB6CEOtd9-EEDhCOGr-PktY5AzoeaZF06bf5g-ilxSOHSyLBiSUNcP9l2BG-q78MV_Zl8HP0OMEYa7wkp3Unjm-X3e2giiVgcCZm6XcyXfUmsirGQwYmSLOMOHVJUa3u1Bkn3H6kLj18ZM5HPq4uffXFlwT1w.jpg",
"thumbnailUrl": null,
"duration": null
}
],
"linkPreview": null,
"reactions": []
}
],
"count": 20,
"paging": {
"cursor": "441",
"hasMore": true
},
"fetchedAt": "2026-09-14T12:14:56.940Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Telegram
Get recent posts from a Telegram channel or group
Fetches the recent public posts of a Telegram channel/group by handle — each with its text, date, view count, author, media (photos/videos with thumbnails + durations), link preview, and reactions. Paginated (older posts) via a numeric cursor.
GET
/
v1
/
telegram
/
channel
/
posts
Get recent posts from a Telegram channel or group
curl --request GET \
--url https://api.scraperize.com/v1/telegram/channel/posts \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/telegram/channel/posts"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.scraperize.com/v1/telegram/channel/posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.scraperize.com/v1/telegram/channel/posts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.scraperize.com/v1/telegram/channel/posts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.scraperize.com/v1/telegram/channel/posts")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/telegram/channel/posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": {
"posts": [
{
"id": 460,
"url": "https://t.me/telegram/460",
"handle": "telegram",
"channelId": -1005640892,
"date": "2026-08-26T19:12:34.000Z",
"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",
"views": 1160000,
"author": "Telegram News",
"authorUrl": "https://t.me/telegram",
"authorPhotoUrl": "https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg",
"verified": false,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [],
"linkPreview": {
"url": "https://telegram.org/blog/welcome-messages-buttons-TG-13",
"siteName": "Telegram",
"title": "Welcome Messages, Buttons in Messages and Signed Gifts",
"description": "Introducing Welcome Messages to greet new members of groups or channels, Buttons in Messages to make any text interactive, Inline Documents in Messages and much more.",
"imageUrl": "https://cdn4.telesco.pe/file/Hm0oiqWmOdvVJZnDTu-5Oporg5lXLRegzo_yNBPsLR8qjsdDSVXOPGk5Ad5LXgFsfpLsotH5d_WvcBn7UPFL0H3YhFHP8wj0ROuxI_Y0hnkWnf3Qpiv0IVzRK1QPk_KND51ZkcjYscq6vHK_Ii6YX_G1eypAZfKHjUJFXC1FspFb8lpXg6CfqRV69ADDlHdp8yfmGgHRq0VekqjRHXoMTWDY9_OuxYEHTTEWdetWg7sLiKikVLqKZ1537MQ1xKdXwxS_NtCRfgAn_1M_9C2s37JX7QQ4qTmwimS6JQGpu_UFWFIjbjZZsyo602npIj42OVrcJkk_KAReVYArYiIUVw.jpg"
},
"reactions": []
},
{
"id": 459,
"url": "https://t.me/telegram/459",
"handle": "telegram",
"channelId": -1005640892,
"date": "2026-08-26T19:12:24.000Z",
"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",
"views": 1030000,
"author": "Telegram News",
"authorUrl": "https://t.me/telegram",
"authorPhotoUrl": "https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg",
"verified": false,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [
{
"type": "video",
"url": "https://cdn1.telesco.pe/file/6efb59a075.mp4?token=Mp8wYHzBRmQJrNqbtMWI5lgEkw9y55dKc65A4gxDhheBu36MO_6JfMCSFvQAY6FW0ECOk1Z5JoieEbQFgJ9k_ZX17TTwpHlBO4FkogDf-jzTqf0-vxOp_a2im0EFGpWeDYdCjsL1czVW8TcjnGIFlq-lncXwcCUBDZCtcKHqpPgo-mUMuKfLmxry9hDj-gM-c7N2dqc1WD-NQsXkfk00e-21T1gn7WEH7vlgbhXEb6PjIt5ffPDb58cDEAfduKrGR7Yr40pjk4eP9XJU3DyqJjfrhDnc4kMjOcAYEXTj53pImqjTXyfxJlq3fGlbJXtkfq-sOk9i870ALenDtywMAw",
"thumbnailUrl": "https://cdn1.telesco.pe/file/plXiZXTLCnNgLWbomr6_t_x4DvqWOq-0VxjGFS3wJ52-e7xfPlJ2lVwQE3IiqxKFNP8dQBxqwUUh2nrIiGXyMdPnsVSwrZugIuGjfS4Ytg46n8VkzfdYZ5DKiPq1gTebgessVz-ST5xK7idzVZYT7-BMjjYBccUz8U9RUB_mqewVxCzuiycPpGKWfLd4dtylYbvmKZJJ7cLPT-6xXEavQZ72lkAe-qHbg6k9V9gwlbJOBmycDAWp6gTXHwM2S_gtvo-uhWVyzuuS6LqT6Uub2P306HI23sJINxXgYdGehhy8Gq59govii_e2mTLnsbTPXYuJPr0X6OYYMxMUZ-rtXQ",
"duration": "0:12"
}
],
"linkPreview": null,
"reactions": []
},
{
"id": 458,
"url": "https://t.me/telegram/458",
"handle": "telegram",
"channelId": -1005640892,
"date": "2026-08-26T19:12:04.000Z",
"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",
"views": 688000,
"author": "Telegram News",
"authorUrl": "https://t.me/telegram",
"authorPhotoUrl": "https://cdn1.telesco.pe/file/qiLgJ9jp-i6JY5vDXmW2nFjWG3ZnnFoyifbztHx-hQP-_o6a6cUMY_naYKIUhTlKFDTpyzjTjocQeNWR5TFAwx47YQ36sC8siY0cRxqvGXDluS74sJgdSvVOazyvlfG_73Y6lQlGYDaRBDZCUplMVHQlOF5O19r3JrBrWDToxrsqGdzCy-v7JYosUKlzFRcJcxY0Xs3nWzwaQ3waOX6nVA4jWttQy3-ZrGu3y4mo17TDEAQjXg5EUnMImq6dewmTHiVLWlpWQAXTOLtqe_f1Ijwwpm5wwL1PmGBZKZaUSuVXWte9L_gQIy0pk1jVx3TT7arfAE3uBMVacGhIp--ZIA.jpg",
"verified": false,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [
{
"type": "photo",
"url": "https://cdn1.telesco.pe/file/g1Lxu_K1sEq4MksNdTbEMfTQiPfnsgdaHS2guVzZ4nE1OJO6bAskOTBi_HUhRo_4oZY43cVVdKsxzZfJ3yeFTGKIS39G-R0gGAiGn4mEa_tUGTfRyoOaPgoWJlsrxZMwpw0e_T-6UTbQ_pqbv44wthrZ3Q8swCjgEDxQB9FS9bvED2T6bPsehUk19tB6CEOtd9-EEDhCOGr-PktY5AzoeaZF06bf5g-ilxSOHSyLBiSUNcP9l2BG-q78MV_Zl8HP0OMEYa7wkp3Unjm-X3e2giiVgcCZm6XcyXfUmsirGQwYmSLOMOHVJUa3u1Bkn3H6kLj18ZM5HPq4uffXFlwT1w.jpg",
"thumbnailUrl": null,
"duration": null
}
],
"linkPreview": null,
"reactions": []
}
],
"count": 20,
"paging": {
"cursor": "441",
"hasMore": true
},
"fetchedAt": "2026-09-14T12:14:56.940Z"
},
"meta": {
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"creditsCharged": 1,
"creditsRemaining": 4999,
"cached": false
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required — pass it in the `x-api-key` header.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "This request costs 1 credit, but your balance is 0. Top up to continue.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested content was not found (it may not exist, be deleted, or be private).",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "Request validation failed",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f",
"details": [
{
"path": "url",
"message": "Required"
}
]
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — max 100 requests per 60s. Retry in ~30s.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}{
"error": {
"code": "UPSTREAM_BLOCKED",
"message": "The source was temporarily unavailable. Please try again shortly.",
"requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f"
}
}Authorizations
Your API key. Send it in the x-api-key header (or Authorization: Bearer <key>). Create and manage keys from your dashboard.
Query Parameters
A public Telegram handle or t.me URL, e.g. telegram or https://t.me/telegram.
Numeric cursor from a previous response's paging.cursor (pages to older posts).
Optional. Return a cached result if one this age or newer exists — served for 0 credits with meta.cached=true and meta.cachedAt. Otherwise a fresh scrape runs (1 credit) and refreshes the cache. Omit to always scrape fresh.
Available options:
1d, 3d, 7d, 14d, 30d