Telegram Phone Number Lookup

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

Telegram Phone Number Lookup 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 contact verification and CRM enrichment: you already have a customer's or contact's number and want to know if they're reachable on Telegram.

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 1 free lookup on this Actor (temporarily reduced to prevent high-volume abuse) 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.

📊 Output fields (15)

registered, phone, id, username, firstName, lastName, about, photo, state, wasOnline, langCode, premium, blocked, bot, error. Details are in Output.

🛡️ Data & compliance

• Public profile only. The Actor returns the same fields you'd see after adding the number as a contact in the Telegram app. Hidden fields stay hidden: if the account's privacy settings hide the photo, photo is null.
• Numbers you have a reason to check. Look up your own customers' and contacts' numbers, for example before a CRM import. Don't use it to identify strangers.
• 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.
• No credentials from you. The Actor never asks for your Telegram login, phone, session, or API keys. Output contains no access hashes, file references, or session data.

💳 What you pay for

• Billed: compute time of the run (pay-per-usage, see Pricing). A number that isn't on Telegram is a normal result: "registered": false.
• Not billed: a run with no phone, and lookups that fail (timeout, Telegram error, invalid response). These end with a message in the run log and no dataset row.

🚫 What this Actor doesn't do

• Checks one number per run. For 500–10,000 numbers use Telegram Bulk Phone Number Checker.
• Doesn't look up usernames. For those use Telegram Username Checker.
• Doesn't reveal fields hidden by privacy settings, and doesn't read messages or contacts.

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 with this Actor: it accepts a single phone per run. For lists of 500–10,000 numbers, use Telegram Bulk Phone Number Checker. It checks registration only, without profiles, at 1/10 of the price per number (needs a paid Apify plan). For smaller lists, run this Actor once per number via the Apify API, Make, or Zapier.

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
• 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

🔌 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-phone-info → map a trigger field (e.g. a new contact in your CRM) to phone → send the output back to your CRM or a spreadsheet. 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 lead added to your CRM → scenario runs this Actor on their phone number → Telegram username and Premium status get written back to the lead record.

🤖 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-phone-info

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: "Check if +15175051136 is on Telegram and give me the username". The agent reads the input schema, fills in the fields, and gets the results back as structured data.

🧩 Related Actors

Next step	Actor
Check 500–10,000 numbers for Telegram in one run	Telegram Bulk Phone Number Checker
Check which numbers are on WhatsApp	WhatsApp Bulk Phone Number Checker
Get the full profile photo history of the account you found	Telegram Profile Photo Scraper

Support

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

⭐ 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 phone number lookup" - Resolve a phone number to a Telegram account "check if phone number has telegram" - Verify Telegram registration before outreach "find telegram username by phone number" - Resolve contacts from a phone list "telegram phone verification api" - Bulk-verify contact lists programmatically "telegram lead verification" - Confirm real contacts before a CRM import "telegram scam checker phone" - Spot bot and fake accounts by number "telegram premium status checker" - Detect Premium accounts from a phone "crm phone enrichment telegram" - Enrich lead lists with Telegram data 🎯 Turn a phone number into a verified Telegram identity in one call 🛡️ Clean your contact list before you reach out