Get a Peer's Profile Picture
View All Telegram Messaging API APIs →Download a peer's profile picture and return it base64-encoded with its MIME type. Pass the peer (@username or +phone) in the path. Returns exists=false when the peer has no picture. Uses a connected session for a live lookup.
API Features
Base64 image Receive the avatar bytes directly, ready to store or re-serve
Honest negatives exists=false when the peer has no picture
Real-time lookup Downloads the current picture live through your connected session
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
GET
/api/project/telegram-messaging/contact-picture API Response (JSON)
{} Query Result
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Use Cases
- Enrich CRM contacts with Telegram profile photos
- Show avatars in a support or sales UI before a conversation
- Detect avatar changes for profile-freshness signals