Telegram Username Checker

Verify Telegram usernames in bulk. Extract channel/user/bot type, subscriber & member count, title, bio, verification status, and profile photo URL.

Features

• Bulk Username Verification: Validate hundreds or thousands of Telegram usernames in seconds.
• Flexible Input Formats: Accepts raw usernames (durov), @handles (@telegram), full URLs (https://t.me/durov), channel previews (https://t.me/s/techcrunch), or deep links (tg://resolve?domain=botfather).
• Entity Classification: Automatically detects if a username belongs to a Channel, Group, User Profile, Bot, or Non-existent / Available handle.
• Metrics Extraction: Extracts live subscriber counts for channels, member and online counts for groups.
• Rich Profile Metadata: Scrapes title, bio/description, verified badge status, and high-resolution profile photo URLs.
• Fast & Light: Uses fast HTML parsing with built-in retry mechanisms and proxy support.

---

Input Parameters

The Actor accepts input via JSON array or multiline text block:

Parameter	Type	Default	Description
usernames	Array	[]	Array of Telegram usernames or URLs to verify.
usernameList	String	""	Multiline string with one username or URL per line.
proxyConfiguration	Object	null	Apify Proxy settings for rate-limiting protection.
maxConcurrency	Integer	10	Maximum parallel requests allowed.
debugLog	Boolean	false	Enable detailed debug logging.

Example Input (JSON)

{
  "usernames": [
    "durov",
    "@telegram",
    "https://t.me/techcrunch",
    "botfather",
    "non_existent_username_12345"
  ],
  "maxConcurrency": 10
}

---

Output Dataset

The Actor produces a dynamic JSON dataset where each item represents a verified username.

Output Fields

• username (String): Cleaned Telegram username handle.
• inputUsername (String): Raw input provided by the user.
• exists (Boolean): true if the Telegram account/channel exists, false otherwise.
• type (String): Account classification: "channel", "group", "user", "bot", or "not_found".
• title (String): Display name or channel title.
• bio (String): Bio or channel description.
• subscriberCount (Integer): Number of channel subscribers (numeric).
• subscriberCountText (Integer/String): Human-readable subscriber count (e.g., "11 340 520 subscribers").
• memberCount (Integer): Number of group members.
• memberCountText (String): Human-readable member count.
• onlineCount (Integer): Number of online group members (if available).
• isVerified (Boolean): true if the channel/account carries an official Telegram verified badge.
• photoUrl (String): Profile avatar URL.
• telegramUrl (String): Web link (https://t.me/username).
• deepLink (String): Telegram app deep link (tg://resolve?domain=username).
• status (String): "active" or "not_found".
• checkedAt (String): ISO 8601 UTC timestamp of verification.

Example Output Item (Channel)

{
  "username": "durov",
  "inputUsername": "durov",
  "exists": true,
  "type": "channel",
  "title": "Pavel Durov",
  "bio": "Founder of Telegram.",
  "subscriberCount": 11340520,
  "subscriberCountText": "11 340 520 subscribers",
  "memberCount": null,
  "memberCountText": null,
  "onlineCount": null,
  "isVerified": true,
  "photoUrl": "https://cdn4.telesco.pe/file/g9tVQp_Zfeo1jILoQ2WGgojZWP65TGhGwD...",
  "telegramUrl": "https://t.me/durov",
  "deepLink": "tg://resolve?domain=durov",
  "status": "active",
  "checkedAt": "2026-08-06T09:10:00.000Z"
}

Example Output Item (Non-Existent Username)

{
  "username": "non_existent_username_12345",
  "inputUsername": "non_existent_username_12345",
  "exists": false,
  "type": "not_found",
  "title": null,
  "bio": null,
  "subscriberCount": null,
  "subscriberCountText": null,
  "memberCount": null,
  "memberCountText": null,
  "onlineCount": null,
  "isVerified": false,
  "photoUrl": null,
  "telegramUrl": "https://t.me/non_existent_username_12345",
  "deepLink": "tg://resolve?domain=non_existent_username_12345",
  "status": "not_found",
  "checkedAt": "2026-08-06T09:10:00.000Z"
}

---

Use Cases

• Username Availability & Claiming: Check if desirable Telegram handles are taken or available.
• Influencer & Channel Verification: Audit subscriber counts and verified status for marketing campaigns.
• Lead Generation & Enrichment: Validate Telegram contacts in sales outreach lists.
• Brand Protection & OSINT: Track impersonation attempts or official brand channels.

---

License

Apache-2.0