Get Telegram channel
Get metadata for a public Telegram channel or group by username.
Operation
/v1/telegram/channels/{handle}Headers
API key (`sfk_...`)
Parameters
Telegram public username (channel or group), with or without leading @.
min 1 chars · max 200 chars
Response fields
Endpoint-specific response payload.
Domain outcome of the entity lookup. Always check this before reading `entity`.
one of: found, not_found, restricted
Entity data when lookupStatus is `found`; null when `not_found` or `restricted`.
Whether the handle resolves to a broadcast channel, group, user/bot, or unknown preview page.
one of: channel, group, user_or_bot, unknown
Display name.
Bio/description text. Line breaks are preserved when Telegram renders them on the public page.
Subscriber count for broadcast channels from Telegram's public page at t.me/{handle}. Null for groups and other entity types.
Member count for public groups/supergroups. Null for channels and other entity types.
Currently online member count when Telegram shows it on the public group page. Null for channels and other entity types.
URL of the avatar image when Telegram serves a CDN photo.
Whether the entity has a Telegram verified badge.
The canonical username/handle that was looked up.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Lookup result. Check `data.lookupStatus` for `found`, `not_found`, or `restricted` before reading `data.entity`. Returns channel or group metadata when `found`.
Error codes