Telegram Scraper

A powerful Telegram member extraction API that aggregates user data from Telegram groups, providing comprehensive contact information and member intelligence in a unified format.

This Actor streamlines member data collection by extracting information from Telegram groups efficiently. Get complete member details including contact information, account status, verification levels, and engagement metrics through a single, reliable API endpoint.

Key Features

• Comprehensive Member Extraction: Extract complete member lists from Telegram groups
• Rich Contact Information: Access to usernames, phone numbers, names, and profile data when available
• Account Quality Assessment: Detailed verification status, premium indicators, and authenticity checks
• Advanced Security Filtering: Built-in detection for bots, fake accounts, scam profiles, and restricted users
• Historical Data Discovery: Deep search capabilities for finding additional members and historical activity
• Multiple Source Support: Extract from public groups with username-based access
• Real-time Processing: Live data extraction with timestamp tracking for freshness validation
• Multiple Output Formats: Export data in JSON, CSV, Excel, or any preferred format

Configuration

Required Parameters

Parameter	Type	Description
deep_search	boolean	Enable deep search for hidden groups and historical data
telegram_targets	array	List of Telegram groups to extract from

Deep Search Options:

• true - Essential for hidden member groups, discovers additional historical members who were previously active
• false - Standard extraction for public groups with visible member lists
• Tip: Enable for maximum member discovery and complete audience analysis

Telegram Targets Examples:

• Group usernames: @cryptotrading, @marketingpros
• Direct links: t.me/groupname
• Full URLs: https://t.me/binanceexchange

Supported Target Formats:

• Use exact group identifiers or full URLs
• Support for up to 10 groups per extraction
• Compatible with both public and private communities

Usage Example

{
  "deep_search": true,
  "telegram_targets": [
    "https://t.me/binanceexchange",
    "@cryptotrading",
    "t.me/premium_group"
  ]
}

Data Output

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

Data Fields

Basic Information

Field	Type	Description
id	string	Telegram user unique identifier
first_name	string	User's first name
last_name	string	User's last name
usernames	array	List of user's usernames
phone	string	User's phone number if publicly visible
type	string	Entity type (User/Bot)
lang_code	string	User's language code

Account Status

Field	Type	Description
is_deleted	boolean	Whether user account is deleted
is_verified	boolean	Whether user is verified
is_premium	boolean	Whether user has Telegram Premium
is_scam	boolean	Whether user is marked as scam
is_fake	boolean	Whether user is marked as fake
is_restricted	boolean	Whether user account is restricted

Activity Information

Field	Type	Description
last_seen	string	User's last seen status
stories_hidden	boolean	Whether user's stories are hidden
premium_contact	boolean	Whether contacting user requires premium

Extraction Metadata

Field	Type	Description
source_url	string	Telegram group URL where user was found
processor	string	Apify actor URL that processed this data
processed_at	string	Timestamp when the user was processed

Example Output

{
  "id": "1234567890",
  "first_name": "Alex",
  "last_name": "Johnson",
  "usernames": ["crypto_trader_pro"],
  "phone": "+1234567890",
  "type": "User",
  "is_deleted": false,
  "is_verified": false,
  "is_premium": true,
  "is_scam": false,
  "is_fake": false,
  "is_restricted": false,
  "lang_code": "en",
  "last_seen": "2024-01-15T10:30:00.000Z",
  "stories_hidden": false,
  "premium_contact": false,
  "source_url": "https://t.me/cryptotrading",
  "processor": "https://apify.com/actor/telegram-scraper",
  "processed_at": "2024-01-15T10:30:00.000Z"
}

Supported Platforms

• Telegram Groups: Public groups with member extraction capabilities
• Username-based: Direct access through group usernames and handles

Supported Group Types

This Actor supports member extraction from various Telegram community types:

Public Groups: Open communities with visible member lists and unrestricted access for data extraction

Business Communities: Professional groups focused on industries like cryptocurrency, marketing, technology, and e-commerce

Geographic Communities: Region-specific groups supporting international market research and localization strategies

Special Access Groups: Premium or exclusive communities requiring specific membership criteria or verification