Telegram Post API. Send a post link.

Views, reactions, media and forwards. We handle the proxies, blocks and platform changes.

Returns one post of a public Telegram channel or group from its t.me link, with its text, media, views and reactions. It also has the links, hashtags and mentions in it, its date, photos, albums, videos, voice messages and stickers with their files, its poll, link preview and file, what it was forwarded from or replies to, whether it was edited, its signature, and the channel's numeric ID. Accepts links on t.me, telegram.me and telegram.dog, or the post's id.

GET /v1/telegram/post

Read the API reference

1 credit per request, $0.75–$1.97 per 1,000 requests
22 typed fields null when unknown
url is all it needs, e.g. https://t.me/durov/546
100 credits free when you sign up, no card, so you can build before you spend

Send one request. Get 22 fields back.

Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free.

$ npm install socialtap

url = https://t.me/durov/546

Open in playground

GET /v1/telegram/postTry in

const params = new URLSearchParams({
  url: "https://t.me/durov/546",
});
const res = await fetch(`https://socialtap.dev/v1/telegram/post?${params}`, {
  headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" },
});
const body = await res.json();
if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`);
const { data, meta } = body;
console.log(data, meta.credits_charged);

import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/telegram/post",
    params={"url": "https://t.me/durov/546"},
    headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]},
)
body = res.json()
if not res.ok:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
data, meta = body["data"], body["meta"]
print(data, meta["credits_charged"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/telegram/post")
uri.query = URI.encode_www_form('url' => 'https://t.me/durov/546')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'url' => 'https://t.me/durov/546',
]);
$ch = curl_init('https://socialtap.dev/v1/telegram/post?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"net/http"
	"net/url"
	"os"
)

func main() {
	q := url.Values{}
	q.Set("url", "https://t.me/durov/546")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/telegram/post?"+q.Encode(), nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY"))
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()
	var body struct {
		Data  json.RawMessage `json:"data"`
		Meta  map[string]any  `json:"meta"`
		Error *struct {
			Code    string `json:"code"`
			Message string `json:"message"`
		} `json:"error"`
	}
	if err := json.NewDecoder(res.Body).Decode(&body); err != nil {
		log.Fatal(err)
	}
	if body.Error != nil {
		log.Fatalf("%s: %s", body.Error.Code, body.Error.Message)
	}
	fmt.Println(string(body.Data), body.Meta["credits_charged"])
}

curl -G 'https://socialtap.dev/v1/telegram/post' \
  --data-urlencode 'url=https://t.me/durov/546' \
  -H "x-api-key: $SOCIALTAP_API_KEY"

{
  "data": {
    "approximate_fields": [
      "metrics.view_count",
      "metrics.like_count",
      "platform_specific.telegram.reactions[].count"
    ],
    "author": {
      "avatar_url": "https://cdn4.telesco.pe/file/AM3EaKY4OWoCIpqIJGL2G4hcjBupbm4OuzSyAnEGF2gBOPJJIYOcnXbjDpqmilOWXXjheFFey4oGODL1BybYTdbTaJHo9qb3KEAIw9y3VvSrrKwoRdfBHWovcRqFmFEu5EeKeGrOZPTVcZEHBP6rbBp5qM4WbNdvEbGQLAnCPle0ArPYn70dJpY8D3zpJWbhZ2V1bnF2k0VXfyWUnokwHk6Q56QkaNg5gs1PhbGSaPshnBDj1xw7QOhLE-o…",
      "display_name": "Pavel Durov",
      "id": "durov",
      "is_verified": true,
      "url": "https://t.me/durov",
      "username": "durov"
    },
    "coauthors": [],
    "duration_ms": 20000,
    "hashtags": [],
    "id": "durov/546",
    "is_nsfw": null,
    "is_pinned": null,
    "is_sponsored": null,
    "language": null,
    "media": [
      {
        "alt_text": null,
        "duration_ms": 20000,
        "expires_at": null,
        "height": 1920,
        "thumbnail_url": "https://cdn4.telesco.pe/file/oSUZWQy5ajo9qNzPTyVfWPmynW0e-n68CIbR2KJvGHXnnmSLUlvzUGAE3bGypAec9zc8kk1sHdcB0soW00CX-tKMVdzpwisCSYN_ZGrIBu9T637jvBhDK6eG8TLUWI7J9TyTGa5Y7qk3U3meRc7EBvCBrz-HyX61s0SkkfG-akkNQH1bm-ZOLdUKGsKIN2MmVccLPNINVf3cdzMiJcta6zKY1hLXMGAzeV45qpPy1MEGGmYJmhwsuareyIN…",
        "type": "video",
        "url": "https://cdn4.telesco.pe/file/e0b2769474.mp4?token=SCRUBBED",
        "width": 1920
      }
    ],
    "mentions": [],
    "metrics": {
      "comment_count": null,
      "like_count": 80950,
      "quote_count": null,
      "repost_count": null,
      "save_count": null,
      "share_count": null,
      "view_count": 4280000
    },
    "platform": "telegram",
    "platform_specific": {
      "telegram": {
        "buttons": [],
        "channel_id": "1006503122",
        "document": null,
        "forwarded_from": null,
        "is_edited": false,
        "link_preview": null,
        "links": [],
        "message_id": 546,
        "poll": null,
        "reactions": [
          {
            "count": 35700,
            "custom_emoji_id": null,
            "emoji": null,
            "is_paid": true
          },
          {
            "count": 28400,
            "custom_emoji_id": "5399847211989246390",
            "emoji": null,
            "is_paid": false
          },
          {
            "count": 9350,
            "custom_emoji_id": "5373223594484587136",
            "emoji": null,
            "is_paid": false
          }
        ],
        "reply_to": null,
        "sender_name": null,
        "signature": "Pavel Durov"
      }
    },
    "platform_type": "video",
    "published_at": "2026-08-31T16:30:15Z",
    "text": "🏳️ Gram Wallet in Telegram is ready and is now accessible to a select group of users.\n\n🤩 We'll be gradually rolling it out to our billion+ users over the next couple of weeks.\n\n⚡️ Thanks to the validators who approved the smart contract that powers it, future upgrades of the wall…",
    "thumbnail_url": "https://cdn4.telesco.pe/file/oSUZWQy5ajo9qNzPTyVfWPmynW0e-n68CIbR2KJvGHXnnmSLUlvzUGAE3bGypAec9zc8kk1sHdcB0soW00CX-tKMVdzpwisCSYN_ZGrIBu9T637jvBhDK6eG8TLUWI7J9TyTGa5Y7qk3U3meRc7EBvCBrz-HyX61s0SkkfG-akkNQH1bm-ZOLdUKGsKIN2MmVccLPNINVf3cdzMiJcta6zKY1hLXMGAzeV45qpPy1MEGGmYJmhwsuareyIN…",
    "title": null,
    "type": "video",
    "unknown_fields": [],
    "url": "https://t.me/durov/546"
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "telegram",
    "source": "page",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 321,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": {
      "kind": "post",
      "id": "durov/546",
      "url": "https://t.me/durov/546"
    },
    "credits_remaining": 9999,
    "client_request_id": null,
    "warnings": []
  }
}

import { SocialTap } from "socialtap";

const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY

const res = await client.telegram.post.get({ url: "https://t.me/durov/546" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "url=" + encode("https://t.me/durov/546");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/telegram/post?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "url=" + Uri.EscapeDataString("https://t.me/durov/546"));
var res = await http.GetAsync("https://socialtap.dev/v1/telegram/post?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/telegram/post")
        .query(&[("url", "https://t.me/durov/546")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/telegram/postLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 21 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

Null means unknown
A field Telegram doesn't show is null, never zero or an empty string, so a real zero always means zero.
What it accepts
A Telegram post: its link (t.me/<name>/<number>, also on telegram.me and telegram.dog, the channel page's t.me/s/<name>/<number>, a forum topic's t.me/<name>/<topic>/<number>, the account's own host <name>.t.me/<number>, with any query) or its id as this API writes it (<name>/<number>).
Write one parser
Telegram, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all.

platformstring: Platform ID (tiktok, youtube, …).
idstring: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix).
urlstring: Canonical post URL.
typestring: Normalized content shape. New values may be added; treat unknown values as other.
platform_typestring: The platform's own product label, lowercase (reel, short, story, live, tweet, …).
titlestring: Headline (YouTube title, Reddit title); null on caption-only platforms.
textstring: Caption, description or body as plain text.
languagestring: BCP-47 language of text, when the platform states it.

What teams build with the Telegram Post API.

Read a post from a shared link
Track a post's views and reactions over time
Read a public group's message by link
Trace a forward to its original post

Good to know before you build.

Views, reactions and voters are as Telegram shows them, rounded from the thousands up (10.4K), and the rounded ones are listed in approximate_fields.
An album returns under the number you asked, with all of its files, whichever of its numbers you asked. The Telegram Channel Posts API lists it under its first number.
A link with ?comment= returns the post the comment is under, not the comment.
In a public group, author is the member who sent the message. A member without a username has nothing to refer to them by, so author is then the group and platform_specific.telegram.sender_name the member's name.
Service messages (a channel's creation, a changed name or photo) return platform_type service and their sentence as text. In a group the page doesn't show the sentence, so text is null.
Telegram's pages sometimes leave a forward's origin out: forwarded_from is then present with a null name and url.
Media links can stop working after a while, so download what you need promptly. A video too big for Telegram's web page has its poster and duration but no url.
Some posts Telegram's web page won't show ("Please open Telegram to view this post"). They return platform_type unsupported, their date, views and reactions, null text, and media among their unknown_fields: their [] means unknown, not none.
An audio file is a post of type audio with its title and performer in platform_specific.telegram.document. Telegram's web page doesn't link the file, so its media url is null.
A post that doesn't exist returns not_found, as does a name that is no channel or group, since Telegram says the same of a user and a bot. A channel Telegram won't display returns private_or_unavailable, with its reason where it gives one, and this can depend on the country a request leaves from.

1 credit per request. Failed requests are free.

Buy credits once and spend them on any endpoint, on any platform.

Plans and packs How this endpoint is priced How credits work

Source	Price per successful request	Per 1,000 requests
Public page `page`	1 credit	$0.75–$1.97

Cache hits are free.
Credits from packs and top-ups never expire.
A monthly plan's credits are spent first, and what is left of them ends at each renewal.
Prices exclude tax: sales tax is added at checkout where it applies.
Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID.

Questions about the Telegram Post API.

Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

Telegram Post API. Send a post link.

Telegram Post API at a glance

Send one request. Get 22 fields back.

One schema on 21 platforms.

Null means unknown

What it accepts

Write one parser

What teams build with the Telegram Post API.

Read a post from a shared link

Track a post's views and reactions over time

Read a public group's message by link

Trace a forward to its original post

Good to know before you build.

1 credit per request. Failed requests are free.

Questions about the Telegram Post API.

Posts on 20 more platforms.

Telegram API. 4 endpoints, one key.

Try it on a link you already have.