Telegram Profile Photo Scraper

💬 Questions, bulk pricing, or a custom solution? Talk to us on Telegram — @KoteamSupport.

Get all public profile photos of a Telegram account by its username, with upload dates and download links. You also get the basic profile: Telegram ID, name, Premium and bot flags, last-seen status, and language.

What it's for

• Account verification: check that a business contact's account looks real before a deal. A long photo history, Premium, and no bot flag are good signs.
• CRM avatars: add profile pictures to contacts you already have in your CRM.
• Bot detection: the bot flag and an empty photo history quickly point to automated accounts.

🛡️ Data & compliance

• Public profile only. The Actor returns the photos and profile fields Telegram shows to anyone who opens the profile. If the account's privacy settings hide its photos or phone number, they're not returned.
• Legitimate use. For example, checking whether an account is real before a business contact, or getting avatars of accounts in your own CRM. Don't use it to monitor or identify individuals.
• Your responsibility. Use the data in line with Telegram's Terms of Service and the privacy laws that apply to you (for example, GDPR). Don't use it for unsolicited bulk messaging.

📥 Input

The Actor accepts a single input field:

• username: A Telegram username (e.g., "username", "t.me/username").

📋 Input Schema

Field	Type	Description	Required
username	String	Telegram username or URL	Yes

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

📤 Output

The Actor outputs a dataset with the following fields:

Field	Type	Description
id	String	Telegram user ID
username	String	Input username
firstName	String	User's first name
lastName	String	User's last name
phone	String	User's phone
state	String	User's status (e.g., online, offline)
wasOnline	String	Last online timestamp
langCode	String	User's language code
premium	Boolean	Premium account status
blocked	Boolean	Blocked status
bot	Boolean	Whether the account is a bot
photos	Array	List of profile photos
status	String	Request status (e.g., success)
error	String	Error message (if any)

Each photo in the photos array includes:

Field	Type	Description
id	String	Photo ID
dcId	String	Data center ID
date	String	Photo upload date
url	String	Photo URL, expire in a week

🛠️ Usage

1. Input Username: Provide a Telegram username.
2. Run the Actor: Execute the Actor to fetch user details and photos.
3. View Results: Check the dataset or the "Telegram User Details" table view in the Apify console.

FAQ

How long do the photo links work?

About a week. Download the files you need, or run the Actor again to get fresh links.

Why are some accounts returned with no photos?

The account has no profile photo, or its privacy settings hide photos. Hidden photos aren't returned.

Can I check several usernames in one run?

One username per run. To check a list, start one run per username from the Apify API, Make, or Zapier. If you only need names and flags, not photos, Telegram Username Checker checks a whole list in one run.

Does it work for channels and groups?

It's built for personal accounts. For a channel's title, photo, and subscriber count, use Telegram Username Checker.

Does it return phone numbers?

Only if the account owner made the number visible in their Telegram privacy settings. Most accounts hide it, so phone is usually empty.

Example Result

{
  "id": "123456789",
  "username": "crypto",
  "firstName": "Crypto",
  "lastName": "Enthusiast",
  "phone": "",
  "state": "online",
  "wasOnline": "2025-08-13T18:30:00Z",
  "langCode": "en",
  "premium": true,
  "blocked": false,
  "bot": false,
  "photos": [
    {
      "id": "photo_001",
      "dcId": "2",
      "date": "2025-01-15T12:00:00Z",
      "url": "https://t.me/i/userpic/123456789/photo_001.jpg"
    },
    {
      "id": "photo_002",
      "dcId": "2",
      "date": "2025-02-20T14:00:00Z",
      "url": "https://t.me/i/userpic/123456789/photo_002.jpg"
    }
  ],
  "status": "success",
  "error": null
}

🔌 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-username-photos → map a trigger field (e.g. a username column in a spreadsheet) to username → send the output (photo URLs, metadata) back to Sheets or a Drive folder. Docs
• Make: add the Apify → Run an Actor module, select this Actor, set "Run synchronously" to Yes, then chain a Get Dataset Items module to pull results into your scenario. Docs

Example: new username added to a verification queue → scenario runs this Actor → profile photo history gets attached to the record for manual review.

🤖 Use with AI agents (MCP)

This Actor works as a tool in Claude, ChatGPT, Cursor, and other MCP clients through the Apify MCP server. Add this server URL to your client:

https://mcp.apify.com?tools=akula.marketing/telegram-get-username-photos

The first time you connect, the client asks you to sign in to Apify. Runs are billed to your Apify account, the same as runs from the Console.

Then ask in plain language, for example: "Get the profile photos of Telegram user @durov and tell me when each one was uploaded". The agent reads the input schema, fills in the fields, and gets the results back as structured data.

🧩 Related Actors

Next step	Actor
Check a whole list of usernames in one run	Telegram Username Checker
Find the Telegram account behind a phone number	Telegram Phone Number Lookup

Support

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

⭐ Found this useful? Leave a review — it helps others find this Actor and tells us what to build next.

🏷️ Find This Tool When You Search For "telegram profile picture downloader" - Get the public profile photos of a username "telegram avatar downloader" - Avatars for your CRM or contact list "telegram user metadata lookup" - Get name, status, and premium flags by username "telegram bot detector" - Identify automated accounts and bots 🛡️ Check that an account looks real before you do business with it