Affiliate disclosure: Apify links on this page may include referral parameters. If you sign up through one of these links, CheapGET may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected.

Telegram Profile — Telegram Profile Scraper: Users, Channels & Groups

Provide a list of Telegram URLs and extract full structured profiles for users, bots, channels, and groups — covering verification, member count, business info, last seen, bot commands, and more in clean JSON / CSV / Excel.

TL;DR (40-word answer): Telegram Profile is a credentials-based Apify Actor that returns detailed profile metadata for Telegram users, bots, channels, and groups from a list of up to 1,000 targets, covering verification, member count, business info, and bot commands per lookup. Last verified 2026-05-02.

What it is NOT: Telegram Profile is not a message scraper, not a member list extractor, and not a private profile snooper — it fetches publicly visible metadata about Telegram entities via the Telegram API.

Telegram Profile is an Apify Actor that extracts full profile metadata for Telegram users, bots, channels, and groups from a list of targets. Maintained by CheapGET on the Apify Store.

---

🏷️ Why choose Telegram Profile

Telegram Profile is best for researchers, analysts, and developers who need structured profile data for multiple Telegram entities at once for enrichment, verification, or competitive analysis.

• 📊 Rich user & channel fields — verification, premium status, member count, admin count, bot commands, business hours/location, birthday, and more.
• 🔁 Batch lookup — provide up to 1,000 Telegram targets per run (URLs, usernames, or @handles).
• 💰 Compute-based pricing — pay only for compute used (no per-result charge); free plan includes $5 monthly credits.

---

🚀 Quick Start — run in 3 steps

Run in Apify Console

1. Open the Actor — go to Telegram Profile on Apify and click Try for free.
2. Configure inputs — provide a list of Telegram target URLs/usernames (up to 1,000).
3. Click Start — the Actor returns structured profiles in the default dataset; download as JSON, CSV, or Excel.

Run via Apify API

curl -X POST "https://api.apify.com/v2/acts/cheapget~telegram-profile/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "telegram_url": ["https://t.me/telegram", "@BotFather", "AiAgentApi"]
  }'

Run via MCP (for AI agents)

Telegram Profile is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the Apify MCP Server. Reference the Actor as cheapget/telegram-profile and pass the same JSON input as above.

---

⚙️ Input parameters

Parameter	Type	Required	Default	Description	Example
telegram_url	array	✅	—	List of Telegram targets (1–1,000 items). Each item may be a URL, username, or @handle.	["https://t.me/telegram", "@BotFather"]

{
  "telegram_url": ["https://t.me/telegram", "@BotFather", "AiAgentApi"]
}

---

📦 Output dataset

Each run writes structured profile records to the default Apify dataset, exportable as JSON, JSONL, CSV, Excel, XML, RSS, or via the dataset API.

User / Bot profile fields

Field	Type	Always present?	Description	Example
type	string	optional	user or bot.	user
id	integer	optional	Telegram user ID.	123456789
usernames	array	optional	List of usernames.	["johndoe"]
first_name	string	optional	First name.	John
last_name	string	optional	Last name.	Doe
phone	string	optional	Phone number if visible.	+44123456789
is_premium	boolean	optional	Has Telegram Premium.	false
is_verified	boolean	optional	Verified by Telegram.	true
is_scam	boolean	optional	Marked as scam.	false
is_fake	boolean	optional	Marked as fake.	false
last_seen	string	optional	Last seen status or ISO 8601 timestamp.	recently
description	string	optional	Profile bio.	Tech enthusiast.
bot_commands	array	optional	Bot commands list (bots only).	["/start - Start the bot"]
business_hours	object	optional	Business opening hours (if set).	{"open_now": true, ...}
business_location	object	optional	Business location (if set).	{"address": "London, UK"}
birthday	object	optional	Birthday (if set).	{"day": 1, "month": 6}
stargifts_count	integer	optional	Number of star gifts received.	5

Channel / Group profile fields

Field	Type	Always present?	Description	Example
title	string	optional	Channel or group title.	News Channel
type	string	optional	channel, supergroup, or group.	channel
usernames	array	optional	Public usernames.	["mychannel"]
is_verified	boolean	optional	Verified by Telegram.	false
member_count	integer	optional	Total member/subscriber count.	150000
online_count	integer	optional	Currently online members.	3200
admins_count	integer	optional	Number of admins.	5
description	string	optional	Channel description/bio.	Daily news.
created_date	string	optional	Creation date (ISO 8601).	2021-01-01T00:00:00
location	object	optional	Geo location if set.	{"address": "Moscow"}

