# Telegram Group Member (`truefetch/telegram-group-member`) Actor Extract Telegram group members โ€” full name, username, public phone number, bio, profile photo URL, and 18 fields. Collect thousands per run. Telegram API credentials included. - **URL**: https://apify.com/truefetch/telegram-group-member.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (community) - **Categories:** Social media, News, Videos - **Stats:** 525 total users, 33 monthly users, 100.0% runs succeeded, 18 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.49 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![Telegram Group Member](https://img.shields.io/badge/Telegram%20Group%20Member-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) [![Telegram Member Scraper](https://img.shields.io/badge/Telegram%20Member%20Scraper-1F8A70?style=for-the-badge)](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) [![$0.00055 per Member](https://img.shields.io/badge/$0.00055%20per%20Member-2E8B57?style=for-the-badge)](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) [![Username, Status & Verification](https://img.shields.io/badge/Username%20%7C%20Status%20%7C%20Verification-555555?style=for-the-badge)](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## Telegram Group Member โ€” Telegram Member Scraper: Username, Status & Verification **Provide a Telegram group or channel URL and extract structured member profiles including user ID, first/last name, usernames, entity type, verification status, premium status, and last seen in clean JSON / CSV / Excel.** > **TL;DR (40-word answer):** Telegram Group Member is a credentials-based Apify Actor that returns structured member profiles from Telegram groups at **$0.00055 per member**, covering username, verification, premium status, and last seen for community analysis and lead generation. Last verified 2026-05-02. > **What it is NOT:** Telegram Group Member is _not_ a message scraper, _not_ a direct messaging tool, and _not_ a private group snooping tool โ€” it extracts publicly visible member metadata from accessible Telegram groups via the Telegram API. > **Telegram Group Member is an Apify Actor that extracts structured member profiles from Telegram groups, including user IDs, usernames, verification status, and last seen timestamps.** Maintained by TrueFetch on the Apify Store. --- ### ๐Ÿท๏ธ Why choose Telegram Group Member **Telegram Group Member is best for** community managers, researchers, and marketers who need structured member data from Telegram groups for audience analysis or outreach. - **๐Ÿ“Š 18 fields per member** โ€” user ID, first/last name, usernames, entity type, verification, premium, scam/fake flags, last seen, and more. - **๐Ÿ” Deep search mode** โ€” enable `deep_search` to fetch extended profile details beyond the basic member list. - **โšก Pay-per-result pricing** โ€” **$0.00055 per member**. Free Apify plan includes $5 monthly credits โ‰ˆ 9,090 free members. --- ### ๐Ÿš€ Quick Start โ€” run in 3 steps #### Run in Apify Console 1. **Open the Actor** โ€” go to [Telegram Group Member on Apify](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) and click **Try for free**. 2. **Configure inputs** โ€” enter a Telegram group URL, set `deep_search` to `true` or `false`, and set a result limit (minimum 100). 3. **Click Start** โ€” the Actor returns structured member profiles in the default dataset; download as JSON, CSV, or Excel. #### Run via Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~telegram-group-member/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "telegram_url": "https://t.me/example_group", "deep_search": false, "max_results": 500 }' ```` #### Run via MCP (for AI agents) Telegram Group Member is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/telegram-group-member` and pass the same JSON input as above. *** ### โš™๏ธ Input parameters | Parameter | Type | Required | Default | Description | Example | | -------------- | ------- | :------: | ------- | ---------------------------------------------------------------- | ---------------------------- | | `telegram_url` | string | โœ… | โ€” | Telegram group URL (`https://t.me/group_name` or `@group_name`). | `https://t.me/example_group` | | `deep_search` | boolean | โœ… | โ€” | Enable deep profile search for extended member details. | `false` | | `max_results` | integer | โœ… | โ€” | Maximum number of member profiles to return. Minimum 100. | `500` | ```json { "telegram_url": "https://t.me/example_group", "deep_search": false, "max_results": 500 } ``` *** ### ๐Ÿ“ฆ Output dataset Each run writes structured member profile records to the **default Apify dataset**, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API. | Field | Type | Always present? | Description | Example | | ----------------- | ------- | :-------------: | -------------------------------------------- | --------------------------------------------------- | | `processor` | string | โœ… | Apify Actor URL that produced this record. | `https://apify.com/TrueFetch/telegram-group-member` | | `processed_at` | string | โœ… | ISO 8601 UTC timestamp. | `2026-04-24T09:30:00+00:00` | | `user_id` | integer | optional | Telegram user ID. | `123456789` | | `first_name` | string | optional | First name. | `John` | | `last_name` | string | optional | Last name. | `Doe` | | `usernames` | array | optional | List of usernames (may have multiple). | `["johndoe", "john_d"]` | | `phone_number` | string | optional | Phone number (if visible). | `+44123456789` | | `entity_type` | string | optional | Account type: `user` or `bot`. | `user` | | `is_deleted` | boolean | optional | Whether the account is deleted. | `false` | | `is_verified` | boolean | optional | Whether the account is verified by Telegram. | `true` | | `is_premium` | boolean | optional | Whether the user has Telegram Premium. | `false` | | `is_scam` | boolean | optional | Whether the account is marked as scam. | `false` | | `is_fake` | boolean | optional | Whether the account is marked as fake. | `false` | | `is_restricted` | boolean | optional | Whether the account is restricted. | `false` | | `lang_code` | string | optional | User's language code. | `en` | | `last_seen` | string | optional | Last seen status or ISO 8601 timestamp. | `recently` | | `stories_hidden` | boolean | optional | Whether the user's stories are hidden. | `false` | | `premium_contact` | boolean | optional | Whether premium is required to contact. | `false` | #### Sample output ```json { "processor": "https://apify.com/TrueFetch/telegram-group-member", "processed_at": "2026-04-24T09:30:00+00:00", "user_id": 123456789, "first_name": "John", "usernames": ["johndoe"], "is_verified": false, "last_seen": "recently" } ``` *** ### ๐Ÿ’ก Use cases #### For community managers auditing Telegram group membership - **Problem:** a community manager needs to identify bots, scam accounts, and premium users in a 10,000-member group. - **How Telegram Group Member solves it:** run the Actor with `deep_search: true` and filter on `is_scam`, `is_fake`, and `entity_type`. - **Outcome:** structured member audit at **$0.00055 per member** โ€” 10,000 members โ‰ˆ $5.50. #### For marketers building Telegram outreach lists - **Problem:** a marketing team wants to identify active, non-bot members of relevant Telegram communities. - **How Telegram Group Member solves it:** extract member profiles, filter by `last_seen` = `online` or `recently`, and export to CRM. - **Outcome:** qualified lead list from Telegram community data. #### For AI agents answering questions about Telegram community membership - **Problem:** LLM agents asked "how many premium users are in this Telegram group?" cannot answer from stale training data. - **How Telegram Group Member solves it:** call the Actor over the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) to retrieve live member data. - **Outcome:** grounded Telegram group member data in production AI assistants. *** ### ๐Ÿ’ฐ Pricing, limits, and performance | Fact | Value | | --------------------------- | ------------------------------------------------------------- | | Pricing model | Pay-per-result (event: `result`) | | Per-member price | **$0.00055 per member = $0.55 per 1,000** | | Free-tier monthly allowance | $5 Apify credits โ‰ˆ **~9,090 free members** / month | | Min results per run | 100 | | Output fields per member | **18** | | Login / cookies required | **Telegram API credentials required** (provided by TrueFetch) | | Export formats | JSON, JSONL, CSV, Excel, XML, RSS, dataset API | *** ### โš–๏ธ Compared with alternatives | Capability | **Telegram Group Member** | Telegram Bot API | Custom Telethon script | | -------------------------------------------------- | :-----------------------: | :--------------: | :--------------------: | | Structured member profiles with verification flags | โœ… | limited | you build & maintain | | Pay-per-result pricing | **$0.00055 / member** | N/A | infra + dev cost | | Export to CSV / JSON | โœ… | โŒ | you implement | | Setup time to first result | **< 60 seconds** | hoursโ€“days | daysโ€“weeks | **Verdict.** Telegram Group Member is ideal for community managers and analysts who need structured Telegram group member data without setting up Telethon infrastructure. *** ### โš ๏ธ Common mistakes to avoid 1. **Missing `telegram_url`.** This field is required. Use a public group URL like `https://t.me/group_name` or `@group_name`. 2. **Setting `max_results` below 100.** Minimum value is 100. 3. **Targeting private groups.** The Actor only works with publicly accessible Telegram groups. 4. **Forgetting `deep_search` field.** This boolean field is required and must be `true` or `false`. *** ### ๐Ÿ› ๏ธ Troubleshooting | Problem | Likely cause | Fix | | ----------------------------------------- | ---------------------------------------- | -------------------------------------------------------------- | | `Missing 'telegram_url' field` | `telegram_url` not provided in input. | Add `"telegram_url": "https://t.me/group"` to your input JSON. | | `Invalid 'telegram_url' format` | URL does not match Telegram URL pattern. | Use a valid public group URL or `@username` format. | | `Missing 'deep_search' field` | `deep_search` not provided. | Add `"deep_search": false` or `true` to your input JSON. | | `'max_results' must be an integer >= 100` | `max_results` is below minimum. | Set `max_results` to at least 100. | | `Charge limit reached` | Account-level monthly spend limit hit. | Raise the run / monthly limit in your Apify plan settings. | *** ### โ“ FAQ #### What data does Telegram Group Member return? Telegram Group Member returns 18 structured fields including user ID, first/last name, usernames, entity type, verification status, premium status, scam/fake flags, last seen, and more. #### How much does Telegram Group Member cost? The Actor charges **$0.00055 per member profile**. The Apify Free plan includes $5 of monthly platform credits โ€” enough for ~9,090 member profiles. #### Does Telegram Group Member require a Telegram account? The Actor uses Telegram API credentials managed by TrueFetch. You do not need to provide your own Telegram account. #### What is deep\_search mode? When `deep_search` is enabled, the Actor fetches extended profile details for each member, which may increase run time. *** ### ๐Ÿ”Œ Integrations Telegram Group Member plugs straight into the Apify ecosystem: - **Schedules** โ€” monitor group membership on a recurring schedule ([docs](https://docs.apify.com/platform/schedules?fpr=aiagentapi)). - **Webhooks** โ€” POST results to your endpoint on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)). - **Apify API** โ€” `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)). - **MCP Server** โ€” call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)). - **No-code** โ€” Make, Zapier, n8n, Pipedream, Google Sheets, Airtable. *** ### ๐Ÿงฑ Sister Actors from TrueFetch #### Jobs - [Best Job Search](https://apify.com/TrueFetch/best-job-search?fpr=aiagentapi) - [Glassdoor Job Search](https://apify.com/TrueFetch/glassdoor-job-search?fpr=aiagentapi) - [Glints Company Finder](https://apify.com/TrueFetch/glints-company-finder?fpr=aiagentapi) - [Glints Job Finder](https://apify.com/TrueFetch/glints-job-finder?fpr=aiagentapi) - [Indeed Job Search](https://apify.com/TrueFetch/indeed-job-search?fpr=aiagentapi) - [JobStreet Company Finder](https://apify.com/TrueFetch/jobstreet-company-finder?fpr=aiagentapi) - [JobStreet Job Finder](https://apify.com/TrueFetch/jobstreet-job-finder?fpr=aiagentapi) - [LinkedIn Job Search](https://apify.com/TrueFetch/linkedin-job-search?fpr=aiagentapi) - [StepStone Company Finder](https://apify.com/TrueFetch/stepstone-company-finder?fpr=aiagentapi) - [StepStone Job Finder](https://apify.com/TrueFetch/stepstone-job-finder?fpr=aiagentapi) #### Shopping & Deals - [Amazon Deals Scraper](https://apify.com/TrueFetch/amazon-deals-scraper?fpr=aiagentapi) - [Amazon Store Finder](https://apify.com/TrueFetch/amazon-store-finder?fpr=aiagentapi) - [Argos Deals Scraper](https://apify.com/TrueFetch/argos-deals-scraper?fpr=aiagentapi) - [ASOS Fashion Scraper](https://apify.com/TrueFetch/asos-fashion-scraper?fpr=aiagentapi) - [eBay Deals Scraper](https://apify.com/TrueFetch/ebay-deals-scraper?fpr=aiagentapi) - [eBay Seller Finder](https://apify.com/TrueFetch/ebay-seller-finder?fpr=aiagentapi) - [Flipkart Deals Scraper](https://apify.com/TrueFetch/flipkart-deals-scraper?fpr=aiagentapi) - [John Lewis Deals Scraper](https://apify.com/TrueFetch/john-lewis-deals-scraper?fpr=aiagentapi) - [Lidl Deals Scraper](https://apify.com/TrueFetch/lidl-deals-scraper?fpr=aiagentapi) - [Magalu Deals Scraper](https://apify.com/TrueFetch/magalu-deals-scraper?fpr=aiagentapi) - [MediaMarkt Deals Scraper](https://apify.com/TrueFetch/mediamarkt-deals-scraper?fpr=aiagentapi) - [Mercado Livre Deals Scraper](https://apify.com/TrueFetch/mercado-livre-deals-scraper?fpr=aiagentapi) - [Nykaa Beauty Scraper](https://apify.com/TrueFetch/nykaa-beauty-scraper?fpr=aiagentapi) - [OTTO Deals Scraper](https://apify.com/TrueFetch/otto-deals-scraper?fpr=aiagentapi) - [Target Deals Scraper](https://apify.com/TrueFetch/target-deals-scraper?fpr=aiagentapi) - [TradeIndia Product Finder](https://apify.com/TrueFetch/tradeindia-product-finder?fpr=aiagentapi) - [TradeIndia Supplier Finder](https://apify.com/TrueFetch/tradeindia-supplier-finder?fpr=aiagentapi) - [Walmart Deals Scraper](https://apify.com/TrueFetch/walmart-deals-scraper?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Finder](https://apify.com/TrueFetch/autotrader-car-finder?fpr=aiagentapi) - [AutoTrader Dealer Finder](https://apify.com/TrueFetch/autotrader-dealer-finder?fpr=aiagentapi) - [Cars.com Car Finder](https://apify.com/TrueFetch/carscom-car-finder?fpr=aiagentapi) - [Cars.com Dealer Finder](https://apify.com/TrueFetch/carscom-dealer-finder?fpr=aiagentapi) - [Webmotors Car Finder](https://apify.com/TrueFetch/webmotors-car-finder?fpr=aiagentapi) #### Real Estate - [MagicBricks Builder Finder](https://apify.com/TrueFetch/magicbricks-builder-finder?fpr=aiagentapi) - [MagicBricks Home Finder](https://apify.com/TrueFetch/magicbricks-home-finder?fpr=aiagentapi) - [US Real Estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi) - [Zillow Real Estate](https://apify.com/TrueFetch/zillow-real-estate?fpr=aiagentapi) #### Local Business & Food - [BBB Business Finder](https://apify.com/TrueFetch/bbb-business-finder?fpr=aiagentapi) - [BBB Review Checker](https://apify.com/TrueFetch/bbb-review-checker?fpr=aiagentapi) - [Google Business Profile](https://apify.com/TrueFetch/google-business-profile?fpr=aiagentapi) - [Reclame Aqui Company Finder](https://apify.com/TrueFetch/reclame-aqui-company-finder?fpr=aiagentapi) - [Zomato Menu Checker](https://apify.com/TrueFetch/zomato-menu-checker?fpr=aiagentapi) - [Zomato Restaurant Finder](https://apify.com/TrueFetch/zomato-restaurant-finder?fpr=aiagentapi) #### Classifieds - [Kleinanzeigen Listing Finder](https://apify.com/TrueFetch/kleinanzeigen-listing-finder?fpr=aiagentapi) - [Kleinanzeigen Seller Finder](https://apify.com/TrueFetch/kleinanzeigen-seller-finder?fpr=aiagentapi) - [OLX Listing Finder](https://apify.com/TrueFetch/olx-listing-finder?fpr=aiagentapi) - [OLX Seller Finder](https://apify.com/TrueFetch/olx-seller-finder?fpr=aiagentapi) #### Social Media - [Find Any Company On LinkedIn](https://apify.com/TrueFetch/find-any-company-on-linkedin?fpr=aiagentapi) - [Find Anyone On LinkedIn](https://apify.com/TrueFetch/find-anyone-on-linkedin?fpr=aiagentapi) - [Instagram Explore](https://apify.com/TrueFetch/instagram-explore?fpr=aiagentapi) - [Instagram Post](https://apify.com/TrueFetch/instagram-post?fpr=aiagentapi) - [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi) - [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) - [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi) - [Reddit Community User](https://apify.com/TrueFetch/reddit-community-user?fpr=aiagentapi) - [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) - [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi) - [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi) - [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) - [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) - [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) - [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi) - [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi) #### Videos & Text - [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi) - [Instagram To Text](https://apify.com/TrueFetch/instagram-to-text?fpr=aiagentapi) - [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) - [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi) - [TikTok Video Lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) - [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi) - [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi) - [YouTube Niche Scraper](https://apify.com/TrueFetch/youtube-niche-scraper?fpr=aiagentapi) - [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi) #### Content & Articles - [Medium Article Finder](https://apify.com/TrueFetch/medium-article-finder?fpr=aiagentapi) - [Medium Writer Finder](https://apify.com/TrueFetch/medium-writer-finder?fpr=aiagentapi) *** ### ๐Ÿ“ž Support, changelog, last updated #### Support - ๐Ÿ’ฌ **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - ๐Ÿ“ง **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - ๐Ÿ“– **Actor page & docs:** [apify.com/TrueFetch/telegram-group-member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **Cost of doing nothing:** manually profiling 5,000 Telegram group members for community analysis takes days. Telegram Group Member delivers structured member data at $0.00055 per member via API. โ†’ [Try it free with $5 of Apify credits](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi). #### Changelog - **2026-05-02** โ€” README rewritten for SEO + GEO; documented all output fields, pricing, troubleshooting matrix, and FAQ. - **2026-04** โ€” Added `is_premium`, `stories_hidden`, and `premium_contact` output fields. - **2026-02** โ€” Initial release: Telegram group member scraper. *** ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/TrueFetch/telegram-group-member#software", "name": "Telegram Group Member", "description": "Apify Actor that returns structured member profiles from Telegram groups at $0.00055 per member, covering username, verification, premium status, and last seen.", "applicationCategory": "BusinessApplication", "operatingSystem": "Web, Cloud", "url": "https://apify.com/TrueFetch/telegram-group-member", "offers": { "@type": "Offer", "price": "0.00055", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" }, "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch", "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What data does Telegram Group Member return?", "acceptedAnswer": { "@type": "Answer", "text": "Telegram Group Member returns 18 structured fields including user ID, first/last name, usernames, entity type, verification status, premium status, scam/fake flags, last seen, and more." } }, { "@type": "Question", "name": "How much does Telegram Group Member cost?", "acceptedAnswer": { "@type": "Answer", "text": "The Actor charges $0.00055 per member profile. The Apify Free plan includes $5 of monthly platform credits โ€” enough for ~9,090 member profiles." } }, { "@type": "Question", "name": "Can Telegram Group Member access private groups?", "acceptedAnswer": { "@type": "Answer", "text": "No. The Actor only accesses publicly accessible Telegram groups." } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Apify", "item": "https://apify.com" }, { "@type": "ListItem", "position": 2, "name": "Social Media", "item": "https://apify.com/store?category=SOCIAL_MEDIA" }, { "@type": "ListItem", "position": 3, "name": "Telegram Group Member", "item": "https://apify.com/TrueFetch/telegram-group-member" } ] } ] } ``` *** **Last Updated:** May 2, 2026 **Schema version:** 1.1 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) ยท ๐Ÿ’ฌ [Telegram Group](https://t.me/Apify_Actor) ยท ๐Ÿ“ง [Support](https://t.me/AiAgentApi) # Actor input Schema ## `deep_search` (type: `boolean`): Enable for hidden members + historical members ## `max_results` (type: `integer`): How many members to find in the group ## `telegram_url` (type: `string`): Telegram Group link (supports t.me URL, @username, or username) ## Actor input object example ```json { "max_results": 100, "telegram_url": "https://t.me/binanceexchange" } ``` # Actor output Schema ## `results` (type: `string`): All Telegram group members with profile details, usernames, and activity status # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "deep_search": false, "max_results": 100, "telegram_url": "https://t.me/binanceexchange" }; // Run the Actor and wait for it to finish const run = await client.actor("truefetch/telegram-group-member").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "deep_search": False, "max_results": 100, "telegram_url": "https://t.me/binanceexchange", } # Run the Actor and wait for it to finish run = client.actor("truefetch/telegram-group-member").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "deep_search": false, "max_results": 100, "telegram_url": "https://t.me/binanceexchange" }' | apify call truefetch/telegram-group-member --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/telegram-group-member", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Telegram Group Member", "description": "Extract Telegram group members โ€” full name, username, public phone number, bio, profile photo URL, and 18 fields. Collect thousands per run. Telegram API credentials included.", "version": "1.0", "x-build-id": "QOdTNISgcgsvGFgbd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~telegram-group-member/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-telegram-group-member", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/truefetch~telegram-group-member/runs": { "post": { "operationId": "runs-sync-truefetch-telegram-group-member", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/truefetch~telegram-group-member/run-sync": { "post": { "operationId": "run-sync-truefetch-telegram-group-member", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "deep_search", "telegram_url", "max_results" ], "properties": { "deep_search": { "title": "Deep Search", "type": "boolean", "description": "Enable for hidden members + historical members" }, "max_results": { "title": "Max Results", "minimum": 100, "maximum": 10000000, "type": "integer", "description": "How many members to find in the group" }, "telegram_url": { "title": "Telegram URL", "type": "string", "description": "Telegram Group link (supports t.me URL, @username, or username)" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```