Get Telegram channel post
Get a single public post from a Telegram channel by handle and post ID. Groups are not supported.
Operation
/v1/telegram/channels/{handle}/posts/{postId}Headers
API key (`sfk_...`)
Parameters
min 1 chars
Numeric Telegram channel post ID from the public URL.
max 20 chars · pattern: ^\d+$
Response fields
Endpoint-specific response payload.
Domain outcome of the channel/post lookup. Always check this before reading `post`.
one of: found, not_found, restricted
The post when lookupStatus is `found`; null when `not_found` or `restricted`.
Unique post ID within the channel.
Post text as simplified HTML (<br> line breaks, <a href> links, custom tg-emoji expanded to unicode, common HTML entities decoded so arrows and quotes read naturally in JSON). Null if the post contains only media.
ISO 8601 publication timestamp.
View count from the public feed. Telegram may abbreviate large values (e.g. 1.13M → 1130000). Null for very recent posts.
Original channel name if this post was forwarded.
Reply/quote preview when this post replies to another channel message; null otherwise.
Numeric post ID of the message being replied to, from the public t.me link in the reply preview.
Channel or author name shown in the reply preview bar.
Preview snippet of the replied-to message as shown in the embed (often truncated). May be a short media label such as Photo when Telegram does not show body text.
Photo URLs from Telegram CDN. May expire over time; download promptly if needed.
Video URL if the post contains a video. May expire over time; download promptly if needed.
Reaction counts shown on the public preview page. Empty when Telegram omits them for a post.
Unicode reaction emoji when Telegram exposes it in the public HTML (including Stars as ⭐). Null for premium/custom animated reactions — use customEmojiId and emojiImageUrl.
Telegram custom emoji document id when the reaction uses a premium/custom emoji.
Preview image URL for custom emoji reactions (from Telegram's public emoji metadata). Null for standard unicode reactions.
True when the reaction is a Telegram Stars paid reaction.
Number of users who added this reaction.
≥ 0
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.post`.
Error codes