# Telegram Info Scraper (`agentx/telegram-info-scraper`) Actor

Bulk-resolve up to 1,000 Telegram identifiers in one call — mix usernames, @handles, and t.me URLs covering users, bots, channels, supergroups, and groups. Each result returns the canonical entity record with ID, type, title or first/last name, listed phone, scam/fake/verified flags, and members.

- **URL**: https://apify.com/agentx/telegram-info-scraper.md
- **Developed by:** [AgentX](https://apify.com/agentx) (community)
- **Categories:** Social media, MCP servers, Agents
- **Stats:** 729 total users, 32 monthly users, 100.0% runs succeeded, 6 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.02 / actor start

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Telegram Info Scraper - Telegram Profile Intelligence API

**Telegram Info Scraper is a Telegram profile intelligence API that extracts 30+ structured fields per entity — users, bots, channels, groups, and supergroups — in a single target-list-driven run, with no Telegram account required.** Telegram Info Scraper returns structured records per entity, including entity type, entity ID, username, display name, member count, phone number, premium flag, scam flag, fake flag, verification status, language code, bot capabilities (active users, main app, business flags), profile photo URL, about/bio text, restriction reasons array, and access hash. Coverage spans all public Telegram entities globally with bulk lookup of up to 1,000 targets per run. Built for KYC enrichment, lead qualification, community research, abuse monitoring, fraud screening, brand-impersonation detection, and B2B Telegram-channel-discovery pipelines. Per-entity pay-per-result pricing at $0.0051 with no monthly minimum.

[![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi) [![Profile Intelligence](https://img.shields.io/badge/Profile_Intelligence-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi) [![Entity Enrichment](https://img.shields.io/badge/Entity_Enrichment-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi)

---

### Why Choose This API

#### Structured Telegram Entity Data for B2B Intelligence Pipelines

**🔍 Multi-Entity Type Support**
Single input list — processes users, bots, channels, groups, and supergroups — returning entity type per record via the `type` field: `user`, `bot`, `channel`, `supergroup`, or `group`. Enables mixed-entity bulk enrichment without separate workflows.

**🛡️ Scam & Verification Signals**
The `scam`, `fake`, `verified`, and `restricted` flags deliver per-entity trust signals — enabling fraud detection pipelines, influencer verification, and entity legitimacy scoring for KYC and abuse-monitoring workflows.

**📊 Bulk Lookup — Up to 1,000 Targets**
The `telegram_url` array accepts up to 1,000 entries per run — enabling large-scale Telegram entity enrichment pipelines from CRM lists, member exports, and contact databases.

**🤖 Bot Intelligence Fields**
Bot-specific fields — `bot_active_users`, `bot_has_main_app`, `bot_attach_menu`, `bot_business`, `bot_nochats`, `bot_inline_placeholder` — deliver bot capability profiles for Telegram ecosystem mapping and bot intelligence research.

**📞 Phone Number Extraction**
The `phone` field captures publicly visible phone numbers for user entities — enabling cross-platform identity linkage and contact enrichment for lead qualification pipelines.

---

### Quick Start Guide

#### How to Extract Telegram Profile Intelligence in 3 Steps

##### Step 1: Compile Your Target List

Prepare up to 1,000 Telegram targets — plain usernames, `@username` handles, or `t.me/` profile URLs.

##### Step 2: Configure and Run

[Open Actor Input](https://console.apify.com/actors/lAybf7rRybdzabbBk/input?fpr=aiagentapi)

Paste your target list and click **Start**.

##### Step 3: Download Enriched Entity Profiles

Export as JSON or CSV, or access programmatically via the Apify dataset API.

---

### Input Parameters

#### Configuration Fields

| Parameter      | Type  | Required | Description                                                            | Example Values                                |
| -------------- | ----- | -------- | ---------------------------------------------------------------------- | --------------------------------------------- |
| `telegram_url` | array | ✅       | List of Telegram targets — username, @username, or t.me/ URL (1–1,000) | `["AiAgentApi", "@BotFather", "t.me/aipost"]` |

#### Example Input Configuration

```json
{
  "telegram_url": [
    "AiAgentApi",
    "@BotFather",
    "t.me/DatascienceChats",
    "aipost"
  ]
}
````

***

### Output Data Schema

#### Complete Entity Profile Record Structure

Each extracted Telegram entity record contains the following fields:

[Open Actor Output](https://console.apify.com/actors/lAybf7rRybdzabbBk/input?fpr=aiagentapi)

#### Core Entity Fields

| Field              | Type    | Description                                            |
| ------------------ | ------- | ------------------------------------------------------ |
| `processor`        | string  | Apify actor URL that processed this record             |
| `processed_at`     | string  | ISO 8601 timestamp (UTC) when scraped                  |
| `status`           | string  | Processing result (success / not found)                |
| `source_url`       | string  | Original input target URL                              |
| `photo_url`        | string  | Profile photo URL (stored in key-value store)          |
| `type`             | string  | Entity type: user / bot / channel / supergroup / group |
| `id`               | integer | Telegram entity unique identifier                      |
| `usernames`        | array   | All usernames associated with the entity               |
| `title`            | string  | Group or channel title                                 |
| `first_name`       | string  | User's first name (users/bots)                         |
| `last_name`        | string  | User's last name (users/bots)                          |
| `phone`            | string  | Phone number if publicly visible (users)               |
| `lang_code`        | string  | User language code                                     |
| `bot_active_users` | integer | Bot active user count estimate                         |
| `bot_has_main_app` | boolean | Bot has main app entry point                           |
| `bot_attach_menu`  | boolean | Bot supports attachment menu                           |
| `scam`             | boolean | Telegram scam flag                                     |
| `fake`             | boolean | Telegram fake account flag                             |
| `verified`         | boolean | Telegram verified entity flag                          |
| `restricted`       | boolean | Entity access restriction flag                         |

#### Example JSON Output

```json
{
  "processor": "https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi",
  "processed_at": "2026-05-01T10:30:00.000Z",
  "status": "success",
  "source_url": "https://t.me/AiAgentApi",
  "type": "channel",
  "id": 1234567890,
  "usernames": ["AiAgentApi"],
  "title": "Ai Agent API",
  "scam": false,
  "fake": false,
  "verified": false,
  "restricted": false
}
```

#### Export Formats

- **JSON** - Complete structured entity profile data
- **CSV** - Spreadsheet-compatible for enrichment workflows
- **API Access** - Programmatic access via Apify Client SDK
- **Cloud Storage** - Automatic upload to Apify Dataset

***

### Integration Examples

#### Actor ID for Platform Integration

```text
lAybf7rRybdzabbBk
```

#### Ⓜ️ [Make.com Setup:](https://www.make.com/en/register?pc=marketingme)

1. Login to **[Make.com (Get 1000 Free Credits)](https://www.make.com/en/register?pc=marketingme)**
2. Add module **"Run an Actor"**
3. Turn **'Map'** on - right side of the 'Actor\*'
4. Paste **Actor ID** - from above
5. Click the **'⟳ Refresh'** - left side of Map
6. **Input JSON\*** - Modify the parameters as needed
7. Set **"Run synchronously"** to **YES**
8. Add module **"Get Dataset Items"** - receive the result
9. In **Dataset ID\*** select **defaultDatasetId**

#### 🎱 [N8N.io Setup:](https://n8n.io/)

1. Add **'Run an Actor and get dataset'** - from the apify node
2. **Actor** → **By ID** → **Paste Actor ID** - from above
3. **Input JSON** - Modify the parameters as needed

#### Python Integration Example

```python
from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run_input = {
    "telegram_url": [
        "AiAgentApi",
        "@BotFather",
        "t.me/DatascienceChats"
    ]
}

run = client.actor("lAybf7rRybdzabbBk").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### JavaScript/Node.js Integration

```javascript
import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_API_TOKEN" });

const input = {
  telegram_url: ["aipost", "@somebot", "t.me/techcommunity"],
};

const run = await client.actor("lAybf7rRybdzabbBk").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

items.forEach((item) => console.log(item));
```

#### JSON-LD Metadata

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "SoftwareApplication",
      "@id": "https://apify.com/agentx/telegram-info-scraper#software",
      "name": "Telegram Info Scraper",
      "description": "Telegram Info Scraper is a Telegram profile intelligence API extracting 30+ fields per entity — users, bots, channels, groups — with scam detection, verification flags, bot capabilities, phone numbers, and member counts for KYC enrichment and abuse-monitoring pipelines.",
      "applicationCategory": "BusinessApplication",
      "applicationSubCategory": "Lead Generation API",
      "operatingSystem": "Web, Cloud",
      "url": "https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi",
      "softwareVersion": "1.0.0",
      "datePublished": "2024-08-01",
      "dateModified": "2026-05-01",
      "featureList": [
        "30+ fields per entity (user/bot/channel/group)",
        "Member count and phone number",
        "Scam, fake, and verification flags",
        "Premium and language code",
        "Bot capabilities (active users, main app, business)",
        "Bulk lookup up to 1,000 targets per run",
        "Per-entity pay-per-result at $0.0051",
        "Native integrations with Make.com, n8n, LangChain, and CrewAI"
      ],
      "offers": {
        "@type": "Offer",
        "price": "0.0051",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      },
      "author": { "@id": "https://apify.com/agentx#person" },
      "publisher": { "@id": "https://apify.com#organization" }
    },
    {
      "@type": "Person",
      "@id": "https://apify.com/agentx#person",
      "name": "AgentX",
      "url": "https://apify.com/agentx",
      "sameAs": [
        "https://apify.com/agentx",
        "https://t.me/AiAgentApi",
        "https://t.me/Apify_Actor"
      ],
      "knowsAbout": [
        "web scraping",
        "Telegram",
        "profile intelligence",
        "KYC enrichment",
        "abuse monitoring"
      ]
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Apify",
          "item": "https://apify.com"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "AgentX",
          "item": "https://apify.com/agentx"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "Telegram Info Scraper",
          "item": "https://apify.com/agentx/telegram-info-scraper"
        }
      ]
    }
  ]
}
```

***

### Pricing & Cost Calculator

#### Pay-Per-Result Pricing

| Event               | Rate                |
| ------------------- | ------------------- |
| Actor Start         | $0.02 per GB memory |
| Result (per entity) | $0.0051 (BRONZE)    |

#### Cost Calculator Examples

| Entities       | Estimated Cost |
| -------------- | -------------- |
| 10 entities    | ~$0.07         |
| 50 entities    | ~$0.28         |
| 100 entities   | ~$0.53         |
| 500 entities   | ~$2.58         |
| 1,000 entities | ~$5.13         |

***

### Use Cases & Applications

#### KYC & Lead Enrichment

**Telegram Lead Profile Enrichment**
Submit CRM contact usernames for bulk entity lookup — enriching lead profiles with entity type, verification status, member counts, phone numbers, and scam flags for lead qualification pipelines.

**Cross-Platform Identity Linkage**
Combine extracted phone numbers and usernames with [LinkedIn Profile Scraper](https://apify.com/agentx/linkedin-profile-scraper?fpr=aiagentapi) or [Twitter Info Scraper](https://apify.com/agentx/twitter-info-scraper?fpr=aiagentapi) — building cross-platform identity profiles for enterprise KYC and contact intelligence workflows.

#### Trust & Safety Research

**Scam and Fake Account Detection**
The `scam` and `fake` boolean flags per entity enable automated trust scoring — building entity legitimacy datasets, abuse detection models, and community trust monitoring pipelines.

**Bot Ecosystem Mapping**
Bot-specific fields (`bot_active_users`, `bot_has_main_app`, `bot_business`) enable Telegram bot intelligence — mapping the active bot ecosystem, identifying high-traffic bots, and classifying bot categories for platform research.

***

### FAQ

#### Can I mix users, bots, channels, and groups in the same input list?

Yes — the actor resolves each target individually and returns the correct entity type per record. No separate workflows are needed for different entity types.

#### How many targets can I process per run?

Up to 1,000 targets per run. For larger lists, split across multiple runs.

#### What formats are accepted in the `telegram_url` array?

Plain usernames (e.g., `aipost`), `@username` handles, and `t.me/` URL formats are all supported.

#### Does this require Telegram authentication?

No — this actor resolves Telegram entity metadata without any Telegram account or API credentials.

***

### SEO Keywords & Search Terms

#### Primary Keywords

Telegram profile intelligence API, Telegram entity scraper, Telegram info extractor, Telegram user profile API, Telegram channel metadata API, Telegram entity enrichment, Telegram scam detection API, Telegram KYC enrichment, Telegram lead profile API, Telegram bulk lookup API

#### Long-Tail Keywords

how to extract Telegram user profile data programmatically, Telegram channel metadata extractor, Telegram entity verification API, Telegram scam flag detection API, Telegram bot intelligence API, Telegram phone number extractor, Telegram bulk entity lookup, Telegram profile enrichment pipeline, Telegram group info API, Telegram user intelligence data

#### Industry Terms

Telegram profile intelligence API, entity enrichment pipeline, KYC profile enrichment, scam detection signals, bot capability profiling, cross-platform identity linkage, community trust scoring, bulk entity lookup, abuse monitoring pipeline, Telegram ecosystem intelligence

***

### Trust & Certifications

- ✅ **Production-Grade Infrastructure** — runs on the Apify cloud platform with managed proxy rotation and automatic retries
- ✅ **GDPR & CCPA-Region Aligned** — extracts only publicly available Telegram entity profiles; no personal contact data retained beyond the run session
- ✅ **Pay-Per-Result Billing** — transparent $0.0051 per entity with no monthly minimum or seat fees
- ✅ **Continuously Maintained** — schema and selector updates released as Telegram evolves

***

### Legal & Compliance

#### Data Rights & Usage

All data extracted by this actor originates from publicly accessible Telegram entity profiles. Users are responsible for ensuring their use of extracted data complies with applicable laws, data protection regulations, and Telegram's terms of service.

#### Privacy Compliance

- **GDPR**: Compliant with EU GDPR for data processing workflows.
- **CCPA**: Compliant with California Consumer Privacy Act requirements.

#### Platform Terms of Service

Users must review and comply with Telegram's terms of service when using extracted data.

#### Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries:

- **Telegram**: [@AiAgentApi](https://t.me/AiAgentApi)

***

### Related Tools

#### Jobs & Hiring

- **[All Jobs Scraper](https://apify.com/agentx/all-jobs-scraper?fpr=aiagentapi)** - Multi-Platform Job Listings Intelligence API
- **[Glassdoor Hiring Scraper](https://apify.com/agentx/glassdoor-hiring-scraper?fpr=aiagentapi)** - Glassdoor Job Listings Intelligence API
- **[Glints Employer Data Extractor](https://apify.com/agentx/glints-employer-data-extractor?fpr=aiagentapi)** - Glints Employer Intelligence API
- **[Glints Jobs Data Extractor](https://apify.com/agentx/glints-jobs-data-extractor?fpr=aiagentapi)** - Glints Job Listings Intelligence API
- **[Indeed Hiring Scraper](https://apify.com/agentx/indeed-hiring-scraper?fpr=aiagentapi)** - Indeed Job Listings Intelligence API
- **[JobStreet Employer Data Extractor](https://apify.com/agentx/jobstreet-employer-data-extractor?fpr=aiagentapi)** - JobStreet Employer Intelligence API
- **[JobStreet Jobs Data Extractor](https://apify.com/agentx/jobstreet-jobs-data-extractor?fpr=aiagentapi)** - JobStreet Job Listings Intelligence API
- **[LinkedIn Hiring Scraper](https://apify.com/agentx/linkedin-hiring-scraper?fpr=aiagentapi)** - LinkedIn Job Listings Intelligence API
- **[StepStone Employer Data Extractor](https://apify.com/agentx/stepstone-employer-data-extractor?fpr=aiagentapi)** - StepStone Employer Intelligence API
- **[StepStone Jobs Data Extractor](https://apify.com/agentx/stepstone-jobs-data-extractor?fpr=aiagentapi)** - StepStone Job Listings Intelligence API

#### Social Media

- **[Instagram Creator Scraper](https://apify.com/agentx/instagram-creator-scraper?fpr=aiagentapi)** - Instagram Creator Intelligence API
- **[Instagram Post Reel Scraper](https://apify.com/agentx/instagram-post-reel-scraper?fpr=aiagentapi)** - Instagram Post & Reel Intelligence API
- **[Instagram Trending Scraper](https://apify.com/agentx/instagram-trending-scraper?fpr=aiagentapi)** - Instagram Trending Content Intelligence API
- **[LinkedIn Company Scraper](https://apify.com/agentx/linkedin-company-scraper?fpr=aiagentapi)** - LinkedIn Company Intelligence API
- **[LinkedIn Profile Scraper](https://apify.com/agentx/linkedin-profile-scraper?fpr=aiagentapi)** - LinkedIn Profile Intelligence API
- **[Medium Author Data Extractor](https://apify.com/agentx/medium-author-data-extractor?fpr=aiagentapi)** - Medium Author Intelligence API
- **[Medium Content Data Extractor](https://apify.com/agentx/medium-content-data-extractor?fpr=aiagentapi)** - Medium Content Intelligence API
- **[Reddit Author Scraper](https://apify.com/agentx/reddit-author-scraper?fpr=aiagentapi)** - Reddit Author Intelligence API
- **[Reddit Viral Scraper](https://apify.com/agentx/reddit-viral-scraper?fpr=aiagentapi)** - Reddit Viral Content Intelligence API
- **[SubReddit Info Scraper](https://apify.com/agentx/subreddit-info-scraper?fpr=aiagentapi)** - Subreddit Intelligence API
- **[Subreddit Member Scraper](https://apify.com/agentx/subreddit-member-scraper?fpr=aiagentapi)** - Subreddit Member Intelligence API
- **[SubReddit Post Scraper](https://apify.com/agentx/subreddit-post-scraper?fpr=aiagentapi)** - Subreddit Post Intelligence API
- **[Telegram Chat Scraper](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi)** - Telegram Chat Intelligence API
- **[Telegram Group Inviter](https://apify.com/agentx/telegram-group-inviter?fpr=aiagentapi)** - Telegram Group Invitation API
- **[Telegram Info Scraper](https://apify.com/agentx/telegram-info-scraper?fpr=aiagentapi)** - Telegram Channel Intelligence API
- **[Telegram Member Scraper](https://apify.com/agentx/telegram-member-scraper?fpr=aiagentapi)** - Telegram Member Intelligence API
- **[Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi)** - Telegram Private Group Intelligence API
- **[TikTok Creator Scraper](https://apify.com/agentx/tiktok-creator-scraper?fpr=aiagentapi)** - TikTok Creator Intelligence API
- **[Twitter Community Scraper](https://apify.com/agentx/twitter-community-scraper?fpr=aiagentapi)** - Twitter Community Intelligence API
- **[Twitter Info Scraper](https://apify.com/agentx/twitter-info-scraper?fpr=aiagentapi)** - Twitter Account Intelligence API
- **[YouTube Market Intelligence](https://apify.com/agentx/youtube-market-intelligence?fpr=aiagentapi)** - YouTube Channel Intelligence API

#### Video & Transcript

- **[All Video Scraper](https://apify.com/agentx/all-video-scraper?fpr=aiagentapi)** - Multi-Platform Video Intelligence API
- **[Live Stream Transcript](https://apify.com/agentx/live-stream-transcript?fpr=aiagentapi)** - Live Stream Transcript Intelligence API
- **[TikTok Live Downloader](https://apify.com/agentx/tiktok-live-downloader?fpr=aiagentapi)** - TikTok Live Stream Download API
- **[TikTok Transcript](https://apify.com/agentx/tiktok-transcript?fpr=aiagentapi)** - TikTok Video Transcript Intelligence API
- **[Video Caption Scraper](https://apify.com/agentx/video-caption-scraper?fpr=aiagentapi)** - Multi-Platform Video Caption Extraction API
- **[Video to Social Post](https://apify.com/agentx/video-to-social-post?fpr=aiagentapi)** - Video to Social Post Generation API
- **[Video Transcript](https://apify.com/agentx/video-transcript?fpr=aiagentapi)** - Multi-Platform Video Transcript Intelligence API
- **[YouTube Transcript](https://apify.com/agentx/youtube-transcript?fpr=aiagentapi)** - YouTube Video Transcript Intelligence API

#### E-Commerce & Retail

- **[Amazon Product Data Extractor](https://apify.com/agentx/amazon-product-data-extractor?fpr=aiagentapi)** - Amazon Product Intelligence API
- **[Amazon Storefront Data Extractor](https://apify.com/agentx/amazon-storefront-data-extractor?fpr=aiagentapi)** - Amazon Storefront Intelligence API
- **[Argos Retail Data Extractor](https://apify.com/agentx/argos-retail-data-extractor?fpr=aiagentapi)** - Argos Product Intelligence API
- **[ASOS Product Catalog Extractor](https://apify.com/agentx/asos-product-catalog-extractor?fpr=aiagentapi)** - ASOS Product Catalog Intelligence API
- **[eBay Marketplace Data Extractor](https://apify.com/agentx/ebay-marketplace-data-extractor?fpr=aiagentapi)** - eBay Marketplace Intelligence API
- **[eBay Seller Leads API](https://apify.com/agentx/ebay-seller-leads-api?fpr=aiagentapi)** - eBay Seller Lead Intelligence API
- **[Flipkart Product Data Extractor](https://apify.com/agentx/flipkart-product-data-extractor?fpr=aiagentapi)** - Flipkart Product Intelligence API
- **[John Lewis Retail Data Extractor](https://apify.com/agentx/john-lewis-retail-data-extractor?fpr=aiagentapi)** - John Lewis Product Intelligence API
- **[Lidl Offers Data Extractor](https://apify.com/agentx/lidl-offers-data-extractor?fpr=aiagentapi)** - Lidl Offers Intelligence API
- **[Magalu Product Data Extractor](https://apify.com/agentx/magalu-product-data-extractor?fpr=aiagentapi)** - Magalu Product Intelligence API
- **[MediaMarkt Product Data Extractor](https://apify.com/agentx/mediamarkt-product-data-extractor?fpr=aiagentapi)** - MediaMarkt Product Intelligence API
- **[Mercado Livre Marketplace Data Extractor](https://apify.com/agentx/mercado-livre-marketplace-data-extractor?fpr=aiagentapi)** - Mercado Livre Marketplace Intelligence API
- **[Nykaa Product Data Extractor](https://apify.com/agentx/nykaa-product-data-extractor?fpr=aiagentapi)** - Nykaa Product Intelligence API
- **[OTTO Product Data Extractor](https://apify.com/agentx/otto-product-data-extractor?fpr=aiagentapi)** - OTTO Product Intelligence API
- **[Target Product Data Extractor](https://apify.com/agentx/target-product-data-extractor?fpr=aiagentapi)** - Target Product Intelligence API
- **[Walmart Product Data Extractor](https://apify.com/agentx/walmart-product-data-extractor?fpr=aiagentapi)** - Walmart Product Intelligence API

#### Classifieds & Automotive

- **[AutoTrader Dealer Leads API](https://apify.com/agentx/autotrader-dealer-leads-api?fpr=aiagentapi)** - AutoTrader Dealer Lead Intelligence API
- **[AutoTrader Vehicle Listings API](https://apify.com/agentx/autotrader-vehicle-listings-api?fpr=aiagentapi)** - AutoTrader Vehicle Listings Intelligence API
- **[Cars.com Dealer Leads API](https://apify.com/agentx/cars-com-dealer-leads-api?fpr=aiagentapi)** - Cars.com Dealer Lead Intelligence API
- **[Cars.com Vehicle Listings API](https://apify.com/agentx/cars-com-vehicle-listings-api?fpr=aiagentapi)** - Cars.com Vehicle Listings Intelligence API
- **[Kleinanzeigen Classifieds Data Extractor](https://apify.com/agentx/kleinanzeigen-classifieds-data-extractor?fpr=aiagentapi)** - Kleinanzeigen Classifieds Intelligence API
- **[Kleinanzeigen Seller Leads API](https://apify.com/agentx/kleinanzeigen-seller-leads-api?fpr=aiagentapi)** - Kleinanzeigen Seller Lead Intelligence API
- **[OLX Classifieds Data Extractor](https://apify.com/agentx/olx-classifieds-data-extractor?fpr=aiagentapi)** - OLX Classifieds Intelligence API
- **[OLX Seller Leads API](https://apify.com/agentx/olx-seller-leads-api?fpr=aiagentapi)** - OLX Seller Lead Intelligence API
- **[Webmotors Vehicle Listings API](https://apify.com/agentx/webmotors-vehicle-listings-api?fpr=aiagentapi)** - Webmotors Vehicle Listings Intelligence API

#### Real Estate

- **[MagicBricks Builder Leads API](https://apify.com/agentx/magicbricks-builder-leads-api?fpr=aiagentapi)** - MagicBricks Builder Lead Intelligence API
- **[MagicBricks Property Data Extractor](https://apify.com/agentx/magicbricks-property-data-extractor?fpr=aiagentapi)** - MagicBricks Real Estate Data API
- **[Realtor Property Scraper](https://apify.com/agentx/realtor-property-scraper?fpr=aiagentapi)** - Realtor.com Property Listings Intelligence API
- **[Zillow For Sale Scraper](https://apify.com/agentx/zillow-for-sale-scraper?fpr=aiagentapi)** - Zillow Property Listings Intelligence API

#### Business Intelligence & Reviews

- **[BBB Business Data Extractor](https://apify.com/agentx/bbb-business-data-extractor?fpr=aiagentapi)** - BBB Business Intelligence API
- **[BBB Reputation Data Extractor](https://apify.com/agentx/bbb-reputation-data-extractor?fpr=aiagentapi)** - BBB Reputation Intelligence API
- **[Google Maps Store Scraper](https://apify.com/agentx/google-maps-store-scraper?fpr=aiagentapi)** - Google Maps Business Intelligence API
- **[Reclame Aqui Company Data Extractor](https://apify.com/agentx/reclame-aqui-company-data-extractor?fpr=aiagentapi)** - Reclame Aqui Company Intelligence API
- **[TradeIndia Product Data Extractor](https://apify.com/agentx/tradeindia-product-data-extractor?fpr=aiagentapi)** - TradeIndia Product Intelligence API
- **[TradeIndia Supplier Leads API](https://apify.com/agentx/tradeindia-supplier-leads-api?fpr=aiagentapi)** - TradeIndia Supplier Lead Intelligence API
- **[Zomato Menu Data Extractor](https://apify.com/agentx/zomato-menu-data-extractor?fpr=aiagentapi)** - Zomato Restaurant Menu Intelligence API
- **[Zomato Restaurant Data Extractor](https://apify.com/agentx/zomato-restaurant-data-extractor?fpr=aiagentapi)** - Zomato Restaurant Search Intelligence API

#### Other

- **[Global Weather Scraper](https://apify.com/agentx/global-weather-scraper?fpr=aiagentapi)** - Global Weather Intelligence API

***

### Support & Community

- **👥 Community**: [@Apify\_Actor](https://t.me/Apify_Actor)
- **👤 Contact Team**: [@AiAgentApi](https://t.me/AiAgentApi)

***

**Last Updated:** May 01, 2026

# 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/DatascienceChats",
    "aipost"
  ]
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "telegram_url": [
        "AiAgentApi",
        "@BotFather",
        "t.me/DatascienceChats",
        "aipost"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/telegram-info-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "telegram_url": [
        "AiAgentApi",
        "@BotFather",
        "t.me/DatascienceChats",
        "aipost",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("agentx/telegram-info-scraper").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/DatascienceChats",
    "aipost"
  ]
}' |
apify call agentx/telegram-info-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=agentx/telegram-info-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Telegram Info Scraper",
        "description": "Bulk-resolve up to 1,000 Telegram identifiers in one call — mix usernames, @handles, and t.me URLs covering users, bots, channels, supergroups, and groups. Each result returns the canonical entity record with ID, type, title or first/last name, listed phone, scam/fake/verified flags, and members.",
        "version": "1.0",
        "x-build-id": "OcsZPbBv2fRSHbKIN"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/agentx~telegram-info-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-agentx-telegram-info-scraper",
                "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/agentx~telegram-info-scraper/runs": {
            "post": {
                "operationId": "runs-sync-agentx-telegram-info-scraper",
                "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/agentx~telegram-info-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-agentx-telegram-info-scraper",
                "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
