Get one public Telegram post by URL
curl --request GET \
--url https://api.scraperize.com/v1/telegram/post \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/telegram/post"
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/post', 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/post",
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/post"
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/post")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/telegram/post")
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": {
"post": {
"id": 537,
"url": "https://t.me/durov/537",
"handle": "durov",
"channelId": -1006503122,
"date": "2026-08-03T07:19:56.000Z",
"text": "🧠 The 2026 International Olympiad in Artificial Intelligence starts today. \n\nAs a token of support for those who will reinvent our civilization, we'll issue 🏆 240 exclusive Intelligence Cups to the winners.\n\n💵 We guarantee minimum buyback prices ($1,000 per Gold Cup, etc.), but the cups' limited supply may make them worth much more on the secondary market.\n\nGood luck, AI coders! 🍀",
"views": 3500000,
"author": "Pavel Durov",
"authorUrl": "https://t.me/durov",
"authorPhotoUrl": "https://cdn4.telesco.pe/file/k2tiML_6ttxJk6Zg5YYhbnFSJqGztpz_mjVS5i3revt5DgSJAvd8yE_wyaHXM7N0lqjZDcX27mEzp7n_Ham47AG1tAz3KB770mTo5oHQa6Phj0bw85IQZ0LUR34w5TjHU9Guf5jQbQTjZtfnMyx0eQ1rOepPg4OTBK7UFTgInQKXaQu5WNarrkaWmPxlaBCXUzw7haaxNqp9JHEzV88v7YhioWluiwp2vFdgWQTzbcUQjnCcYE1_SFqBLqvhQRI0ppHvhSAQ6SadQ6wII0cAe8I_mNx_PiN2CCd1P0XgUTUcTCbKpTE7jCvo_TzNqWbTY1OCSYxblS8VULscCeG5Fw.jpg",
"verified": true,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [
{
"type": "photo",
"url": "https://cdn4.telesco.pe/file/MOfSapETy-s44EREUIBxzMyIi1a9_YqmoAdRi1VWcdlBhYX1bvZGn4Yx5K-EwrzQYs2wFD-Jc4cbEvWB4vEVaLyTv8wIobrQmIx4usYhPWzRIHjWqHO6Y7xHhRkHYzG03dGtaEoioYQzfry86oTTrgphRWJhItjXw9whINlMISOXoP-WlykffrQQxCMJaGJF_Hbvjd_3Wm7-hvTFoN1cgWtDiAYroAEKRRGSGjjt3BVicjyIkiNB6HFoKIzYt0WLVXSDNCYihqU5wGRUBSg8ga9BJbVoNShOPbf6qC3McNgm2N5yroo6muJKuJ6Teb9ja6pQxaE2yE6gp7b_o6fmjw.jpg",
"thumbnailUrl": null,
"duration": null
}
],
"linkPreview": null,
"reactions": [
{
"emoji": null,
"customEmojiId": null,
"paid": true,
"count": 15400,
"countText": "15.4K"
},
{
"emoji": null,
"customEmojiId": "5399847211989246390",
"paid": false,
"count": 39300,
"countText": "39.3K"
},
{
"emoji": null,
"customEmojiId": "5936157098181135162",
"paid": false,
"count": 11100,
"countText": "11.1K"
}
]
},
"fetchedAt": "2026-09-14T12:14:57.201Z"
},
"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 one public Telegram post by URL
Fetches a single public Telegram post by its URL (t.me/<handle>/<postNumber>) — with its text, date, view count, author (name, avatar, verified), media (photos/videos with thumbnails + durations), link preview, and reactions (standard / custom / paid).
GET
/
v1
/
telegram
/
post
Get one public Telegram post by URL
curl --request GET \
--url https://api.scraperize.com/v1/telegram/post \
--header 'x-api-key: <api-key>'import requests
url = "https://api.scraperize.com/v1/telegram/post"
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/post', 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/post",
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/post"
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/post")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.scraperize.com/v1/telegram/post")
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": {
"post": {
"id": 537,
"url": "https://t.me/durov/537",
"handle": "durov",
"channelId": -1006503122,
"date": "2026-08-03T07:19:56.000Z",
"text": "🧠 The 2026 International Olympiad in Artificial Intelligence starts today. \n\nAs a token of support for those who will reinvent our civilization, we'll issue 🏆 240 exclusive Intelligence Cups to the winners.\n\n💵 We guarantee minimum buyback prices ($1,000 per Gold Cup, etc.), but the cups' limited supply may make them worth much more on the secondary market.\n\nGood luck, AI coders! 🍀",
"views": 3500000,
"author": "Pavel Durov",
"authorUrl": "https://t.me/durov",
"authorPhotoUrl": "https://cdn4.telesco.pe/file/k2tiML_6ttxJk6Zg5YYhbnFSJqGztpz_mjVS5i3revt5DgSJAvd8yE_wyaHXM7N0lqjZDcX27mEzp7n_Ham47AG1tAz3KB770mTo5oHQa6Phj0bw85IQZ0LUR34w5TjHU9Guf5jQbQTjZtfnMyx0eQ1rOepPg4OTBK7UFTgInQKXaQu5WNarrkaWmPxlaBCXUzw7haaxNqp9JHEzV88v7YhioWluiwp2vFdgWQTzbcUQjnCcYE1_SFqBLqvhQRI0ppHvhSAQ6SadQ6wII0cAe8I_mNx_PiN2CCd1P0XgUTUcTCbKpTE7jCvo_TzNqWbTY1OCSYxblS8VULscCeG5Fw.jpg",
"verified": true,
"edited": false,
"forwardedFrom": null,
"replyToUrl": null,
"media": [
{
"type": "photo",
"url": "https://cdn4.telesco.pe/file/MOfSapETy-s44EREUIBxzMyIi1a9_YqmoAdRi1VWcdlBhYX1bvZGn4Yx5K-EwrzQYs2wFD-Jc4cbEvWB4vEVaLyTv8wIobrQmIx4usYhPWzRIHjWqHO6Y7xHhRkHYzG03dGtaEoioYQzfry86oTTrgphRWJhItjXw9whINlMISOXoP-WlykffrQQxCMJaGJF_Hbvjd_3Wm7-hvTFoN1cgWtDiAYroAEKRRGSGjjt3BVicjyIkiNB6HFoKIzYt0WLVXSDNCYihqU5wGRUBSg8ga9BJbVoNShOPbf6qC3McNgm2N5yroo6muJKuJ6Teb9ja6pQxaE2yE6gp7b_o6fmjw.jpg",
"thumbnailUrl": null,
"duration": null
}
],
"linkPreview": null,
"reactions": [
{
"emoji": null,
"customEmojiId": null,
"paid": true,
"count": 15400,
"countText": "15.4K"
},
{
"emoji": null,
"customEmojiId": "5399847211989246390",
"paid": false,
"count": 39300,
"countText": "39.3K"
},
{
"emoji": null,
"customEmojiId": "5936157098181135162",
"paid": false,
"count": 11100,
"countText": "11.1K"
}
]
},
"fetchedAt": "2026-09-14T12:14:57.201Z"
},
"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
The post URL t.me/<handle>/<postNumber> — e.g. https://t.me/durov/537 (also accepts t.me/s/… , a bare durov/537, or a tg://resolve deeplink).
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