Telegram Private Group Scraper - Extract Member Profiles from Private Telegram Groups

Extract member profiles from any private Telegram group you belong to—usernames, names, phone numbers, and real-time activity signals. Deep Search mode scans the entire message history to surface hidden members that standard tools cannot reach. Built for community intelligence, Web3 growth campaigns, and lead generation from closed Telegram communities.

---

Why Choose This Telegram Group Member Scraper

The Only Tool That Reaches Private Group Members Others Can't

🔒 Private Group Access — Not Just Public Channels Most Telegram scrapers only work with public channels. This actor works with private groups and supergroups that your account has already joined—the communities that hold your most valuable, curated audience. If you're a member, you can extract it.

🔍 Deep Search for Hidden & Historical Members The standard member list only shows what Telegram surfaces by default. Deep Search scans the group's entire message history to identify members who are hidden from the member list or who sent messages before leaving—contacts that no other tool can find.

📱 Phone Numbers When Visible Extracts phone numbers for members whose Telegram privacy settings permit it. Most common in smaller, close-knit groups where mutual contacts exist between the scraping account and other members.

🔐 Two Secure Login Modes — No Stored Passwords

• QR Code (first run): scan with your Telegram mobile app in seconds, no password entered anywhere
• Session String (repeat runs): paste the saved session to resume without re-scanning

🧩 Built-In Deduplication Across All Search Passes The actor runs multiple search strategies in a single run. Every result is deduplicated by user ID—each member appears in the output exactly once regardless of how many times they were encountered.

📊 17 Data Fields Per Member Profile Full profile intelligence: identity, activity signals, verification status, scam/fake flags, language code, premium status, and contact restrictions—all in one structured record.

---

Quick Start Guide

How to Scrape Telegram Group Members in 3 Steps

Step 1: Log In to Your Telegram Account

First run — QR Code login: Leave the Session field empty and click Start. A QR code will appear in the run log within seconds. Open Telegram mobile → Settings → Devices → Link Desktop Device → scan the code. After login succeeds, the session string is printed in the log and automatically sent to your Telegram Saved Messages. Copy it for all future runs.

Repeat runs — Session login: Paste the saved session string into the Session field. The actor connects instantly without any QR scan.

Step 2: Configure Your Target Group and Options

Enter a substring of the group title, @username, or numeric ID in Group Match. The actor scans all your joined groups and picks the first match. Enable Deep Search if you need hidden members or historical participants.

Step 3: Download Your Member Data

Results appear in the Apify Dataset automatically. Export as JSON or CSV, or pull data via REST API into your existing workflow.

---

Input Parameters

Required Configuration Fields

Parameter	Type	Description	Example
group_match	string	Substring to match target group title, @username, or numeric ID. Case-insensitive. First match wins.	"binance", "crypto_vip", "1234567890"
deep_search	boolean	Enable to also extract hidden members and historical members found in message history	false, true
max_results	integer	Maximum number of member profiles to extract (minimum: 100)	100, 1000, 10000

Optional Configuration Fields

Parameter	Type	Description
session	string	Saved session string from a previous login. Leave empty on first run to trigger QR login.
password	string	Telegram Two-Factor Authentication (2FA) password, if enabled. Leave empty if not used.

Group Match Tips

The group_match field performs a case-insensitive substring search across all your joined groups:

• By title: "binance" matches "Binance Official Community" or "Binance VIP Group"
• By @username: "alpha_vip" matches @Alpha_VIP_Group
• By numeric ID: "-1001234567890" for exact targeting when multiple groups share similar names

Important: Only groups you are already a member of can be scraped. Channels (broadcast only) are not supported—only groups and supergroups.

Deep Search Mode

Mode	What It Finds	When to Use
Off (default)	Visible member list only	Fast extraction, active community members
On	Visible members + hidden members discovered in message history	Maximum coverage, including lurkers and past members

Note: Deep Search scans the group's entire message history. Runtime scales with message volume and group age. Disabled for free Apify accounts.

Example Input Configuration

{
  "session": "your_session_string_here",
  "password": "",
  "group_match": "binance",
  "deep_search": false,
  "max_results": 1000
}

---

Output Data Schema

Complete Member Profile Data Structure

Each extracted member profile contains up to 17 fields organized into four categories:

Identity Fields

