API catalog / Telegram API / Get a public channel

Telegram Channel API

Public Telegram channel profiles — title, description, subscriber count, verification and avatar — by username.

GEThttps://api.endpointry.com/v1/telegram/channel

Returns a public channel by username: title, description, subscriber count, verification badge and avatar. Returns `404 NOT_FOUND` when no public channel uses that username. Records are cached briefly and shared with `/messages`.

Query parameterseditable

channel *string

Response fields (data)

channel*	object
id*	integer
username*	string
url*	string · uri
title*	string
description*	string \| nullThe channel bio, when it has one.
type*	stringThe kind of chat this username resolves to.
verified*	boolean
subscribers*	integerSubscriber count as Telegram reports it.
image_url*	string · uri \| nullThe channel avatar at the highest resolution offered.

Response meta

request_idstring as_ofstring (ISO 8601)cache"HIT" | "MISS"

Platform fields, identical on every endpoint — what they mean.

Request

curl "https://api.endpointry.com/v1/telegram/channel?channel=telegram" \
  -H "Authorization: Bearer sk_live_..."

Loading…

Responseexample

200 · application/json

{
  "meta": {
    "request_id": "req_7729f93d3facf68ff83e5c50",
    "as_of": "2026-08-02T12:00:00.000Z",
    "cache": "MISS"
  },
  "data": {
    "channel": {
      "id": 1005640892,
      "username": "telegram",
      "url": "https://t.me/telegram",
      "title": "Telegram News",
      "description": "The official Telegram on Telegram. Much recursion. Very Telegram. Wow.",
      "type": "channel",
      "verified": true,
      "subscribers": 9929948,
      "image_url": "https://cdn1.telesco.pe/file/OlYOPa0mOv6odATduwSNDRktKzZ7zDgL.jpg"
    }
  }
}

What teams build with it

Channel directories and discovery products
Subscriber growth tracking over time
Verification and due-diligence checks
Enriching mentions of t.me links with live channel data

Frequently asked questions

Does it work for private channels or groups?

No — public channels only, addressed by their public username. Anything else returns 404 NOT_FOUND.

How precise is the subscriber count?

Exactly as Telegram reports it at snapshot time, as a number — "9929948", not "9.9M".

How fresh is the data?

Channel records are cached for a few minutes and shared with the messages endpoint; meta.as_of carries the read time.

Do I need a Telegram account or bot token?

No. One Endpointry API key is all it takes — no Telegram-side setup of any kind.

Telegram Channel API

What teams build with it

Frequently asked questions

More from the Telegram API

Try it with a free trial