Telegram Profile

A powerful Telegram OSINT API that extracts comprehensive profile data from users, bots, groups, and channels, providing complete intelligence gathering and verification capabilities in a unified format.

This Actor streamlines Telegram data collection by extracting detailed information from Telegram entities including personal profiles, community analytics, and verification status. Get complete profile details including contact information, premium status, scam detection, and community insights through a single, efficient API endpoint.

Key Features

• Multi-Entity Support: Simultaneously extract data from users, bots, groups, and channels
• Rich Profile Information: Complete profile details including usernames, phone numbers, bio descriptions, and verification status
• Security Intelligence: Comprehensive scam and fake account detection with verification badges
• Premium Status Detection: Identify Telegram Premium users for high-value prospect targeting
• Community Analytics: Detailed group and channel statistics including member counts, admin information, and activity levels
• Contact Intelligence: Phone call, video call, and voice message availability detection
• Enterprise-Grade Processing: Smart rate limiting and concurrent processing for reliable data extraction
• Privacy-Compliant Extraction: Only extracts publicly available information respecting Telegram privacy settings
• Multiple Output Formats: Export data in JSON, CSV, Excel, or any preferred format

Configuration

Required Parameters

Parameter	Type	Description
telegram_targets	array	List of Telegram usernames, links, or handles to analyze

Telegram Targets Examples:

• Simple usernames: "BotFather", "telegram"
• @Username format: "@premium", "@username"
• t.me Links: "t.me/telegram", "t.me/channel_name"
• Full HTTPS URLs: "https://t.me/binanceexchange", "https://t.me/username"
• Private group invite links: "https://t.me/+InviteCode", "https://t.me/joinchat/..."

Input Requirements:

• Minimum 1 target, maximum 10,000 targets per batch
• All targets must be unique
• Supports users, bots, groups, channels, and supergroups
• Private groups require valid invite links with access permissions

Usage Example

{
  "telegram_targets": [
    "BotFather",
    "@premium",
    "t.me/telegram",
    "https://t.me/binanceexchange"
  ]
}

Data Output

The Actor returns an array of Telegram entity objects with comprehensive information from all supported entity types. Output is available in multiple formats including JSON, CSV, Excel, and more.

Data Fields

Core Entity Information

Field	Type	Description
type	string	Entity type (user, bot, channel, supergroup, group)
id	integer	Telegram unique identifier
username	string	Telegram username without @ symbol
title	string	Group/channel title
first_name	string	User's first name (users/bots only)
last_name	string	User's last name (users/bots only)
phone	string	Phone number if publicly visible (users only)
description	string	Bio description or group/channel about information
lang_code	string	User's language code (users only)

Verification & Security

Field	Type	Description
is_verified	boolean	Whether user/channel has verification
is_premium	boolean	Whether user has Telegram Premium
is_scam	boolean	Whether entity is marked as scam
is_fake	boolean	Whether entity is marked as fake
is_deleted	boolean	Whether user account is deleted
is_support	boolean	Whether user is a support account
is_restricted	boolean	Whether entity is restricted
is_blocked	boolean	Whether user is blocked (users only)

Communication Capabilities

Field	Type	Description
phone_calls	boolean	Whether phone calls are available
video_calls	boolean	Whether video calls are available
voice_messages	boolean	Whether voice messages can be sent
premium_contact	boolean	Whether contacting user requires premium
can_pin	boolean	Whether you can pin messages with user
private_calls	boolean	Whether phone calls setting is private
private_reads	boolean	Whether read dates setting is private

Activity & Status

Field	Type	Description
last_seen	string	Last seen status or timestamp
common_chats_count	integer	Number of common chats shared with user
profile_photo	boolean	Whether entity has a profile photo
has_scheduled	boolean	Whether there are scheduled messages
can_manage_emoji	boolean	Whether user can manage emoji status

Group/Channel Specific

Field	Type	Description
created_date	string	ISO timestamp when group/channel was created
member_count	integer	Total number of participants/members
online_count	integer	Current number of online members
admins_count	integer	Total number of administrators
banned_count	integer	Total number of banned members
view_members	boolean	Whether members list is viewable
view_stats	boolean	Whether statistics are viewable
linked_chat_id	integer	ID of linked discussion group or channel
join_to_send	boolean	Whether joining is required to send messages
join_request	boolean	Whether join request is required
is_forum	boolean	Whether the group/channel is a forum
no_forwards	boolean	Whether forwarding is restricted
has_location	boolean	Whether group/channel has geographic location
gigagroup	boolean	Whether channel is a gigagroup
slowmode	boolean	Whether slowmode is enabled
call_active	boolean	Whether a voice/video call is currently active
location	object	Geographic location information if available

Processing Metadata

Field	Type	Description
status	string	Processing status (success, failed)
source_url	string	Original Telegram URL that was processed
processor	string	URL of the processor/scraper used
processed_at	string	Timestamp when entity was processed

Example Output

{
  "status": "success",
  "source_url": "https://t.me/premium",
  "processor": "telegram-profile-processor",
  "processed_at": "2024-01-15 10:30:00",
  "type": "user",
  "id": 777000,
  "username": "premium",
  "title": null,
  "first_name": "Telegram",
  "last_name": "Premium",
  "phone": null,
  "description": "Telegram Premium provides exclusive features and enhanced functionality",
  "lang_code": "en",
  "is_verified": true,
  "is_premium": true,
  "is_scam": false,
  "is_fake": false,
  "is_deleted": false,
  "is_support": true,
  "is_restricted": false,
  "is_blocked": false,
  "phone_calls": false,
  "video_calls": false,
  "voice_messages": true,
  "premium_contact": false,
  "can_pin": false,
  "private_calls": false,
  "private_reads": false,
  "last_seen": "online",
  "common_chats_count": 0,
  "profile_photo": true,
  "has_scheduled": false,
  "can_manage_emoji": false,
  "created_date": null,
  "member_count": null,
  "online_count": null,
  "admins_count": null,
  "banned_count": null,
  "view_members": null,
  "view_stats": null,
  "linked_chat_id": null,
  "join_to_send": null,
  "join_request": null,
  "is_forum": null,
  "no_forwards": null,
  "has_location": null,
  "gigagroup": null,
  "slowmode": null,
  "call_active": null,
  "location": null
}

Supported Platforms

• Telegram: Complete support for all entity types including users, bots, groups, channels, and supergroups
• Public Entities: Full access to publicly available information without authentication
• Private Groups: Access available when valid invite links are provided and permissions allow

Supported Entity Types

This Actor supports data extraction from the following Telegram entity types:

Users & Bots: Personal profiles, bot accounts, premium status detection, contact capabilities, verification status, activity patterns, and communication preferences

Groups: Community groups, supergroups, megagroups, member analytics, admin information, group settings, and participation statistics

Channels: Broadcast channels, discussion channels, subscriber counts, verification status, content settings, and linked group information

Forums: Forum-style groups with topic organization, moderation settings, and specialized community features