Telegram Private Group Scraper avatar

Telegram Private Group Scraper

Pricing

from $0.27 / 1,000 results

Go to Apify Store
Telegram Private Group Scraper

Telegram Private Group Scraper

Authenticated private-group member extractor — log in once with QR (and optional 2FA), then pull up to 100,000 members from any private Telegram group or supergroup you already belong to. Optional Deep Search reveals hidden and historical members alongside username, names, and activity signals.

Pricing

from $0.27 / 1,000 results

Rating

5.0

(2)

Developer

AgentX

AgentX

Maintained by Community

Actor stats

2

Bookmarked

27

Total users

10

Monthly active users

7 days ago

Last modified

Share

Telegram Private Group Scraper - Telegram Private Group Intelligence API

Telegram Private Group Scraper is a Telegram private-group intelligence API that extracts structured member profiles from private Telegram groups and supergroups you are already a member of, in a single authorized session-driven run. Telegram Private Group Scraper returns structured records per member, including user ID, username handle, display name, phone number (visible to authenticated account), last_seen activity (online / recently / last_week / last_month), premium flag, verified flag, scam flag, fake flag, language code, profile photo URL, restriction reasons, and group join date. Coverage spans all private Telegram groups and supergroups where the operating account holds membership, with deep-search mode for hidden and historical members and reusable QR-login session string. Built for compliance audits, authorized lead enrichment, internal community intelligence, regulated-industry message-and-member auditing, partner-channel analytics, and B2B account-level Telegram-engagement pipelines. Per-member pay-per-result pricing at $0.00029 with no monthly minimum.

Telegram Private Group Intelligence Authorized Access


Why Choose This API

Private Telegram Group Member Extraction for Authorized B2B Pipelines

🔐 Authenticated Private Group Access Uses Telegram session-based authentication — enabling member extraction from private groups and supergroups that the authenticated account is already a member of. QR login on first run, session reuse for all subsequent runs.

🔍 Deep Search — Hidden & Historical Members Enable deep_search to surface hidden members and historical participants beyond the standard visible member list — enabling complete community sizing and comprehensive audience datasets from large private groups.

📱 Last Seen Activity Signals The last_seen field returns per-member activity status — online, ISO 8601 offline timestamp, recently, last_week, last_month, or unknown — enabling active member identification and engagement tier segmentation.

📞 Phone Number Extraction The phone_number field captures phone numbers visible to the authenticated account — enabling phone-verified contact enrichment and direct outreach qualification for B2B lead generation pipelines.

🛡️ Scam & Trust Quality Flags The is_scam, is_fake, is_verified, is_deleted, and is_restricted flags deliver per-member trust signals — enabling audience quality assessment, bot/scam filtering, and legitimate member identification.


Quick Start Guide

How to Extract Private Telegram Group Members in 3 Steps

Step 1: Authenticate Your Telegram Account

Open Actor Input

Leave session empty on first run — scan the QR code in the run log with your Telegram app. After login, copy and save the printed session string for future runs.

Step 2: Configure Group Target and Volume

Enter a group_match substring that matches your target private group name, @username, or numeric ID. Set deep_search and max_results as needed.

Step 3: Download Structured Member Data

Export as JSON or CSV, or access programmatically via the Apify dataset API.


Input Parameters

Configuration Fields

ParameterTypeRequiredDescriptionExample Values
sessionstring (secret)Saved Telegram session string (QR login on first run)"1BQAAUM4..."
passwordstring (secret)Telegram 2FA password (if enabled)"mypassword"
group_matchstringSubstring to match target group (title, @username, or numeric ID)"binance", "my_private_group"
deep_searchbooleanEnable to include hidden and historical membersfalse, true
max_resultsintegerMaximum number of members to extract (100–100,000)500, 5000

Example Input Configuration

{
"group_match": "my_private_community",
"deep_search": false,
"max_results": 1000
}

Output Data Schema

Complete Member Profile Record Structure