Sample output

{
  "type": "channel",
  "title": "Example Channel",
  "member_count": 150000,
  "is_verified": false,
  "description": "Daily tech updates."
}

---

💡 Use cases

For researchers profiling Telegram channels and groups

• Problem: a research team needs profile metadata (member count, verification, description) for 200 Telegram channels.
• How Telegram Profile solves it: provide all 200 URLs in a single run and receive structured channel profiles.
• Outcome: 200 channel profiles in one API call — no manual lookups.

For developers enriching databases with Telegram entity data

• Problem: a database contains Telegram usernames and needs structured metadata appended to each record.
• How Telegram Profile solves it: pass all usernames in telegram_url and integrate the returned structured profiles into the database.
• Outcome: enriched database with verification, member count, and description for every Telegram entity.

For AI agents answering questions about Telegram entities

• Problem: LLM agents asked "is this Telegram channel verified?" cannot answer from stale training data.
• How Telegram Profile solves it: call the Actor over the Apify MCP Server to retrieve live profile data on demand.
• Outcome: grounded Telegram profile data in production AI assistants.

---

💰 Pricing, limits, and performance

Fact	Value
Pricing model	Compute-based (pay for actor usage, not per result)
Free-tier monthly allowance	$5 Apify credits included
Max targets per run	1,000 (10 for free/unverified users)
Login / cookies required	Telegram API credentials required (provided by CheapGET)
Export formats	JSON, JSONL, CSV, Excel, XML, RSS, dataset API

---

⚖️ Compared with alternatives

Capability	Telegram Profile	Telegram Bot API	Custom Telethon script
Full user + channel + group profile metadata	✅	limited	you build & maintain
Batch 1,000 targets per run	✅	❌	you implement
Export to CSV / JSON	✅	❌	you implement
Setup time to first result	< 60 seconds	hours–days	days–weeks

Verdict. Telegram Profile is ideal for analysts and developers who need structured profile metadata for multiple Telegram entities without setting up Telethon infrastructure.

---

⚠️ Common mistakes to avoid

1. Missing telegram_url. This field is required and must be a list.
2. Providing more than 1,000 targets. Maximum is 1,000 per run; split large lists across multiple runs.
3. Targeting private accounts. Only publicly accessible profiles are returned.
4. Providing an empty list. The list must contain at least one target.

---

🛠️ Troubleshooting

Problem	Likely cause	Fix
Missing required input: telegram_url	telegram_url not provided.	Add "telegram_url": ["@username"] to your input JSON.
telegram_url must contain at least one...	Empty list provided.	Provide at least one valid Telegram target in the list.
telegram_url supports up to 1000 targets	List exceeds 1,000 items.	Split targets into multiple runs of up to 1,000.
Charge limit reached	Account-level monthly spend limit hit.	Raise the run / monthly limit in your Apify plan settings.

---

❓ FAQ

What types of Telegram entities does Telegram Profile support?

Telegram Profile supports users, bots, channels, supergroups, and regular groups. Each entity type returns a tailored set of fields.

How do I provide targets?

