Telegram Profile Scraper: Channel, Group, Bot & User Info
Pricing
from $1.50 / 1,000 profiles
Telegram scraper for profiles in bulk: from usernames or t.me links, each telegram channel, group, bot or user with the exact subscriber or member count, title, bio, photo, verified, numeric id, newest post. Optional channel posts with views, reactions, comments and keyword search. No login.
row_type
Optional
profile = one per unique input (the entity's record, or a free row saying why there is none); post = one per post of a channel.
input
Optional
The value as you gave it (the first form, when the same entity was given several ways). On post rows: the channel's input.
input_index
Optional
The input's 1-based position in your list.
inputs_merged
Optional
Later values of your list that named the same entity (@durov and its link after durov); read once, one row.
profile_status
Optional
ok = a public channel, group, bot or user (charged). Free rows: not_found (no public entity has the name — read on two exits, because Telegram serves a missing name and a rate-limited reader the same page), invalid (not a Telegram username or link), failed (Telegram answered something else; read again later).
status_detail
Optional
Why a row has no record, in words (null on ok rows).
scraped_at
Optional
When the row was read (UTC).
username
Optional
The public username, as Telegram writes it (null for an invite link).
entity_type
Optional
channel, group, bot or user, read from the page: the count line (subscribers, members, monthly users), then the title and the button.
title
Optional
The channel's, group's or bot's title, or the user's name.
description
Optional
The description or bio, line breaks and emoji kept.
profile_url
Optional
The profile's public page (t.me/<username>).
avatar_url
Optional
The profile photo on Telegram's CDN (a signed link that changes on each read; null when there is no photo).
verified
Optional
Telegram's verified mark.
warning_label
Optional
Telegram's own warning label on the profile, as its page shows it next to the title (FAKE, SCAM); null when there is none. It is never part of title.
invite_link
Optional
The invite link you gave, for a group or channel read through one.
count
Optional
The entity's headline count, exact as Telegram writes it on the profile page: subscribers of a channel, members of a group, monthly users of a bot (null for a user).
count_type
Optional
What count counts: subscribers, members or monthly_users.
count_text
Optional
The count line exactly as the page shows it ("10 493 438 subscribers", "5 365 members, 1 163 online").
counts_precision
Optional
exact when count is the page's exact figure.
subscribers
Optional
A channel's subscribers, exact.
subscribers_shown
Optional
The subscriber count as the channel's preview rounds it ("10.5M").
members
Optional
A group's members, exact.
members_online
Optional
A group's members online at the moment of the read.
monthly_users
Optional
A bot's monthly users, exact.
chat_id
Optional
The numeric id of a channel (from its public posts) or of a public group (deepProfile, from its first message), in Telegram's own form (1006503122). Null for bots and users: no logged-out page shows theirs.
bot_api_id
Optional
The same id in the Bot API's form (-100 followed by chat_id).
has_preview
Optional
The channel shows its posts on the web (its /s/ preview); only such channels have post rows.
preview_url
Optional
The channel's web preview.
photos_count
Optional
Photos the channel posted, from its preview (rounded above 999, as counters_shown says).
videos_count
Optional
Videos the channel posted (rounded above 999).
files_count
Optional
Files the channel posted (rounded above 999; 0 when the preview shows no files counter).
links_count
Optional
Links the channel posted (rounded above 999).
counters_shown
Optional
The preview's counters exactly as written (subscribers "10.5M", photos "1.38K", …).
counters_precision
Optional
exact when every counter is written in full, rounded when one is written rounded ("1.38K" above 999).
latest_post_id
Optional
The channel's newest post (the last one on its preview: the preview lists posts oldest first).
latest_post_at
Optional
When the newest post was published (UTC).
latest_post_url
Optional
The newest post's link.
created_at
Optional
deepProfile: when the channel or group was created, or the earliest date the page shows (see created_at_source).
created_at_source
Optional
channel_created = post 1, Telegram's "Channel created" message (exact); first_post = post 1 is an ordinary post; oldest_post = post 1 is gone, the oldest post left (the channel existed by then); first_message = a group's first message (the group existed by then); post_1_embed = a channel without a public preview: the date of its post 1 in Telegram's embed widget, which does not show whether post 1 is the "Channel created" message (the channel existed by then).
linked_chat_id
Optional
The id of a channel's linked discussion group (deepProfile or comments), from the comments widget; on post rows, the group the comments came from.
engagement_posts
Optional
How many of the newest posts (the preview's first page, service messages left out) the engagement fields are computed over.
avg_views
Optional
Average views of those posts, as the page shows them (rounded above 999).
median_views
Optional
Median views of those posts.
avg_reactions
Optional
Average reactions per post (all emoji and paid Stars together).
view_rate
Optional
Median views ÷ subscribers. On post rows: the post's views ÷ the channel's subscribers.
engagement_rate
Optional
Average reactions ÷ average views.
posts_per_week
Optional
Posting rate over the span of those posts.
dominant_script
Optional
The writing system most letters of the description and the newest posts are in (Latin, Cyrillic, Arabic, Han, …); links and handles left out.
posts_requested
Optional
Posts asked for this channel (maxPostsPerChannel, or 100 when a post filter set it).
posts_delivered
Optional
Post rows this run delivered for the channel.
posts_note
Optional
Why a channel delivered fewer posts than asked (no older post, no public preview, Telegram's search ended, the newest an earlier run delivered, maxItems or your charge limit reached), and how comments were read.
deep_note
Optional
deepProfile: what could not be read and why — a bot's or a user's id and creation date (Telegram's web pages do not show them; they need a Telegram login, which this Actor does not use), a group whose first message is gone, a channel whose post 1 is gone (created_at is then a bound), a channel without a public preview (its id and date come from its post 1's embed; no linked group), an invite link.
change_type
Optional
With the memory on: new, changed or unchanged against the last time this profile was delivered.
changed_fields
Optional
Which watched fields changed (count, title, description, latest_post_id, …).
previous_read_at
Optional
When the profile was last delivered.
previous_count
Optional
count at that time.
count_change
Optional
count minus previous_count.
count_change_per_day
Optional
count_change per day since the previous read (null under an hour).
first_read_at
Optional
When the memory first read this profile.
times_read
Optional
How many runs read it, this one included.
count_history
Optional
The memory's last 30 reads: time, count, count type, online.
markdown
Optional
includeMarkdown: the profile and its delivered posts as Markdown.
run_tag
Optional
Your runTag, on every row.
channel_title
Optional
On post rows: the channel's title.
channel_subscribers
Optional
On post rows: the channel's exact subscriber count at the time of the run.
post_id
Optional
The post's number in its channel. Deduplicate on username + post_id.
post_url
Optional
The post's public link.
published_at
Optional
When the post was published (UTC).
is_edited
Optional
The post carries Telegram's "edited" mark.
text
Optional
The post's text, line breaks and emoji kept.
text_length
Optional
Characters in text.
mentions
Optional
@usernames the post mentions.
links
Optional
Links in the post's text.
views
Optional
Views as the page shows them, as a number (2.09M → 2090000); views_precision says when it is rounded. Telegram shows exact views only to its apps.
views_shown
Optional
Views exactly as written ("2.09M").
views_precision
Optional
exact (under 1,000) or rounded.
reactions
Optional
Each reaction: emoji (or the custom emoji's id), count, paid for Telegram Stars, the count as written and its precision.
reactions_total
Optional
All reactions of the post together.
reactions_precision
Optional
rounded when a reaction count is written rounded on the page ("21.4K"), so reactions_total and paid_stars are sums of rounded values; exact otherwise.
paid_stars
Optional
The paid Star reactions of the post.
forwarded_from
Optional
The name of the chat a forwarded post came from.
forwarded_from_url
Optional
The original post's link, when public.
reply_to_post_id
Optional
The post this one replies to.
media
Optional
Photos (every photo of an album), videos (with duration), GIFs (gif: a looping clip, no duration), round videos, voice notes, music files (title, performer), documents (name, size) and stickers, with their CDN links (signed, valid for a while). A video too big for Telegram's web page has its thumbnail and duration, too_big: true and no file link (open the post in the app).
media_types
Optional
The kinds of media in the post.
media_not_supported
Optional
True when Telegram's web page does not show the post's media ("Please open Telegram to view this post"): open the post in the app.
link_preview
Optional
The link preview: URL, site, title, description, image.
poll
Optional
A poll: question, type, voters (and as written, with its precision: "71.7K" is rounded), options with their share in percent.
matched_search
Optional
Your postsSearch, on the posts it found.
comments_status
Optional
ok, not_available (Telegram's "Discussion is not available": no public comments for the post), or not_asked (the channel's newest 5 posts had no discussion, so older posts were not asked; see posts_note).
comments
Optional
maxCommentsPerPost: the comments: author name, handle (when public), text or media (a sticker, photo or video), date, the comment it replies to and reactions.
error
Optional
true on the one row a rejected input writes; absent on a result row
code
Optional
why the input was rejected, as a code (INPUT REJECTED runs only)
message
Optional
what to change, in words (INPUT REJECTED runs only)
comments_count
Optional
How many comments the post has (the widget's own count).