Field	Type	Description
user_id	integer	Telegram unique user identifier
first_name	string	User's first name
last_name	string	User's last name
usernames	array	All @handles associated with the account, deduplicated
phone_number	string	Phone number if visible to the scraping account
entity_type	string	"user" or "bot"
lang_code	string	Account language code (e.g. "en", "ru", "zh")

Activity & Status Fields

Field	Type	Description
last_seen	string	"online", ISO 8601 timestamp (last offline time), "recently", "last_week", "last_month", or "unknown"
is_premium	boolean	Whether the user has Telegram Premium
is_verified	boolean	Whether the account is officially verified by Telegram
stories_hidden	boolean	Whether the user's stories are hidden from others
premium_contact	boolean	Whether messaging this user requires Telegram Premium

Safety & Restriction Fields

Field	Type	Description
is_deleted	boolean	Whether the account has been deleted
is_scam	boolean	Whether the account is flagged as scam by Telegram
is_fake	boolean	Whether the account is flagged as fake by Telegram
is_restricted	boolean	Whether the account is under platform restrictions

Metadata Fields

Field	Type	Description
processed_at	string	ISO 8601 UTC timestamp of when the record was extracted
processor	string	Apify actor URL that processed this record

Example JSON Output

{
  "processor": "https://apify.com/agentx/telegram-private-group-scraper",
  "processed_at": "2026-03-15T10:23:45.123Z",
  "user_id": 987654321,
  "first_name": "Alex",
  "last_name": "Chen",
  "usernames": ["alex_crypto"],
  "phone_number": "+1234567890",
  "entity_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": "2026-03-15T08:00:00",
  "stories_hidden": false,
  "premium_contact": false
}

Export Formats

• JSON - Full structured data with all 17 fields per member
• CSV - Spreadsheet-compatible format for direct import
• API Access - Programmatic access via Apify Client SDK
• Cloud Storage - Automatic upload to Apify Dataset

---

Integration Examples

Actor ID for Platform Integration

agentx/telegram-private-group-scraper

Make.com Integration (No-Code Automation)

1. Login to Make.com (Get 1000 Free Credits)
2. Add Module: "Run an Actor"
3. Enable Map: Turn on 'Map' (right side of 'Actor*')
4. Paste Actor ID: agentx/telegram-private-group-scraper
5. Refresh: Click '⟳ Refresh' (left side of Map)
6. Configure Input: Set group_match, deep_search, max_results, and session
7. Set Synchronous: "Run synchronously" = YES
8. Add Output Module: "Get Dataset Items"
9. Select Dataset: Choose defaultDatasetId

n8n.io Integration (Workflow Automation)

1. Add Node: 'Run an Actor and get dataset' from Apify node
2. Select By ID: Actor → By ID
3. Paste Actor ID: agentx/telegram-private-group-scraper
4. Configure Input: Set parameters as needed

Python Integration Example

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run_input = {
    "session": "your_session_string_here",
    "password": "",
    "group_match": "binance",
    "deep_search": False,
    "max_results": 1000
}