Pass a JSON array of strings in telegram_url. Each string may be a full URL (https://t.me/example), an @handle, or a bare username.

Is there a limit per run?

Yes — 1,000 targets per run for paying users, 10 for free/unverified users.

Does Telegram Profile require a Telegram account?

The Actor uses Telegram API credentials managed by CheapGET. You do not need to provide your own Telegram account.

---

🔌 Integrations

Telegram Profile plugs straight into the Apify ecosystem:

• Schedules — monitor profiles on a recurring schedule (docs).
• Webhooks — POST results to your endpoint on ACTOR.RUN.SUCCEEDED (docs).
• Apify API — run-sync-get-dataset-items for blocking calls, runs for async (docs).
• MCP Server — call the Actor from Claude, ChatGPT, or Cursor agents (docs).
• No-code — Make, Zapier, n8n, Pipedream, Google Sheets, Airtable.

---

🧱 Sister Actors from CheapGET

Jobs

• Best Job Search
• Glassdoor Job Search
• Glints Company Finder
• Glints Job Finder
• Indeed Job Search
• JobStreet Company Finder
• JobStreet Job Finder
• LinkedIn Job Search
• StepStone Company Finder
• StepStone Job Finder

Shopping & Deals

• Amazon Deals Scraper
• Amazon Store Finder
• Argos Deals Scraper
• ASOS Fashion Scraper
• eBay Deals Scraper
• eBay Seller Finder
• Flipkart Deals Scraper
• John Lewis Deals Scraper
• Lidl Deals Scraper
• Magalu Deals Scraper
• MediaMarkt Deals Scraper
• Mercado Livre Deals Scraper
• Nykaa Beauty Scraper
• OTTO Deals Scraper
• Target Deals Scraper
• TradeIndia Product Finder
• TradeIndia Supplier Finder
• Walmart Deals Scraper

Vehicles

• AutoTrader Car Finder
• AutoTrader Dealer Finder
• Cars.com Car Finder
• Cars.com Dealer Finder
• Webmotors Car Finder

Real Estate

• MagicBricks Builder Finder
• MagicBricks Home Finder
• US Real Estate
• Zillow Real Estate

Local Business & Food

• BBB Business Finder
• BBB Review Checker
• Google Business Profile
• Reclame Aqui Company Finder
• Zomato Menu Checker
• Zomato Restaurant Finder

Classifieds

• Kleinanzeigen Listing Finder
• Kleinanzeigen Seller Finder
• OLX Listing Finder
• OLX Seller Finder

Social Media

• Find Any Company On LinkedIn
• Find Anyone On LinkedIn
• Instagram Explore
• Instagram Post
• Instagram Profile
• Reddit Community Post
• Reddit Community Profile
• Reddit Community User
• Reddit Post Search
• Reddit User Profile
• Social Media Marketing
• Telegram Channel Message
• Telegram Group Member
• Telegram Profile
• X Community Profile
• X User Profile

Videos & Text

• Best Video Downloader
• Instagram To Text
• TikTok Live Recorder
• TikTok Video Downloader
• TikTok Video Lookup
• Video Subtitles Downloader
• Video To Text
• YouTube Niche Scraper
• YouTube Video Downloader

Content & Articles

• Medium Article Finder
• Medium Writer Finder

---

📞 Support, changelog, last updated

Support

• 💬 Telegram Group: t.me/Apify_Actor
• 📧 Direct support: t.me/AiAgentApi
• 📖 Actor page & docs: apify.com/cheapget/telegram-profile

Maintained by CheapGET on the Apify Store.

Cost of doing nothing: manually looking up profile metadata for 500 Telegram entities takes hours. Telegram Profile returns structured data for 500 entities in a single API call. → Try it free with $5 of Apify credits.

Changelog

• 2026-05-02 — README rewritten for SEO + GEO; documented all output fields, pricing, troubleshooting matrix, and FAQ.
• 2026-04 — Added business hours, business location, and star gifts support.
• 2026-02 — Initial release: Telegram profile scraper.

---

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "SoftwareApplication",
      "@id": "https://apify.com/cheapget/telegram-profile#software",
      "name": "Telegram Profile",
      "description": "Apify Actor that extracts full profile metadata for Telegram users, bots, channels, and groups from a list of up to 1,000 targets.",
      "applicationCategory": "BusinessApplication",
      "operatingSystem": "Web, Cloud",
      "url": "https://apify.com/cheapget/telegram-profile",
      "offers": {
        "@type": "Offer",
        "price": "0",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      },
      "author": { "@id": "https://apify.com/cheapget#author-cheapget" },
      "publisher": { "@id": "https://apify.com/cheapget#publisher" }
    },
    {
      "@type": "Organization",
      "@id": "https://apify.com/cheapget#publisher",
      "name": "CheapGET",
      "url": "https://apify.com/cheapget",
      "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"]
    },
    {
      "@type": "FAQPage",
      "mainEntity": [
        {
          "@type": "Question",
          "name": "What types of Telegram entities does Telegram Profile support?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "Telegram Profile supports users, bots, channels, supergroups, and regular groups. Each entity type returns a tailored set of fields."
          }
        },
        {
          "@type": "Question",
          "name": "How many targets can I look up per run?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "Up to 1,000 targets per run for paying users. Free/unverified users are limited to 10 per run."
          }
        },
        {
          "@type": "Question",
          "name": "Does Telegram Profile require a Telegram account?",
          "acceptedAnswer": {
            "@type": "Answer",
            "text": "No. The Actor uses Telegram API credentials managed by CheapGET. You do not need to provide your own account."
          }
        }
      ]
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Apify",
          "item": "https://apify.com"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Social Media",
          "item": "https://apify.com/store?category=SOCIAL_MEDIA"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "Telegram Profile",
          "item": "https://apify.com/cheapget/telegram-profile"
        }
      ]
    }
  ]
}

---

Last Updated: May 2, 2026 Schema version: 1.1 Maintained by: CheapGET · 💬 Telegram Group · 📧 Support