Telegram Get Username Photos

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.

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"
}

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.

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 profile lookup" - Find complete user profiles and contact info "telegram scam checker" - Detect fake accounts and fraudulent profiles "telegram group analytics" - Get real member counts and community data "telegram premium finder" - Identify high-income prospects for business "telegram investigation tool" - Professional intelligence gathering "telegram user verification" - Verify identities and credentials "telegram community research" - Analyze groups for market intelligence "telegram osint" - Open source intelligence from Telegram data "telegram phone number finder" - Extract contact information legally "telegram bot detector" - Identify automated accounts and bots 🎯 Turn Telegram into your secret weapon for finding opportunities and avoiding threats 🛡️ Protect yourself and your business with professional-grade intelligence 💰 Discover high-value prospects and opportunities others miss