Telegram

Get Telegram channel

Get metadata for a public Telegram channel or group by username.

GET/v1/telegram/channels/{handle}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
handlestringrequiredpath

Telegram public username (channel or group), with or without leading @.

min 1 chars · max 200 chars

Response fields
17

Endpoint-specific response payload.

datalookupStatus
string

Whether the channel or group was found, restricted, or not found.

one of: found, not_found, restricted

Entity data when lookupStatus is `found`; null when `not_found` or `restricted`.

dataentityentityType
string

Resolved Telegram public entity type.

one of: channel, group, user_or_bot, unknown

dataentitytitle
stringnullable

Display name.

dataentitydescription
stringnullable

Bio/description text. Line breaks are preserved when Telegram renders them on the public page.

dataentitysubscriberCount
integernullable

Subscriber count for broadcast channels from Telegram's public page at t.me/{handle}. Null for groups and other entity types.

dataentitymemberCount
integernullable

Member count for public groups/supergroups. Null for channels and other entity types.

dataentityonlineCount
integernullable

Currently online member count when Telegram shows it on the public group page. Null for channels and other entity types.

dataentityavatarUrl
stringnullable

URL of the avatar image when Telegram serves a CDN photo.

dataentityisVerified
boolean

Whether the entity has a Telegram verified badge.

dataentityhandle
string

The canonical username/handle that was looked up.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metacached
booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/telegram/channels/durov" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Channel or group lookup result.