Each extracted Telegram private group member record contains the following fields:

Open Actor Output

Core Member Fields

FieldTypeDescription
processorstringApify actor URL that processed this record
processed_atstringISO 8601 timestamp (UTC) when scraped
user_idintegerTelegram user unique identifier
first_namestringUser's first name
last_namestringUser's last name
usernamesarrayAll Telegram @username handles for the user
phone_numberstringPhone number visible to the authenticated account
entity_typestringuser or bot
is_deletedbooleanAccount deleted status
is_verifiedbooleanTelegram verified status
is_premiumbooleanTelegram Premium subscriber status
is_scambooleanScam-flagged status
is_fakebooleanFake account flag
is_restrictedbooleanAccount restriction flag
lang_codestringUser language code
last_seenstringActivity status (online / timestamp / recently / last_week etc.)
stories_hiddenbooleanStories visibility flag
premium_contactbooleanRequires Telegram Premium to contact flag

Example JSON Output

{
"processor": "https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi",
"processed_at": "2026-05-01T10:30:00.000Z",
"user_id": 987654321,
"first_name": "Jane",
"last_name": "Smith",
"usernames": ["janesmith"],
"phone_number": "+442071234567",
"entity_type": "user",
"is_deleted": false,
"is_verified": false,
"is_premium": false,
"is_scam": false,
"is_fake": false,
"lang_code": "en",
"last_seen": "recently",
"premium_contact": false
}

Export Formats

  • JSON - Complete structured member profile data
  • CSV - Spreadsheet-compatible for audience analytics
  • 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. ActorBy IDPaste 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 = {
"group_match": "my_private_community",
"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 = {
group_match: "my_community",
deep_search: true,
max_results: 500,
};
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",
"@graph": [
{
"@type": "SoftwareApplication",
"@id": "https://apify.com/agentx/telegram-private-group-scraper#software",
"name": "Telegram Private Group Scraper",
"description": "Telegram Private Group Scraper is a Telegram private group intelligence API extracting member profiles from authorized private groups with phone numbers, activity signals, premium status, scam flags, and deep search for hidden/historical members.",
"applicationCategory": "BusinessApplication",
"applicationSubCategory": "Lead Generation API",
"operatingSystem": "Web, Cloud",
"url": "https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi",
"softwareVersion": "1.0.0",
"datePublished": "2024-08-01",
"dateModified": "2026-05-01",
"featureList": [
"Authorized session-based access to private groups",
"User ID, username, display name, phone number",
"Last_seen activity and premium/verified flags",
"Scam and fake trust-quality flags",
"Deep search mode for hidden/historical members",
"Reusable QR-login session string",
"Per-member pay-per-result at $0.00029",
"Native integrations with Make.com, n8n, LangChain, and CrewAI"
],
"offers": {
"@type": "Offer",
"price": "0.00029",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
},
"author": { "@id": "https://apify.com/agentx#person" },
"publisher": { "@id": "https://apify.com#organization" }
},
{
"@type": "Person",
"@id": "https://apify.com/agentx#person",
"name": "AgentX",
"url": "https://apify.com/agentx",
"sameAs": [
"https://apify.com/agentx",
"https://t.me/AiAgentApi",
"https://t.me/Apify_Actor"
],
"knowsAbout": [
"web scraping",
"Telegram",
"private group intelligence",
"compliance audit",
"member extraction"
]
},
{
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Apify",
"item": "https://apify.com"
},
{
"@type": "ListItem",
"position": 2,
"name": "AgentX",
"item": "https://apify.com/agentx"
},
{
"@type": "ListItem",
"position": 3,
"name": "Telegram Private Group Scraper",
"item": "https://apify.com/agentx/telegram-private-group-scraper"
}
]
}
]
}

Pricing & Cost Calculator

Pay-Per-Result Pricing

EventRate
Actor Start$0.01 per GB memory
Result (per member)$0.00029 (BRONZE)

Cost Calculator Examples

