Telegram Get Phone Info

Telegram Get Phone Info checks whether a phone number is registered on Telegram and returns the linked account's public profile — username, name, profile photo, premium and bot status, and last-seen state. It's built for lead verification, CRM enrichment, and OSINT investigations where you already have a phone number and need to confirm the identity behind it.

What can this Actor do?

• Verify in one call whether a phone number is registered on Telegram
• Resolve a phone number to a Telegram username
• Retrieve profile details: first/last name, bio ("about"), profile photo, language code
• Detect account flags: premium, bot, and blocked status
• Return a structured JSON result ready for CRM or spreadsheet import

How it works

1. Provide a phone number in international format (e.g. +15175051136).
2. The Actor queries Telegram's public account-lookup method for that number.
3. It returns one dataset item with the account details, or "registered": false if the number isn't on Telegram.

{ "phone": "254746002717" }

Input

Field	Type	Required	Description
phone	String	Yes	Phone number in international format, with or without a leading + (e.g. +1234567890 or 1234567890).

Output

Each run pushes a single dataset item:

Field	Type	Description
registered	Boolean	Whether the phone number is registered on Telegram
phone	String	The phone number that was checked
id	String	Telegram user ID
username	String	Telegram @username, if set
firstName / lastName	String	Account display name
about	String	Bio / "about" text
photo	String	Profile photo (if public)
state	String	Account status
wasOnline	String	Last-seen timestamp
langCode	String	Account language code
premium	Boolean	Telegram Premium status
blocked	Boolean	Whether the account is blocked
bot	Boolean	Whether the account is a bot
status / error	String	"success" or "failed", with an error message if the lookup failed

Example output

{
  "phone": "254746002717",
  "registered": true,
  "id": "123456789",
  "username": "example_user",
  "firstName": "Jane",
  "lastName": "Doe",
  "about": "Marketing lead",
  "photo": "https://...",
  "state": "recently",
  "wasOnline": "2026-07-01T10:00:00Z",
  "langCode": "en",
  "premium": false,
  "blocked": false,
  "bot": false,
  "status": "success",
  "error": null
}

Pricing

This Actor runs on the Apify Pay-Per-Usage model — you pay only for the compute time of your runs, no separate license fee. Each Apify account gets 3 free lookups on this Actor to try it out before consuming platform credits.

If you hit a ReadTimeout, increase the Actor's run timeout to 60 seconds in Run → Input and options.

Is it legal to look up a Telegram phone number?

This Actor only reads public Telegram profile data (the same fields visible when you add a number as a contact in the Telegram app). You're responsible for complying with applicable privacy law (e.g. GDPR) and Telegram's Terms of Service in your jurisdiction — only look up numbers you have a legitimate reason to check, such as lead verification or your own investigations.

FAQ

What happens if the number isn't on Telegram?

The Actor returns one item with "registered": false and the other profile fields set to null — it does not fail the run.

Why does my run fail with a timeout?

Telegram lookups occasionally take longer than the default limit. Increase the Actor's timeout to 60 seconds and re-run.

Can I check multiple phone numbers in one run?

Not yet — this Actor accepts a single phone per run. To check a list, run it once per number, e.g. via the Apify API or a saved Task per number.

Is the profile photo always returned?

Only if the account's privacy settings make it public. Otherwise photo is null.

Published examples

Ready-to-run tasks with pre-filled inputs:

• Check if a phone number is registered on Telegram
• Find Telegram username from phone number
• Telegram phone lookup for OSINT investigations
• Detect if a Telegram account is a bot by phone
• Check Telegram phone for scam and fake account signals

All phone examples · Need a full export? akula.marketing

Support

24/7 support via @KoteamSupport. We also build custom Telegram data solutions — reach out if this Actor doesn't cover your use case.