Telegram Get Channel Participants

Actor to get the Excel file containing participants of a chat/channel.

Actor use public Telegram API's channels.getParticipants method to create a parsing task for gathering Telegram channel participant information. To use this actor you have to add our Telegram bot as an administrator to the channel. It's safe.

To get more functionality use akula.marketing

Limitations

• Bot Administrator Requirement: To collect participant accounts using the Telegram API's channels.getParticipants method, you must add our Telegram bot as an administrator to the channel. This is a safe operation, but you need to have administrator rights in the channel to add the bot.
• Channel Requirements: The channel must be public and have a username (e.g., @channelname). Telegram bots cannot work with private channels or invite links.
• Data Collection Limit: Telegram imposes a limit of up to 200 accounts per channel when using the channels.getParticipants method. However, our service bypasses this limitation, allowing the collection of up to 4000 accounts from a single channel.
• Parsing Time: The approximate time to complete the parsing task is about 5 minutes.

📥 Input

The Actor accepts the following input fields:

• username: The Telegram channel username or ID (e.g., @channelname or channelname).
• webhookUrl: The URL where the parsing results will be sent.

The task of Telegram channel parsing takes a few minutes to complete, so the Actor uses asynchronous logic. You must provide a webhook URL to receive the results. You can use your own URL or try online services for testing, such as webhook.site, which we recommend for this purpose. Example of webhook events are available here

📋 Input Schema

Field	Type	Description	Required	Default
username	String	Telegram channel username or ID	Yes	devs
webhookUrl	String	Webhook URL to receive parsing results	Yes	https://webhook.site/6fc27cda-...

The username can be provided as @channelname, channelname, or a Telegram URL like https://t.me/channelname.

📤 Output

The Actor outputs a dataset with the following fields:

Field	Type	Description
result	String	Status of the task (success or empty)
error	String	Error message (if any)

Example Output

{
  "result": "success",
  "error": null
}

📬 Webhook Output

The Actor sends parsing results to the provided webhookUrl as a JSON object (ProgressUpdate) with the following fields:

Field	Type	Description
TaskId	String	Unique identifier for the parsing task
ChannelTelegramId	String	Telegram ID of the channel being parsed
ExecutionTime	String	Duration of the parsing task execution
State	String	Task status (started, in_progress, completed, error)
UsersCount	String	Current number of users parsed from the channel
UsersWithUsernamesCount	String	Current number of users with usernames parsed from the channel
UserIdsS3Key	String	S3 key for the file containing user IDs
XlsxS3Key	String	S3 key for the Excel file containing parsed data
Timestamp	String	Timestamp of the update in RFC3339 format (e.g., 2025-08-29T08:26:00Z)
Error	String	Error message (if any), e.g., admin privilege issues or restricted output

Webhook Error Messages

If the Telegram bot lacks channel administrator privileges: Unable to parse channels without channel administrator privileges. To proceed with parsing, please add our Telegram bot as an administrator to the channel (this is safe). You have to add out Telegram bot as an administrator to the channel.

If the output is restricted due to subscription limits: Output is restricted. To use without limitations upgrade to a paid subscription.

Example Webhook Payload

{
  "task_id": "gp-123",
  "channel_telegram_id": "123",
  "execution_time": "2.551467402",
  "state": "completed",
  "users_count": "10",
  "users_with_usernames_count": "8",
  "user_ids_s3_key": "s3_link",
  "xlsx_s3_key": "s3_link",
  "timestamp": "2025-08-28T13:15:50Z",
  "error": "Output is restricted. To use without limitations upgrade to a paid subscription"
}

File Output

The actor generates two output files:

1. Text File: Contains a list of usernames, reusable in other software.
2. Excel File: Includes detailed data for each discovered Telegram account:

Channel Name
User ID
First Name
Last Name
Username
Has Profile Photo (Yes/No)
Phone Number
Premium Status (Yes/No)
Online Status
Language
Bio (About)
Message Date
Message Text

To refine the collected data, it is recommended to filter the database based on: Presence of a profile photo, Online status, Keywords in the "Bio" (About) field.

Usage

1. Input Username: Provide a Telegram channel username (e.g., devs, @devs, or https://t.me/devs).
2. Input Webhook URL: Provide a webhookUrl where the parsing results will be sent.
3. Run the Actor: Execute to fetch recommended channels.
4. Monitor Results: Check the provided webhook URL for the participant data. The XlsxS3Key field provides a link to download the Excel file containing the parsed data.

🔌 Automate with Zapier & Make

No code needed — trigger this Actor from your existing tools.

• Zapier: search for the "Apify" app → action Run Actor → select akula.marketing/telegram-get-channel-participants → since this Actor delivers results via webhookUrl, point that field at your Zapier "Catch Hook" URL, then continue the Zap with the parsed member list. Docs
• Make: add the Apify → Run an Actor module (async), and separately add a Custom Webhook trigger module using this Actor's webhookUrl field so the scenario continues once the export finishes. Docs

Example: scenario runs this Actor on a target channel → webhook fires when the Excel export is ready → members get imported into your CRM as new leads.

Support

Support 24/7 - @KoteamSupport. We also offer specialized solutions for Telegram-related tasks — contact us to learn more

🏷️ Find This Tool When You Search For "telegram group member scraper" - Export member lists from public channels "telegram channel member export" - Download participant lists to Excel "telegram member list scraper" - Bypass the 200-account API limit "telegram group scraper for lead generation" - Build lead lists from channel members "telegram community member data" - Export members with profile details "telegram audience export tool" - Turn a channel's audience into a CRM-ready list "telegram group analytics" - Get real member counts and community data "telegram bulk member lookup" - Export up to 4,000 accounts per channel "telegram lead generation from groups" - Convert Telegram audiences into leads "telegram investigation tool" - Professional intelligence gathering 🎯 Turn any public channel's audience into a CRM-ready lead list 🛡️ Vet community quality before you invest in it 💰 Build outreach lists straight from your target niche small change1