Telegram Username Info Actor

💬 Questions, bulk pricing, or a custom solution? Talk to us on Telegram — @KoteamSupport.

✅ Check Telegram usernames and retrieve associated user or group/channel information. This Apify Actor processes a list of usernames and returns detailed data, including username, existence, user status, title, description, photo URL, and participant count (for groups/channels).

📥 Input

The Actor accepts:

• usernames: A list of Telegram usernames (e.g., ["CryptoRankNews", "t.me/CryptoRankNews"]).
• loadAdditionalData (optional, default false): When enabled, loads more profile fields (takes longer). Can also return a phone number when it is publicly available.

📋 Input Schema

{
  "title": "Username Info Actor",
  "description": "Fetches user information for usernames.",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "usernames": {
      "title": "Usernames",
      "type": "array",
      "description": "List of usernames to fetch information for",
      "editor": "stringList",
      "placeholderValue": "CryptoRankNews",
      "prefill": ["CryptoRankNews", "t.me/CryptoRankNews"]
    },
    "loadAdditionalData": {
      "title": "Load additional data",
      "type": "boolean",
      "description": "Load more profile fields (takes longer). Can also return a phone number when it is publicly available.",
      "editor": "checkbox",
      "default": false
    }
  },
  "required": ["usernames"]
}

Example:

{
    "usernames": ["CryptoRankNews", "t.me/CryptoRankNews"],
    "loadAdditionalData": true
}

Output

Each username produces one dataset item.

Without loadAdditionalData (default)

User

{
  "username": "jane_doe",
  "exists": true,
  "isUser": true,
  "title": "Jane Doe",
  "description": "Product designer",
  "photoUrl": "https://cdn.example/photo.jpg",
  "error": null
}

Channel

{
  "username": "example_news",
  "exists": true,
  "isUser": false,
  "title": "Example News",
  "description": "Daily updates",
  "photoUrl": "https://cdn.example/channel.jpg",
  "participants_count": 125000,
  "error": null
}

With loadAdditionalData: true

User

{
  "username": "jane_doe",
  "exists": true,
  "isUser": true,
  "title": "Jane Doe",
  "description": "Product designer",
  "photoUrl": "https://cdn.example/photo.jpg",
  "participants_count": -1,
  "telegramId": 123456789,
  "firstName": "Jane",
  "lastName": "Doe",
  "phone": "",
  "about": "Product designer",
  "status": "UserStatusRecently",
  "langCode": "en",
  "premium": false,
  "blocked": false,
  "bot": false,
  "hasPhoto": true,
  "gender": null,
  "deleted": false,
  "fake": false,
  "scam": false,
  "contactRequirePremium": false,
  "dcId": "EU",
  "photoDcId": 2,
  "storiesUnavailable": true,
  "storiesMaxId": 123,
  "error": null
}

Channel

{
  "username": "example_news",
  "exists": true,
  "isUser": false,
  "title": "Example News",
  "description": "Daily updates",
  "photoUrl": "https://cdn.example/channel.jpg",
  "participants_count": 125000,
  "telegramId": 987654321,
  "storiesUnavailable": true,
  "storiesMaxId": null,
  "hasChatLink": false,
  "megagroup": false,
  "gigagroup": false,
  "verified": false,
  "restricted": false,
  "forum": false,
  "noforwards": false,
  "joinRequest": false,
  "joinToSend": false,
  "slowmodeEnabled": false,
  "hasGeo": false,
  "signatures": false,
  "creationDate": 1609459200,
  "photoId": "1234567890123456789",
  "error": null
}

Usage

Set up your Apify account: Sign up at Apify and create a new Actor.

Provide input: Input a list of Telegram usernames in the JSON input field.

Run the Actor: Execute the Actor to fetch details for each username.

Retrieve results: Access the dataset to view results in a table format.

Published examples

Ready-to-run tasks with pre-filled inputs:

• Verify if a Telegram username exists
• Get Telegram channel subscriber count by username
• Check if Telegram username is a user or channel
• Telegram username lookup API — bulk check handles
• Scrape Telegram channel title, description, and photo

All username examples · Need full export? akula.marketing

🔌 Automate with Zapier & Make

No code needed — trigger this Actor from your existing tools.

• Zapier: search for the "Apify" app → action Run Actor → select akula.marketing/telegram-get-username-info → map a trigger field (e.g. a new row in Google Sheets or a new lead in your CRM) to usernames → send the output to Sheets, your CRM, or Slack. Docs
• Make: add the Apify → Run an Actor module, select this Actor, set "Run synchronously" to Yes, then chain a Get Dataset Items module to pull results into your scenario. Docs

Example: new row added to a Google Sheet of handles → Zap runs this Actor → verified username, subscriber count, and photo get written back to the same row.

Support

Support 24/7 - @KoteamSupport. We also offer specialized solutions for Telegram-related tasks — contact us to learn more

⭐ Found this useful? Leave a review — it helps others find this Actor and tells us what to build next.

🏷️ Find This Tool When You Search For "verify if a Telegram username exists" - Existence check before outreach or CRM import "get Telegram channel subscriber count" - Public channel member counts without admin access "check if Telegram username is a user or channel" - User vs channel type detection "Telegram username lookup API" - Bulk validation for lead lists and pipelines "scrape Telegram channel title description and photo" - Public channel metadata export "telegram group analytics" - Get real member counts and community data "telegram user verification" - Verify identities and credentials "telegram profile lookup" - Find complete user profiles and contact info "telegram community research" - Analyze groups for market intelligence "telegram osint" - Open source intelligence from Telegram data 🎯 Turn Telegram into your secret weapon for finding opportunities and avoiding threats 🛡️ Protect yourself and your business with professional-grade intelligence 💰 Discover high-value prospects and opportunities others miss