# Telegram Profile (`truefetch/telegram-profile`) Actor Bulk-look up Telegram users, bots, channels, or groups โ€” Premium status, verification badge, member count, privacy tier, and 14 entity-type fields. Up to 1,000 per run. - **URL**: https://apify.com/truefetch/telegram-profile.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (community) - **Categories:** Social media, News, Videos - **Stats:** 653 total users, 125 monthly users, 100.0% runs succeeded, 15 bookmarks - **User rating**: 3.84 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![Telegram Profile](https://img.shields.io/badge/Telegram%20Profile-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) [![Telegram Profile Scraper](https://img.shields.io/badge/Telegram%20Profile%20Scraper-1F8A70?style=for-the-badge)](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) [![Users & Channels](https://img.shields.io/badge/Users%20%7C%20Channels%20%7C%20Groups-555555?style=for-the-badge)](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) [![Verification, Stats & Business](https://img.shields.io/badge/Verification%20%7C%20Stats%20%7C%20Business-2E8B57?style=for-the-badge)](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## 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 TrueFetch 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](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) 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 ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~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](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/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"]` | ```json { "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 ```json { "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](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) 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 TrueFetch) | | 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 TrueFetch. 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](https://docs.apify.com/platform/schedules?fpr=aiagentapi)). - **Webhooks** โ€” POST results to your endpoint on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)). - **Apify API** โ€” `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)). - **MCP Server** โ€” call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)). - **No-code** โ€” Make, Zapier, n8n, Pipedream, Google Sheets, Airtable. *** ### ๐Ÿงฑ Sister Actors from TrueFetch #### Jobs - [Best Job Search](https://apify.com/TrueFetch/best-job-search?fpr=aiagentapi) - [Glassdoor Job Search](https://apify.com/TrueFetch/glassdoor-job-search?fpr=aiagentapi) - [Glints Company Finder](https://apify.com/TrueFetch/glints-company-finder?fpr=aiagentapi) - [Glints Job Finder](https://apify.com/TrueFetch/glints-job-finder?fpr=aiagentapi) - [Indeed Job Search](https://apify.com/TrueFetch/indeed-job-search?fpr=aiagentapi) - [JobStreet Company Finder](https://apify.com/TrueFetch/jobstreet-company-finder?fpr=aiagentapi) - [JobStreet Job Finder](https://apify.com/TrueFetch/jobstreet-job-finder?fpr=aiagentapi) - [LinkedIn Job Search](https://apify.com/TrueFetch/linkedin-job-search?fpr=aiagentapi) - [StepStone Company Finder](https://apify.com/TrueFetch/stepstone-company-finder?fpr=aiagentapi) - [StepStone Job Finder](https://apify.com/TrueFetch/stepstone-job-finder?fpr=aiagentapi) #### Shopping & Deals - [Amazon Deals Scraper](https://apify.com/TrueFetch/amazon-deals-scraper?fpr=aiagentapi) - [Amazon Store Finder](https://apify.com/TrueFetch/amazon-store-finder?fpr=aiagentapi) - [Argos Deals Scraper](https://apify.com/TrueFetch/argos-deals-scraper?fpr=aiagentapi) - [ASOS Fashion Scraper](https://apify.com/TrueFetch/asos-fashion-scraper?fpr=aiagentapi) - [eBay Deals Scraper](https://apify.com/TrueFetch/ebay-deals-scraper?fpr=aiagentapi) - [eBay Seller Finder](https://apify.com/TrueFetch/ebay-seller-finder?fpr=aiagentapi) - [Flipkart Deals Scraper](https://apify.com/TrueFetch/flipkart-deals-scraper?fpr=aiagentapi) - [John Lewis Deals Scraper](https://apify.com/TrueFetch/john-lewis-deals-scraper?fpr=aiagentapi) - [Lidl Deals Scraper](https://apify.com/TrueFetch/lidl-deals-scraper?fpr=aiagentapi) - [Magalu Deals Scraper](https://apify.com/TrueFetch/magalu-deals-scraper?fpr=aiagentapi) - [MediaMarkt Deals Scraper](https://apify.com/TrueFetch/mediamarkt-deals-scraper?fpr=aiagentapi) - [Mercado Livre Deals Scraper](https://apify.com/TrueFetch/mercado-livre-deals-scraper?fpr=aiagentapi) - [Nykaa Beauty Scraper](https://apify.com/TrueFetch/nykaa-beauty-scraper?fpr=aiagentapi) - [OTTO Deals Scraper](https://apify.com/TrueFetch/otto-deals-scraper?fpr=aiagentapi) - [Target Deals Scraper](https://apify.com/TrueFetch/target-deals-scraper?fpr=aiagentapi) - [TradeIndia Product Finder](https://apify.com/TrueFetch/tradeindia-product-finder?fpr=aiagentapi) - [TradeIndia Supplier Finder](https://apify.com/TrueFetch/tradeindia-supplier-finder?fpr=aiagentapi) - [Walmart Deals Scraper](https://apify.com/TrueFetch/walmart-deals-scraper?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Finder](https://apify.com/TrueFetch/autotrader-car-finder?fpr=aiagentapi) - [AutoTrader Dealer Finder](https://apify.com/TrueFetch/autotrader-dealer-finder?fpr=aiagentapi) - [Cars.com Car Finder](https://apify.com/TrueFetch/carscom-car-finder?fpr=aiagentapi) - [Cars.com Dealer Finder](https://apify.com/TrueFetch/carscom-dealer-finder?fpr=aiagentapi) - [Webmotors Car Finder](https://apify.com/TrueFetch/webmotors-car-finder?fpr=aiagentapi) #### Real Estate - [MagicBricks Builder Finder](https://apify.com/TrueFetch/magicbricks-builder-finder?fpr=aiagentapi) - [MagicBricks Home Finder](https://apify.com/TrueFetch/magicbricks-home-finder?fpr=aiagentapi) - [US Real Estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi) - [Zillow Real Estate](https://apify.com/TrueFetch/zillow-real-estate?fpr=aiagentapi) #### Local Business & Food - [BBB Business Finder](https://apify.com/TrueFetch/bbb-business-finder?fpr=aiagentapi) - [BBB Review Checker](https://apify.com/TrueFetch/bbb-review-checker?fpr=aiagentapi) - [Google Business Profile](https://apify.com/TrueFetch/google-business-profile?fpr=aiagentapi) - [Reclame Aqui Company Finder](https://apify.com/TrueFetch/reclame-aqui-company-finder?fpr=aiagentapi) - [Zomato Menu Checker](https://apify.com/TrueFetch/zomato-menu-checker?fpr=aiagentapi) - [Zomato Restaurant Finder](https://apify.com/TrueFetch/zomato-restaurant-finder?fpr=aiagentapi) #### Classifieds - [Kleinanzeigen Listing Finder](https://apify.com/TrueFetch/kleinanzeigen-listing-finder?fpr=aiagentapi) - [Kleinanzeigen Seller Finder](https://apify.com/TrueFetch/kleinanzeigen-seller-finder?fpr=aiagentapi) - [OLX Listing Finder](https://apify.com/TrueFetch/olx-listing-finder?fpr=aiagentapi) - [OLX Seller Finder](https://apify.com/TrueFetch/olx-seller-finder?fpr=aiagentapi) #### Social Media - [Find Any Company On LinkedIn](https://apify.com/TrueFetch/find-any-company-on-linkedin?fpr=aiagentapi) - [Find Anyone On LinkedIn](https://apify.com/TrueFetch/find-anyone-on-linkedin?fpr=aiagentapi) - [Instagram Explore](https://apify.com/TrueFetch/instagram-explore?fpr=aiagentapi) - [Instagram Post](https://apify.com/TrueFetch/instagram-post?fpr=aiagentapi) - [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi) - [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) - [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi) - [Reddit Community User](https://apify.com/TrueFetch/reddit-community-user?fpr=aiagentapi) - [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) - [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi) - [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi) - [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) - [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) - [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) - [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi) - [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi) #### Videos & Text - [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi) - [Instagram To Text](https://apify.com/TrueFetch/instagram-to-text?fpr=aiagentapi) - [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) - [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi) - [TikTok Video Lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) - [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi) - [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi) - [YouTube Niche Scraper](https://apify.com/TrueFetch/youtube-niche-scraper?fpr=aiagentapi) - [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi) #### Content & Articles - [Medium Article Finder](https://apify.com/TrueFetch/medium-article-finder?fpr=aiagentapi) - [Medium Writer Finder](https://apify.com/TrueFetch/medium-writer-finder?fpr=aiagentapi) *** ### ๐Ÿ“ž Support, changelog, last updated #### Support - ๐Ÿ’ฌ **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - ๐Ÿ“ง **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - ๐Ÿ“– **Actor page & docs:** [apify.com/TrueFetch/telegram-profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **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](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi). #### 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. *** ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/TrueFetch/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/TrueFetch/telegram-profile", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" }, "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch", "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 TrueFetch. 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/TrueFetch/telegram-profile" } ] } ] } ``` *** **Last Updated:** May 2, 2026 **Schema version:** 1.1 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) ยท ๐Ÿ’ฌ [Telegram Group](https://t.me/Apify_Actor) ยท ๐Ÿ“ง [Support](https://t.me/AiAgentApi) # Actor input Schema ## `telegram_url` (type: `array`): Enter up to 1000 Telegram targets to inspect. Supports usernames, @usernames, and common t.me profile links. ## Actor input object example ```json { "telegram_url": [ "AiAgentApi", "@BotFather", "t.me/telegram", "binanceexchange", "https://t.me/Apify_Actor" ] } ``` # Actor output Schema ## `results` (type: `string`): Telegram profile records for users, bots, channels, and groups with identity details, verification status, and metadata. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "telegram_url": [ "AiAgentApi", "@BotFather", "t.me/telegram", "binanceexchange", "https://t.me/Apify_Actor" ] }; // Run the Actor and wait for it to finish const run = await client.actor("truefetch/telegram-profile").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "telegram_url": [ "AiAgentApi", "@BotFather", "t.me/telegram", "binanceexchange", "https://t.me/Apify_Actor", ] } # Run the Actor and wait for it to finish run = client.actor("truefetch/telegram-profile").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "telegram_url": [ "AiAgentApi", "@BotFather", "t.me/telegram", "binanceexchange", "https://t.me/Apify_Actor" ] }' | apify call truefetch/telegram-profile --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/telegram-profile", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Telegram Profile", "description": "Bulk-look up Telegram users, bots, channels, or groups โ€” Premium status, verification badge, member count, privacy tier, and 14 entity-type fields. Up to 1,000 per run.", "version": "1.0", "x-build-id": "IAKAJXI8FDbCZGHrR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~telegram-profile/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-telegram-profile", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/truefetch~telegram-profile/runs": { "post": { "operationId": "runs-sync-truefetch-telegram-profile", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/truefetch~telegram-profile/run-sync": { "post": { "operationId": "run-sync-truefetch-telegram-profile", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "telegram_url" ], "properties": { "telegram_url": { "title": "Telegram URL", "minItems": 1, "maxItems": 1000, "type": "array", "description": "Enter up to 1000 Telegram targets to inspect. Supports usernames, @usernames, and common t.me profile links.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```