Telegram Get Username Photos

Actor retrieves profile photos and detailed Telegram user information based on a provided username. It fetches data such as Telegram ID, username, first/last name, about, status, last online timestamp, language code, premium status, blocked status, bot status, and a list of profile photos.

📥 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.

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
}

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