run = client.actor("agentx/telegram-private-group-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript/Node.js Integration

import { ApifyClient } from "apify-client";

const client = new ApifyClient({
  token: "YOUR_API_TOKEN",
});

const input = {
  session: "your_session_string_here",
  password: "",
  group_match: "binance",
  deep_search: false,
  max_results: 1000,
};

const run = await client.actor("agentx/telegram-private-group-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

items.forEach((item) => {
  console.log(item);
});

---

Pricing & Cost Calculator

Transparent Pay-Per-Use Model

Event Type	Price	Description
Actor Usage	$0.00001	Charged for Actor runtime. Cost depends on resource consumption during execution.
Member Profile	$0.0005	Charged per extracted member profile. Includes all 17 data fields.

Cost Examples

Small Scale (100 members):

• Profile Data: 100 × $0.0005 = $0.05
• Actor Usage: ~$0.01
• Total: ~$0.06

Medium Scale (1,000 members):

• Profile Data: 1,000 × $0.0005 = $0.50
• Actor Usage: ~$0.02
• Total: ~$0.52

Large Scale (10,000 members):

• Profile Data: 10,000 × $0.0005 = $5.00
• Actor Usage: ~$0.05
• Total: ~$5.05

Competitive Pricing Comparison

Feature	Telegram Private Group Scraper	Manual Telegram Export	Generic Scrapers	Data Brokers
Cost per 1K Members	$0.50 ⭐	Free but hours of manual work	$3–15	$50–200+
Private Group Support	Yes ⭐	Only own group, CSV only	Rarely	No
Deep Search (Hidden Members)	Yes ⭐	No	No	No
Phone Numbers	Yes (when visible) ⭐	No	No	Limited
Data Fields Per Member	17 ⭐	3–4	5–8	5–10
API / Automation	Full API ⭐	None	Partial	Batch only

---

Use Cases & Applications

Community Intelligence & Web3 Growth

Crypto & DeFi Community Analysis Map the exact membership of private alpha groups, token holder communities, and DeFi project channels. Identify verified accounts, premium users, and multi-language segments before a token launch or airdrop. Cross-reference usernames with on-chain wallets to build targeted outreach.

Competitor Community Monitoring Join competitor Telegram groups and extract their member list. Identify power users and high-engagement members using last_seen data. Build outreach lists of warm contacts who are already interested in your market.

Airdrop & Whitelist Campaign Targeting Build precise targeting lists from private alpha groups. Filter by is_premium, lang_code, and premium_contact to reach the highest-value audience and reduce wasted outreach on bot accounts.

Lead Generation & Direct Outreach

B2B Lead Generation from Industry Groups Private Telegram groups for fintech, SaaS, real estate, and professional niches contain decision-makers who are otherwise difficult to reach through cold email or LinkedIn. Extract their usernames and initiate direct contact on Telegram.

DM Campaign List Building Build targeted DM lists from closed communities. Use last_seen to prioritize recently active members and premium_contact to identify accounts that require Telegram Premium to message—focus budget where it will land.

Influencer & KOL Discovery Find verified accounts and premium subscribers within niche communities before they gain mainstream visibility. Use activity signals and language codes to identify regional micro-influencers.

Research & Community Management

Community Health & Engagement Analysis Measure real engagement vs. inflated numbers. Use last_seen distribution to determine the ratio of active vs. ghost members. Compare member counts across time periods to detect organic growth or bot inflation.

Multi-Language Community Segmentation Use lang_code to segment members by language for localized campaigns—critical for global projects running region-specific announcements or support.

Bot & Fraud Detection Filter output by entity_type, is_scam, is_fake, and is_deleted to clean your outreach lists. Identify compromised or fake accounts that inflate your own community's reported size.

Historical Member Recovery Use Deep Search to find members who left the group but previously sent messages—a list of past community members for targeted re-engagement campaigns outside of Telegram.

---

FAQ - Frequently Asked Questions

General Questions

What type of groups does this scraper support?

This actor works with private groups and supergroups that your Telegram account is already a member of. It does not support public broadcast channels (channels where only admins post). The target must be a group where members can send messages.

Do I need a special Telegram account?

A regular Telegram user account is sufficient—no bot token, no API credentials to set up. The account must already be a member of the target group before running the actor.

What is the Group Match field?

It is a case-insensitive substring search across all your joined groups. Enter any part of the group title, @username, or the group's numeric ID. The first matching group is used. Use a unique enough substring if you belong to multiple groups with similar names.

What is Deep Search and how is it different?

Standard extraction retrieves the visible member list using multiple search passes. Deep Search additionally scans the full message history of the group to find members who are hidden from the member list or who sent messages before leaving. It finds more members but takes longer, depending on how many messages the group has.

Technical Questions

How does login work?

First run (QR Code): Leave the Session field empty and click Start. A QR code appears in the run log. Open Telegram mobile → Settings → Devices → Link Desktop Device → scan the code. After successful login, the session string is printed in the log and sent to your Telegram Saved Messages.

Subsequent runs (Session String): Paste the saved session string into the Session field. The actor authenticates instantly without any QR scan.

Is my Telegram account safe?

The Session field is marked as a secret—it is stored encrypted by Apify and never exposed in logs after login. For scraping operations, it is best practice to use a secondary or dedicated Telegram account rather than your primary personal account.

What data format does the scraper output?

Structured JSON with up to 17 fields per member. Also available as CSV and via the Apify REST API.

Can I integrate this with my existing tools?

Yes. Integration options include:

• Make.com (no-code automation)
• n8n.io (workflow automation)
• Python / JavaScript (Apify Client SDK)
• REST API (direct HTTP requests)
• Zapier (via webhooks)

Data Quality Questions

Why are phone numbers missing for most members?

Telegram only shares phone numbers between accounts that have mutual contacts or when the user's privacy settings explicitly allow it. In large private groups, phone number visibility is uncommon. In smaller, tighter-knit groups with mutual contacts, it appears more frequently.

Why is last_seen showing "unknown" or "last_month"?

Telegram's privacy settings allow users to restrict who can see their last active time. "unknown" means the user has hidden their status from everyone. "last_month" means the user was seen within the past month but the exact time is hidden by their privacy settings.

What if my group isn't found?

Common solutions:

• Confirm your account is a member of the target group before running
• Use a more unique substring from the group title
• Try the group's numeric ID instead of the title
• Verify the target is a group—channels are not supported
• Check that the group is not a channel with "supergroup" appearance

How does deduplication work?

Every member found—whether through standard search passes or Deep Search message history—is tracked by user_id. If the same member is encountered multiple times across different search strategies, only one record is pushed to the dataset.

What are the free plan limitations?

Free Apify accounts are limited to 100 member profiles per run and Deep Search is disabled. Upgrading to a paid Apify plan removes both limits.

Troubleshooting

QR code expired before I could scan it

The actor automatically refreshes the QR code up to 3 times (30 seconds each). Have your Telegram mobile app open with the camera ready before clicking Start. If all attempts expire, restart the run.

Login fails with "Password required"

Your Telegram account has Two-Factor Authentication (2FA) enabled. Enter your 2FA password in the Password field and run again.

Run completes but fewer members than expected

• Enable Deep Search to find hidden and historical members
• Telegram's displayed member count may include deleted accounts that are excluded from the output
• Some members have privacy settings that prevent their profiles from appearing in any member search
• Very large groups (100k+) may have Telegram-side restrictions on member list access

---

Related Telegram & Social Intelligence Tools

Telegram Intelligence Suite

• Telegram Private Group Scraper - Extract Members from Private Groups (This Tool)
• Telegram Chat Scraper - Extract Messages & Media from Public Channels & Groups
• Telegram Member Scraper - Public Group & Channel Member Extraction
• Telegram Info Scraper - Telegram Profile Intelligence & Contact Discovery

Community Intelligence Tools

• SubReddit Post Scraper - Targeted Subreddit Post Extraction & Community Analysis
• Subreddit Member Scraper - Reddit Community Member Intelligence
• X Info Scraper - X/Twitter Profile Intelligence & User Analytics

Content Intelligence Tools

• All Video Scraper - Multi-Platform Video Download (1000+ Platforms)
• Video Transcript - Universal Video Transcription & AI Training Data
• YouTube Transcript - YouTube Speech Transcription & Content Analysis

---

Trust & Certifications

• ✅ Session Security - Session strings stored as encrypted secrets, never exposed in logs
• ✅ Deduplication Built-In - Zero duplicate records across all search passes
• ✅ Rate Limit Compliance - Automatic request pacing to protect the scraping account
• ✅ Regular Updates - Continuous maintenance for Telegram platform changes

---

SEO Keywords & Search Terms

Primary Keywords

telegram private group scraper, telegram group member extractor, extract telegram group members, telegram member list export, private telegram group scraper API, telegram community scraper, telegram user data extractor, telegram group scraping tool

Long-Tail Keywords

how to scrape members from private telegram group, extract hidden telegram group members, telegram private group member list export, get all members from telegram group, telegram community intelligence tool, scrape telegram supergroup members, telegram group deep search members, export telegram group contacts

Industry Terms

telegram community intelligence, web3 community analysis, crypto group member scraper, telegram outreach automation, telegram DM campaign list, telegram lead generation, community growth hacking, NFT community member extraction, telegram member database, airdrop target list telegram

Use Case Keywords

telegram member export API, telegram group CRM integration, community health analysis telegram, telegram bot detection, hidden member discovery telegram, telegram account intelligence, telegram 2FA login scraper, telegram group analytics, web3 community mapping

---

Support & Community

• 👥 Community: @Apify_Actor
• 👤 Contact Team: @AiAgentApi

---

Last Updated: March 29, 2026 | Version: 0.1 | Actor ID: agentx/telegram-private-group-scraper