Telegram Channel Scraper — Posts API, Views & Media | $0.50/1k
Pricing
from $0.40 / 1,000 results
Scrape public Telegram channels without login: posts with text, views, photos, videos, files, link previews, reactions and forwards, plus exact subscriber counts. Date range and keyword search. Export JSON, CSV or Excel.
URL
url
Required
Post link (https://t.me//) or channel link (https://t.me/).
Status
status
Required
ok = data extracted; not_found = not a public channel, or no post matched; error = Telegram could not be read (see error).
Error
error
Optional
Human-readable reason when status is error or not_found.
Scraped at
scrapedAt
Required
ISO 8601 timestamp of extraction.
Row type
type
Optional
post for a channel post, channel for the channel profile row, related for the related-channels row (includeRelatedChannels).
Channel
channel
Optional
Channel username without @ (the channel's primary username as Telegram spells it).
Channel title
channelTitle
Optional
The channel's display name.
Post ID
postId
Optional
Post number inside the channel; newer posts have higher numbers.
Posted at
postedAt
Optional
Publication time, ISO 8601 UTC.
Text
text
Optional
Post text or media caption as plain text, line breaks kept, emoji as characters.
Text (HTML)
textHtml
Optional
Only with includeTextHtml: the post body with basic formatting (b, i, u, s, code, pre, blockquote, spoiler, links).
Views
views
Optional
View count as Telegram shows it ("18.9M" becomes 18900000, so large counts are rounded).
Forwarded
isForwarded
Optional
True when the post was forwarded from somewhere else.
Forwarded from
forwardedFrom
Optional
The source channel of a forward: channel, title, postUrl. Only set when the source is a public channel post; forwards from people are shown as isForwarded only.
Reply to post
replyToPostId
Optional
The earlier post in the same channel this post replies to.
Photos
photos
Optional
Photo URLs on Telegram's CDN (one per photo; albums give several). The links are signed by Telegram and can expire, so download what you need soon.
Videos
videos
Optional
One object per video: thumbnailUrl, duration ("2:11"), durationSeconds, and videoUrl when Telegram serves the file in the preview (small videos only).
Documents
documents
Optional
Attached files and audio: name, details (size or performer) and kind (file or audio).
Link preview
linkPreview
Optional
The link card under the post: url, siteName, title, description, imageUrl.
Poll
poll
Optional
Poll question, type and options with their vote percentages.
Mentions
mentions
Optional
@usernames linked in the text (without @), usually other channels.
Links
links
Optional
Web links in the text.
Reactions
reactions
Optional
One object per reaction: emoji and count; custom emoji carry customEmojiId instead, paid Star reactions carry paid: true.
Reactions total
reactionsCount
Optional
Sum of all reaction counts.
Edited
isEdited
Optional
True when Telegram marks the post as edited.
Search keyword
searchKeyword
Optional
The keyword whose search inside the channel found this post (only when keywords is used).
Channel description
description
Optional
Channel rows: the channel's description (bio).
Subscribers
subscribers
Optional
Channel rows: exact subscriber count from the channel's profile card (the rounded header figure if that card could not be read; see infoError).
Channel photo
photoUrl
Optional
Channel rows: profile photo URL.
Verified
verified
Optional
Channel rows: true when the channel has Telegram's verified badge.
Photos posted
photosCount
Optional
Channel rows: photos the channel has posted, as Telegram counts them (rounded when large).
Videos posted
videosCount
Optional
Channel rows: videos posted.
Files posted
filesCount
Optional
Channel rows: files posted.
Links posted
linksCount
Optional
Channel rows: links posted.
Profile card error
infoError
Optional
Channel rows: why the exact subscriber count could not be read (the row then carries the rounded figure).
Comments section public
commentsAvailable
Optional
Post rows with includeCommentsCount: false when Telegram shows no public comments section for the post.
Comment count error
commentsError
Optional
Post rows: why the comment count could not be read (the row is returned without it).
Posts analysed
postsAnalyzed
Optional
Related rows: how many of this channel's posts (returned in this run) the related list is built from.
Comments
commentsCount
Optional
Post rows with
includeCommentsCount: the public comment count under the post. Only the number is read, never the comments or their authors.