MembersEstimated Cost
100 members~$0.04
500 members~$0.16
1,000 members~$0.30
5,000 members~$1.50
10,000 members~$2.91
50,000 members~$14.51

Use Cases & Applications

Authorized Community Intelligence

Private Group Audience Profiling Extract member profiles from your private Telegram communities — building audience datasets with language segmentation, activity tiers, and premium user identification for authorized lead qualification workflows.

Compliance & Membership Auditing The structured member dataset enables community membership auditing — identifying deleted accounts, restricted users, and scam-flagged members for compliance reporting and community health assessments.

Group Migration & Member Archiving Extract complete member lists before group migrations or platform changes — building membership archives for compliance, continuity planning, and authorized community transfer workflows.

Integration Pipeline

Private Group → Group Inviter Pipeline Extract member usernames here, then pass into Telegram Group Inviter for authorized cross-group migration — enabling structured community transfer with per-target status logging.

Member List → Profile Enrichment Pass extracted usernames into Telegram Info Scraper for 30+ field entity enrichment — building comprehensive member intelligence datasets from private community extractions.


FAQ

Do I need to be a member of the group to use this actor?

Yes — the authenticated Telegram account must already be a member of the target group. This actor cannot access groups the account has not joined.

How does the group_match field work?

Enter any substring that uniquely identifies your group — a word from the group title, @username, or the numeric group ID. The actor matches the first group in your dialog list that contains this substring.

How do I save the session for reuse?

On first run with an empty session field, the actor prints a QR code in the log. Scan it with Telegram to authenticate. After login completes, the session string is printed — copy and save it for future runs.

What is the difference between this and Telegram Member Scraper?

Telegram Member Scraper extracts members from public groups by URL. This actor uses authenticated session access to extract members from private groups and supergroups the account belongs to.


SEO Keywords & Search Terms

Primary Keywords

Telegram private group scraper API, Telegram private group member extractor, Telegram private community intelligence, Telegram authenticated member extraction, Telegram private group member API, Telegram group member data pipeline, Telegram private group audience API, Telegram authorized member scraper, Telegram private community extraction, Telegram member list API

Long-Tail Keywords

how to extract Telegram private group members programmatically, Telegram private group phone number extractor, Telegram private community audience analysis, Telegram authorized group member scraper, Telegram private group deep member search, Telegram session-based member extraction, Telegram group member audit API, Telegram private group lead extraction, Telegram private community compliance audit, Telegram private group intelligence pipeline

Industry Terms

Telegram private group intelligence API, authorized community extraction, session-based member scraping, private community audience profiling, group migration intelligence, compliance membership audit, phone-verified lead extraction, deep member search pipeline, Telegram lead generation API, private group analytics


Trust & Certifications

  • Production-Grade Infrastructure — runs on the Apify cloud platform with managed proxy rotation and automatic retries
  • Authorized-Access & Privacy-Aligned — operates only on private groups where the user is already a member; session credentials encrypted in Apify secret store and never persisted beyond the run
  • Pay-Per-Result Billing — transparent $0.00029 per member with no monthly minimum or seat fees
  • Continuously Maintained — schema and selector updates released as Telegram evolves

Data Rights & Usage

This actor extracts member data from private Telegram groups that the authenticated account is an authorized member of. Users are solely responsible for ensuring all extraction activities are authorized, comply with applicable privacy laws, and are consistent with Telegram's terms of service. Extract only groups you are legitimately a member of.

Privacy Compliance

  • GDPR: Users must ensure compliance with EU GDPR when processing member personal data.
  • CCPA: Users must ensure compliance with California Consumer Privacy Act requirements.

Platform Terms of Service

Users must review and comply with Telegram's terms of service. Only extract data from groups where you have legitimate membership and appropriate authorization.

Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries:


Jobs & Hiring

Social Media

Video & Transcript

E-Commerce & Retail

Classifieds & Automotive

Real Estate

Business Intelligence & Reviews

Other


Support & Community


Last Updated: May 01, 2026