Telegram Private Group Scraper - Private Telegram Member Extraction & Compliance API

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 compliance audits, private-community intelligence, and authorized member enrichment 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 Extract member data from private Telegram groups and supergroups your account has joined — the curated, high-value communities inaccessible to public-channel-only scrapers. If your account is 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 (repeat runs): paste the saved Session value 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.

---

Why Choose This API

This actor is designed for structured output, repeatable automation, and downstream integration in monitoring, enrichment, or ingestion pipelines.

Quick Start Guide

How to Scrape Telegram Group Members in 3 Steps

Step 1: Log In to Your Telegram Account

Open Actor Input

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 value 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 value 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 value 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:

Open Actor Input

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?fpr=aiagentapi",
  "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

L4SPW5ECJb9gP5aDT

Ⓜ️ Make.com Setup:

1. Login to Make.com (Get 1000 Free Credits)
2. Add module "Run an Actor"
3. Turn 'Map' on - right side of the 'Actor*'
4. Paste Actor ID - from above
5. Click the '⟳ Refresh' - left side of Map
6. Input JSON* - Modify the parameters as needed
7. Set "Run synchronously" to YES
8. Add module "Get Dataset Items" - receive the result
9. In Dataset ID* select defaultDatasetId

🎱 N8N.io Setup:

1. Add 'Run an Actor and get dataset' - from the apify node
2. Actor → By ID → Paste Actor ID - from above
3. Input JSON - Modify the 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("L4SPW5ECJb9gP5aDT").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("L4SPW5ECJb9gP5aDT").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

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

JSON-LD Metadata

{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Telegram Private Group Scraper",
  "description": "Telegram private group member extraction API with Deep Search for hidden members, phone number discovery, and 17 profile fields per member",
  "applicationCategory": "Developer Tools",
  "operatingSystem": "Cloud",
  "url": "https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi",
  "dateModified": "2026-04-21",
  "offers": {
    "@type": "Offer",
    "price": "0.01",
    "priceCurrency": "USD"
  }
}

---

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

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.

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 value is printed in the log and sent to your Telegram Saved Messages.

Subsequent runs (Session): Paste the saved Session value 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)

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.

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

---

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, telegram private group lead generation API, authorized telegram member extraction pipeline

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

---

Trust & Certifications

• ✅ Session Security - Session values are stored securely and 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

---

Legal & Compliance

Data Rights & Usage

All data is extracted from Telegram groups that the authenticated account is a member of. Users are responsible for ensuring their use of extracted data complies with applicable laws and Telegram's Terms of Service.

Privacy Compliance

• GDPR: Compliant with EU General Data Protection Regulation. No personal data is stored beyond the extraction session. Session values are stored securely.
• CCPA: Compliant with California Consumer Privacy Act requirements.

Platform Terms of Service

Users must review and comply with Telegram's Terms of Service regarding data extraction and usage. Only groups the account is already a member of can be scraped.

Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries:

• Telegram: @AiAgentApi

---

Related Tools

Jobs & Hiring

• All Job Scraper - Multi-Platform Job Data Extraction API
• Indeed Hiring Scraper - Indeed Job Extraction & Market Intelligence
• LinkedIn Hiring Scraper - LinkedIn Job Data Extraction & Talent Intelligence
• Glassdoor Hiring Scraper - Glassdoor Salary Intelligence & Company Reviews

LinkedIn

• LinkedIn Company Scraper - LinkedIn Company Data Extraction & Firmographic Intelligence
• LinkedIn Profile Scraper - LinkedIn Profile Data Extraction & Professional Intelligence

Reddit

• Reddit Author Scraper - Reddit Author Profile Extraction & Activity Analysis
• Reddit Viral Scraper - Reddit Viral Content Extraction & Trend Intelligence
• SubReddit Info Scraper - Subreddit Metadata Extraction & Community Intelligence
• SubReddit Post Scraper - Subreddit Post Extraction & Content Analysis
• Subreddit Member Scraper - Subreddit Member Extraction & Audience Analysis

Telegram

• Telegram Chat Scraper - Telegram Chat Message Extraction & Content Analysis
• Telegram Group Inviter - Telegram Group Member Invitation & Management
• Telegram Info Scraper - Telegram Entity Metadata Extraction & Intelligence
• Telegram Member Scraper - Telegram Group Member Extraction & Audience Data
• Telegram Private Group Scraper - Telegram Private Group Data Extraction & Analysis (This Tool)

Instagram

• Instagram Creator Scraper - Instagram Profile Data Extraction & Creator Intelligence
• Instagram Post Reel Scraper - Instagram Feed Post & Reel Extraction API
• Instagram Trending Scraper - Instagram Explore Trending Content Extraction API

X / Twitter

• Twitter Community Scraper - Twitter Community Extraction & Member Analysis
• Twitter Info Scraper - X/Twitter Profile Extraction & User Intelligence

TikTok

• TikTok Creator Scraper - TikTok Creator Profile Extraction & Analytics
• TikTok Live Downloader - TikTok Live Stream Recording & Download
• TikTok Transcript - TikTok Video Transcription & Content Extraction

Video & Content

• All Video Scraper - Multi-Platform Video Download & Extraction (1000+ Sites)
• Video Caption Scraper - Video Caption Extraction & Subtitle Data
• Video Transcript - Universal Video Transcription & AI Training Data
• Video to Social Post - Video Content Conversion & Social Media Repurposing
• Live Stream Transcript - Live Stream Transcription & Real-Time Content Extraction

YouTube

• YouTube Transcript - YouTube Video Transcription & Speech Extraction
• YouTube Market Intelligence - YouTube Channel & Video Metadata Extraction

Real Estate

• Realtor Property Scraper - Realtor.com Property Data Extraction & Market Intelligence
• Zillow For Sale Scraper - Zillow Property Listing Extraction & Real Estate Data

Maps & Local

• Google Maps Store Scraper - Google Maps Business Data Extraction & Location Intelligence

---

Support & Community

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

---

Last Updated: April 21, 2026