Telegram profile scraper for resolving up to 1,000 usernames, @handles, t.me URLs, accessible invites, or phone numbers into 41-field sparse profiles for users, bots, channels, groups, and supergroups, including identity, public flags, counts, business details, and photo links.
At a glance
| Store brand | TrueFetch — apify.com/truefetch |
|---|---|
| Pricing model | pay per event |
| Price per result row | $0.003 on the Free plan |
| 1,000 rows (Free plan) | $3.01 |
| 1,000 rows (Gold plan) | $2.26 |
| Default / max memory | 128 MB / 256 MB |
| Run timeout | 12 h |
| Public runs, last 30 days | 1,982 · 96.1% succeeded |
| Users | 56 in 30 days · 1,125 all time |
| First published | May 31, 2025 |
| Last build | 1.0.22 on August 18, 2026 |
What you have to give it
1 of the 1 input fields are required; the rest have defaults and can be left out.
| Field | Type | Required | Accepted values | What it does |
|---|---|---|---|---|
telegram_url | array | yes | telegram | Telegram profiles to resolve, one per line. Accepts 1 to 1,000 bare usernames, @handles, canonical t.me and t.me/s URLs, accessible invite references, or authorized international phone numbers. Equivalent identifiers are deduplicated, sensitive phone and invite correlations are masked, and free-plan runs keep the first 10 unique targets. |
A run that works
The values below are the Actor's own prefills, so this input is valid as written:
{
"telegram_url": [
"telegram"
]
}What comes back
Every dataset row carries the 41 fields below. The examples are the ones declared in the Actor's own output schema.
| Field | Type | Example | Meaning |
|---|---|---|---|
query_index | integer | null | 1 | One-based position in the original input list. |
query | string | null | @BotFather | Sanitized target used for correlation; phone numbers and invite tokens are masked. |
status | string | null | success | Outcome for this target: success, not_found, or unavailable when an account reached Telegram and the record could not be retrieved. |
type | string | null | channel | Telegram entity type. |
id | integer | null | 1005640892 | Stable Telegram entity identifier. |
username | string | null | telegram | Primary active public username. |
usernames | array | null | telegram | Active public usernames in Telegram order. |
source_url | string | null | https://t.me/telegram | Canonical public Telegram URL when an active username exists. |
title | string | null | Telegram News | Channel or group title. |
first_name | string | null | BotFather | User or bot first name. |
last_name | string | null | Example | User or bot last name when public. |
description | string | null | Official Telegram updates | Public biography or chat description. |
photo_url | string | null | https://api.apify.com/v2/key-value-stores/example/records/media-photo | Stored profile-photo URL when download and storage both succeed. |
has_photo | boolean | null | true | Whether Telegram reports a profile photo. |
flags | array | null | verified | True public entity labels such as verified, premium, scam, or restricted. |
restrictions | array | null | [object Object] | Public platform restriction reasons, if any. |
last_seen | string | null | recently | Telegram presence status or public UTC last-seen time. |
colors | object | null | {"name":{"color":5}} | Public name and profile color metadata. |
emoji_status | object | null | {"document_id":123} | Public emoji or collectible status without transport references. |
personal_channel | object | null | {"channel_id":123,"message_id":4} | Linked personal channel and message identifiers. |
birthday | object | null | {"day":1,"month":1} | Public birthday components. |
business | object | null | {"hours":{"timezone":"UTC"}} | Public business hours, location, intro, and enabled messaging features. |
profile_music | object | null | {"title":"Track","duration":30} | Public profile audio metadata without file references or access hashes. |
monetization | object | null | {"send_paid_messages_stars":10} | Public paid-message, gift, reaction, boost, and stars metadata. |
bot_info | object | null | {"features":["main_app"]} | Public bot features, commands, menu, and app colors. |
created_at | string | null | 2020-01-01T00:00:00+00:00 | UTC chat creation timestamp. |
member_count | integer | null | 1000 | Reported chat participant count. |
online_count | integer | null | 50 | Reported online participant count. |
chat_level | integer | null | 1 | Telegram chat level when reported. |
chat_flags | array | null | forum, paid_media | True public chat settings and capabilities. |
location | object | null | {"address":"Example","latitude":0,"longitude":0} | Public chat location. |
slowmode_seconds | integer | null | 30 | Configured slow-mode interval. |
linked_chat_id | integer | null | 123 | Linked discussion or broadcast chat ID. |
linked_monoforum_id | integer | null | 123 | Linked monoforum ID. |
pinned_message_id | integer | null | 123 | Current pinned-message ID. |
default_restrictions | object | null | {"denied":["send_media"]} | Public default denied permissions and expiry. |
available_reactions | object | null | {"mode":"some","items":["👍"]} | Public reaction mode and allowed reaction values. |
chat_bots | array | null | [object Object] | Public bots described by the chat full record. |
sticker_set | object | null | {"short_name":"example"} | Public group sticker-set identity and flags without access hashes. |
processor | string | null | https://apify.com/username/actor_name | Actor attribution URL appended after source fields. |
processed_at | string | null | 2026-08-10T00:00:00+00:00 | UTC time appended last when the row is produced. |
What it costs
| Charged event | Price | When |
|---|---|---|
| Actor Start | $0.01 | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). |
| Result | $0.003 – $0.00225 | Single result in the default dataset. |
Per 1,000 rows, by Apify plan
| Plan | Per row | 1,000 rows | 10,000 rows |
|---|---|---|---|
| Free | $0.003 | $3.01 | $30.01 |
| Bronze | $0.0027 | $2.71 | $27.01 |
| Silver | $0.0024 | $2.41 | $24.01 |
| Gold | $0.00225 | $2.26 | $22.51 |
| Platinum | $0.00225 | $2.26 | $22.51 |
| Diamond | $0.00225 | $2.26 | $22.51 |
Every total includes the $0.01 start fee once. Apify charges that fee per gigabyte of memory, so a 128 MB run pays it a single time.
When not to use it
- Memory is capped at 256 MB, so a very large job should be split into several narrower runs rather than scaled up.
- The dataset carries 41 fields and nothing else; if your analysis needs a field that is not in the table above, no input setting will add it.
- It reads what is public at run time. There is no archive behind it, so a question about last quarter has to be answered from data you already collected.
Closest Actors in the catalog
Same categories, ordered by how many people run them. Compare the field tables before choosing.
| Actor | Brand | Fields | 1k rows (Free) | Users / 30 d |
|---|---|---|---|---|
| Telegram Channel Message | TrueFetch | 55 | $0.36 | 100 |
| Telegram Group Member | TrueFetch | 23 | $0.56 | 21 |
| Reddit Community Profile | TrueFetch | 67 | $50.01 | 16 |
| Reddit User Profile | TrueFetch | 33 | $45.01 | 11 |
| Reddit Usernames Scraper ↗ | TrueFetch | 25 | $7.51 | 1 |
| Reddit Community Post ↗ | TrueFetch | 53 | $5.51 | 1 |
Field guides that use this data
- Reddit Research APIs Compared: Community, Posts, People, or Search — Reddit exposes four distinct research surfaces — community profile, post feeds, people, and keyword search. Which one answers which question, with field counts.
- How to Build a Creator Outreach List from Public Data — A repeatable pipeline for influencer and creator outreach: discovering creators by niche, enriching profiles across YouTube, Instagram, and TikTok, and extracting published business contacts responsibly.
- Instagram and TikTok Trend Research Without Vanity-Metric Traps — A source-aware method for comparing public creator and trend signals across Instagram and TikTok while controlling for time, discovery method, and incomplete metrics.
Prove it on a narrow run
Open the live contract.
Pricing, availability and schema can change between snapshots. The Apify Actor page is the current source of truth.
Catalog snapshot 2026-09-04; Actor contract, pricing and run statistics read 2026-09-04.