# Telegram Chat Scraper (`agentx/telegram-chat-scraper`) Actor

Replay any public Telegram channel or group like a paginated archive: pull up to 1,000,000 messages with sender, timestamp, reactions, forward chain, reply linkage, and service events. Choose text-only, text+images, or text+all media — large attachments are pushed straight to your key-value store.

- **URL**: https://apify.com/agentx/telegram-chat-scraper.md
- **Developed by:** [AgentX](https://apify.com/agentx) (community)
- **Categories:** Social media, Agents, Integrations
- **Stats:** 205 total users, 8 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.51 / 1,000 messages

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 Chat Scraper - Telegram Message Intelligence API

**Telegram Chat Scraper is a Telegram message intelligence API that extracts structured public-channel and group messages, engagement metrics, forward chains, and reaction counts in a single channel/group-driven run — no Telegram authentication required.** Telegram Chat Scraper returns structured records per message, including message ID, full text, sender ID and metadata, view count, reply count, forward count, reaction counts per emoji, hashtags array, URLs array, media URLs, forward origin channel and message ID, service event type, album ID, post date, and message permalink. Coverage spans all public Telegram channels and groups globally with date-range scoping (absolute and relative). Built for compliance archives, brand monitoring, community sentiment analysis, OSINT research, viral-content tracking, regulated-industry message logging, and NLP training-data pipelines. Per-message pay-per-result pricing at $0.00053 with no monthly minimum.

[![Telegram](https://img.shields.io/badge/Telegram-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi) [![Message Intelligence](https://img.shields.io/badge/Message_Intelligence-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi) [![Chat Analytics](https://img.shields.io/badge/Chat_Analytics-26A5E4?style=for-the-badge&color=26A5E4)](https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi)

---

### Why Choose This API

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

**📊 Engagement Signal Extraction**
The `view_count`, `reply_count`, and `forward_count` fields deliver per-message engagement signals — enabling reach scoring, virality detection, content impact ranking, and message engagement benchmarking for social intelligence pipelines.

**🔗 Forward Chain Intelligence**
The `forward_info` object captures the origin channel name, source message ID, and source date for every forwarded message — enabling content propagation mapping, information network analysis, and cross-channel message attribution.

**😀 Reaction Metadata**
The `reactions` field captures emoji reaction counts per message — enabling sentiment signal extraction, emotional response analysis, and audience reaction profiling for community intelligence workflows.

**🏷️ Hashtag & URL Extraction**
The `hashtags` and `urls` arrays are pre-parsed per message — enabling topic taxonomy mapping, outbound link intelligence, and content categorization without additional text parsing.

**📅 Date-Range Extraction**
The `start_date` parameter supports absolute and relative date expressions (e.g., `1 day`, `2026-01-01`) — enabling time-scoped historical archives, event-window extraction, and incremental monitoring pipelines.

**🎬 Media Download Control**
Three media modes — `text`, `image`, `all` — allow precise cost-performance optimization: extract text-only for high-volume NLP workflows, or include media files for comprehensive content archives.

---

### Quick Start Guide

#### How to Extract Telegram Chat Messages in 3 Steps

##### Step 1: Find the Target Channel or Group

Enter the Telegram URL, `@username`, or plain username (e.g., `https://t.me/aipost`, `@aipost`, or `aipost`).

##### Step 2: Configure Date Range and Volume

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

Set `start_date`, `max_results`, and `download_medias` mode, then click **Start**.

##### Step 3: Download Message Data

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

---

### Input Parameters

#### Configuration Fields

| Parameter         | Type       | Required | Description                                                       | Example Values                            |
| ----------------- | ---------- | -------- | ----------------------------------------------------------------- | ----------------------------------------- |
| `telegram_url`    | string     | ✅       | Telegram channel/group URL, @username, or plain username          | `"https://t.me/aipost"`, `"@crypto_news"` |
| `download_medias` | select     | ✅       | Media download scope: text / image / all                          | `"text"`, `"image"`, `"all"`              |
| `start_date`      | datepicker | ❌       | Extract messages from this date to present (absolute or relative) | `"1 day"`, `"2026-01-01"`                 |
| `max_results`     | integer    | ✅       | Maximum number of messages to extract (10–1,000,000)              | `100`, `1000`, `50000`                    |

#### Example Input Configuration

```json
{
  "telegram_url": "https://t.me/aipost",
  "download_medias": "text",
  "start_date": "7 day",
  "max_results": 1000
}
````

***

### Output Data Schema

#### Complete Message Record Structure

Each extracted Telegram message record contains the following fields:

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

#### Core Message Fields

| Field           | Type    | Description                                 |
| --------------- | ------- | ------------------------------------------- |
| `processor`     | string  | Apify actor URL that processed this record  |
| `processed_at`  | string  | ISO 8601 timestamp (UTC) when scraped       |
| `id`            | integer | Telegram message unique identifier          |
| `type`          | string  | Message type (Regular / Service)            |
| `date`          | string  | Message send timestamp (ISO 8601)           |
| `text`          | string  | Full message text content                   |
| `sender`        | string  | Username or display name of sender          |
| `silent`        | boolean | Silent message flag                         |
| `pinned`        | boolean | Pin status                                  |
| `view_count`    | integer | Total message views                         |
| `reply_count`   | integer | Number of replies                           |
| `forward_count` | integer | Number of forwards                          |
| `reply_to`      | integer | Parent message ID if reply                  |
| `album_id`      | integer | Media album grouping ID                     |
| `topic_name`    | string  | Forum topic name (forum groups)             |
| `edit_date`     | string  | Last edit timestamp                         |
| `urls`          | array   | URLs found in message text                  |
| `hashtags`      | array   | Hashtags found in message text              |
| `service_type`  | string  | Service event type (Pin / ChatAddUser etc.) |
| `service_info`  | string  | Service event additional details            |
| `forward_info`  | object  | Origin channel/message for forwarded posts  |
| `reactions`     | array   | Emoji reaction counts per message           |

#### Example JSON Output

```json
{
  "processor": "https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi",
  "processed_at": "2026-05-01T10:30:00.000Z",
  "id": 12345,
  "type": "Regular",
  "date": "2026-04-30T14:22:00+00:00",
  "text": "Major LLM benchmark update dropped today. Thread below.",
  "sender": "@aipost",
  "view_count": 45000,
  "reply_count": 120,
  "forward_count": 850,
  "hashtags": ["#AI", "#LLM"],
  "urls": ["https://arxiv.org/abs/2505.12345"],
  "reactions": [{ "emoji": "🔥", "count": 340 }]
}
```

#### Export Formats

- **JSON** - Complete structured data with all engagement metadata
- **CSV** - Spreadsheet-compatible for BI and analytics tools
- **API Access** - Programmatic access via Apify Client SDK
- **Cloud Storage** - Automatic upload to Apify Dataset

***

### Integration Examples

#### Actor ID for Platform Integration

```text
CTS2Fv7KyZuiQeSJ8
```

#### Ⓜ️ [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": "https://t.me/aipost",
    "download_medias": "text",
    "start_date": "7 day",
    "max_results": 1000
}

run = client.actor("CTS2Fv7KyZuiQeSJ8").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: "@crypto_news",
  download_medias: "text",
  max_results: 500,
};

const run = await client.actor("CTS2Fv7KyZuiQeSJ8").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-chat-scraper#software",
      "name": "Telegram Chat Scraper",
      "description": "Telegram Chat Scraper is a Telegram message intelligence API extracting structured chat data with engagement metrics, forward chains, reaction counts, hashtags, URLs, media, and sender metadata for social listening and compliance archive pipelines.",
      "applicationCategory": "BusinessApplication",
      "applicationSubCategory": "Web Scraping API",
      "operatingSystem": "Web, Cloud",
      "url": "https://apify.com/agentx/telegram-chat-scraper?fpr=aiagentapi",
      "softwareVersion": "1.0.0",
      "datePublished": "2024-08-01",
      "dateModified": "2026-05-01",
      "featureList": [
        "Full message text and sender metadata",
        "Views, replies, forwards, reaction counts",
        "Forward chain origin (channel + message ID)",
        "Hashtags, URLs, and media URLs",
        "Album ID and service event type",
        "Date-range scoping (absolute and relative)",
        "Per-message pay-per-result at $0.00053",
        "Native integrations with Make.com, n8n, LangChain, and CrewAI"
      ],
      "offers": {
        "@type": "Offer",
        "price": "0.00053",
        "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",
        "message intelligence",
        "chat analytics",
        "OSINT"
      ]
    },
    {
      "@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 Chat Scraper",
          "item": "https://apify.com/agentx/telegram-chat-scraper"
        }
      ]
    }
  ]
}
```

***

### Pricing & Cost Calculator

#### Pay-Per-Result Pricing

| Event                       | Rate                |
| --------------------------- | ------------------- |
| Actor Start                 | $0.08 per GB memory |
| Message (per message)       | $0.00053 (BRONZE)   |
| Media (per file downloaded) | $0.001              |

#### Cost Calculator Examples

| Messages        | Media Downloads | Estimated Cost |
| --------------- | --------------- | -------------- |
| 100 messages    | 0 media         | ~$0.13         |
| 1,000 messages  | 0 media         | ~$0.61         |
| 10,000 messages | 0 media         | ~$5.38         |
| 10,000 messages | 500 media       | ~$5.88         |
| 50,000 messages | 0 media         | ~$26.57        |

> Set `download_medias: "text"` to eliminate media download charges for text-only extraction.

***

### Use Cases & Applications

#### Brand Monitoring & Social Listening

**Telegram Brand Channel Monitoring**
Extract messages from brand-relevant Telegram channels — building structured brand mention archives, monitoring product discussions, and tracking competitor channel activity for social listening pipelines.

**Community Sentiment Analysis**
Extract message text with `view_count` and `reactions` from niche topic channels — building sentiment datasets, audience reaction corpora, and community mood timelines for NLP analysis.

#### Compliance & OSINT Research

**Channel Message Archiving**
Use `start_date` for precise historical window extraction — building point-in-time channel archives, compliance records, and regulatory evidence collections for legal and compliance workflows.

**Information Propagation Analysis**
The `forward_info` object reveals cross-channel message propagation — enabling information source attribution, network spread mapping, and misinformation tracing for OSINT research pipelines.

**Hashtag & Topic Monitoring**
The `hashtags` array enables tag-based filtering post-extraction — building topic frequency timelines, hashtag trend analysis, and community topic calendars for strategic intelligence workflows.

***

### FAQ

#### Does this require Telegram authentication?

No — this actor extracts data from public Telegram channels and groups without any Telegram account or API credentials.

#### What does `download_medias: "all"` include?

Photos, videos, documents, audio files, and other media attachments found in messages. Each media file is charged at $0.001. Use `"text"` mode to skip all media downloads.

#### How does the `start_date` field work?

Supports absolute dates (`"2026-01-01"`) and relative expressions (`"1 day"`, `"2 weeks"`) — enabling both historical range extraction and rolling monitoring windows.

#### Can I monitor a private channel?

This actor extracts data from publicly accessible Telegram channels and groups. See [Telegram Private Group Scraper](https://apify.com/agentx/telegram-private-group-scraper?fpr=aiagentapi) for private group extraction.

***

### SEO Keywords & Search Terms

#### Primary Keywords

Telegram chat scraper API, Telegram message extractor, Telegram channel message API, Telegram group chat data API, Telegram message intelligence, Telegram chat history API, Telegram channel scraper, Telegram message dataset, Telegram community content API, structured Telegram message data

#### Long-Tail Keywords

how to extract Telegram channel messages programmatically, Telegram chat message monitoring API, Telegram channel history extractor, Telegram group message scraper, Telegram forward chain analysis API, Telegram reaction data extractor, Telegram hashtag monitoring API, Telegram message sentiment analysis, Telegram channel compliance archive, Telegram OSINT message intelligence

#### Industry Terms

Telegram message intelligence API, channel content archiving, social listening pipeline, forward chain propagation, reaction sentiment signals, OSINT chat intelligence, compliance message archive, brand monitoring data, NLP training corpus, community sentiment analysis

***

### 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 channel and group messages; no personal contact data retained beyond the run session
- ✅ **Pay-Per-Result Billing** — transparent $0.00053 per message 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 channels and groups. 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 developer 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: `string`):

Telegram channel or group link (supports t.me URL, @username, or username)

## `download_medias` (type: `string`):

Select what medias to download from messages (text only, text + images, or text + all media)

## `start_date` (type: `string`):

Get messages from this date to present

## `max_results` (type: `integer`):

Maximum number of messages to get from the channel/group

## Actor input object example

```json
{
  "telegram_url": "https://t.me/aipost",
  "download_medias": "text",
  "start_date": "1 day",
  "max_results": 10
}
```

# Actor output Schema

## `results` (type: `string`):

All Telegram messages with full metadata including text, sender, engagement metrics, reactions, and media URLs

# 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": "https://t.me/aipost",
    "download_medias": "text",
    "start_date": "1 day",
    "max_results": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("agentx/telegram-chat-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": "https://t.me/aipost",
    "download_medias": "text",
    "start_date": "1 day",
    "max_results": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("agentx/telegram-chat-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": "https://t.me/aipost",
  "download_medias": "text",
  "start_date": "1 day",
  "max_results": 10
}' |
apify call agentx/telegram-chat-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Telegram Chat Scraper",
        "description": "Replay any public Telegram channel or group like a paginated archive: pull up to 1,000,000 messages with sender, timestamp, reactions, forward chain, reply linkage, and service events. Choose text-only, text+images, or text+all media — large attachments are pushed straight to your key-value store.",
        "version": "1.0",
        "x-build-id": "A3pHKMK6mclVgtGRx"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/agentx~telegram-chat-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-agentx-telegram-chat-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-chat-scraper/runs": {
            "post": {
                "operationId": "runs-sync-agentx-telegram-chat-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-chat-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-agentx-telegram-chat-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",
                    "max_results",
                    "download_medias"
                ],
                "properties": {
                    "telegram_url": {
                        "title": "🎯 Telegram URL",
                        "type": "string",
                        "description": "Telegram channel or group link (supports t.me URL, @username, or username)"
                    },
                    "download_medias": {
                        "title": "📱 Download Medias",
                        "enum": [
                            "text",
                            "image",
                            "all"
                        ],
                        "type": "string",
                        "description": "Select what medias to download from messages (text only, text + images, or text + all media)"
                    },
                    "start_date": {
                        "title": "📅 Start Date",
                        "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$",
                        "type": "string",
                        "description": "Get messages from this date to present"
                    },
                    "max_results": {
                        "title": "📊 Max Results",
                        "minimum": 10,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Maximum number of messages to get from the channel/group"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```