List Telegram channel posts
List recent posts from a public Telegram channel. Groups are not supported.
Headers
Get your API keyAPI key (`sfk_...`)
Telegram public username (channel or group), with or without leading @.
min 1 chars · max 200 chars
Opaque pagination cursor from a previous response. Omit for the first page.
Endpoint-specific response payload.
Whether the channel was found, restricted, or not found.
one of: found, not_found, restricted
Posts in reverse chronological order (newest first) when lookupStatus is `found`. Empty 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
Pagination state for the current page of posts.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
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
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/posts" \
-H "x-api-key: YOUR_API_KEY"Responses
Channel posts listing.