Fetch a Telegram user's profile photo. Two-step flow: first call Check Telegram Peer Exists to obtain a userHash for the target peer, then pass that userHash here. Calls without a valid (or expired/unknown) userHash are rejected without hitting the upstream. The peer is resolved from the userHash server-side — no peer parameter is accepted. Telegram photos have no public URL, so the photo is returned base64-encoded with its MIME type (image/jpeg) — decode the data field to get the image bytes. pictureSet=false means the user has no photo or hides it by privacy settings. If the peer does not exist, exists=false and reason explains why.

API Features

Profile photo download Receive the avatar bytes base64-encoded with MIME type — no expiring URL to manage

Gateway-validated userHash Invalid or expired tokens are rejected before any upstream call, keeping usage predictable

Privacy-aware Clear pictureSet flag when the photo is hidden by privacy or not set

Live API Demo

GET /api/project/telegram/get-picture

API Response (JSON)

{}

📢

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 support or sales tools before a conversation
Archive or diff profile photos over time

View Subscription Plans →

Get Profile Photo (Avatar)

API Features

Live API Demo

API Response (JSON)

Use Cases