# Telegram Email Scraper (`scraper-engine/telegram-email-scraper`) Actor

Telegram Email Scraper extracts publicly available email addresses from Telegram profiles, groups, and channels. Build targeted contact lists by niche or region. Ideal for marketers and sales teams running outreach campaigns.

- **URL**: https://apify.com/scraper-engine/telegram-email-scraper.md
- **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community)
- **Categories:** Lead generation, Social media, Other
- **Stats:** 11 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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** Email Scraper 📱

The **Telegram** Email Scraper allows you to **extract** publicly available contact information from **Telegram** channels and groups. It is specifically designed to retrieve email addresses shared in public channel/group descriptions and posts.

By organizing this **data** into a structured format, the **Telegram** email **extract**or makes it easy to analyze and utilize the information for your needs.

With its advanced scraping capabilities, you can efficiently generate targeted email lists for marketing, research, or networking purposes. The **Telegram** email scraping tool is versatile and adaptable, ensuring you can **extract** the most relevant **data** for your specific use case.

Telegram Email Scraper is a powerful tool designed to help you extract email addresses from public Telegram channels and groups efficiently. It simplifies the process of gathering valuable contact information for various purposes.

By using a Telegram email extractor, you can save time and effort while building targeted email lists. This tool is ideal for businesses, marketers, and researchers looking to connect with specific audiences.

With the Telegram Email Scraper, you can access and organize email data from public Telegram channels/groups in a structured format. It is a reliable solution for email harvesting and contact management.

### Support and feedback

- **Bug reports**: Open a ticket in the repository Issues section
- **Custom features**: Contact our enterprise support team
  *Email: dev.scraperengine@gmail.com*

### Extractable Data Table 📊

Each result row contains the following fields:

| Data Type | Description |
| --- | --- |
| network | Source platform (e.g. t.me). |
| keyword | The keyword that produced this result. |
| title | Title of the result (usually the channel/group name). |
| description | Snippet text from the result, which may contain contact info. |
| url | Direct URL to the Telegram channel/group page. |
| email | Publicly available email address extracted from the result. |

### Key Features of **Telegram** Email Scraper

Here are the **standout features** that make the **Telegram** Email Scraper a **top-tier tool** for **marketers**, **agencies**, and **researchers**:

- ⭐ Efficiently extracts email addresses from public **Telegram** channels and groups
- ⭐ Supports public **Telegram** channels and groups with indexed preview pages
- ⭐ User-friendly interface that requires no advanced technical skills
- ⭐ Organizes extracted data into structured formats such as CSV or JSON
- ⭐ Offers advanced filtering options to target specific channels or keywords
- ⭐ Ensures high accuracy and minimizes duplicate email entries
- ⭐ Provides up-to-date contact information from publicly indexed pages
- ⭐ Includes robust data security measures to protect user privacy
- ⭐ **Customizable** settings to adapt to different scraping requirements
- ⭐ Offers detailed logs and reports for tracking scraping activities
- ⭐ Supports integration with third-party tools for seamless data management

### How to use **Telegram** Email Scraper 🚀

Follow this **simple, step-by-step guide** to start extracting **Telegram** emails today:

1. ✅ Open the **Telegram** Email Scraper actor on the Apify platform
2. ✅ **Enter** one or more keywords describing the audience you want to reach
3. ✅ **Configure** the scraping settings including email domain filters and location
4. ✅ **Start** the scraping run and allow the tool to collect email addresses
5. ✅ Monitor the progress of the run through the Apify console
6. ✅ **Export** the extracted data to your preferred format such as CSV or JSON
7. ✅ **Review** and organize the extracted email list for your specific needs
8. ✅ Repeat the process with new keywords for additional coverage
9. ✅ Ensure compliance with legal and ethical guidelines when using the data

### Use Cases 🎯

Marketing Campaigns
🎯 Generate targeted email lists for promotional campaigns
🎯 Reach out to potential customers from specific **Telegram** channels/groups

Research and Analysis
🎯 **Collect** email data for market research purposes
🎯 **Analyze** engagement in public **Telegram** channels

Networking Opportunities
🎯 Connect with professionals in your industry through **Telegram** communities
🎯 Build a contact list for collaboration or partnerships

Lead Generation
🎯 **Identify** potential leads from public **Telegram** communities
🎯 Expand your business outreach with targeted email lists

### Why choose us? 💎

Our **Telegram** Email Scraper stands out as the **best** **Telegram** email scraper tool due to its efficiency, accuracy, and **user-friendly** design. It is specifically developed to cater to a wide range of users, from marketers to researchers, ensuring that everyone can benefit from its features.

With **advanced** filtering options and up-to-date scraping capabilities, this tool allows you to extract only the most relevant data. We prioritize user privacy and data security, implementing robust measures to protect your information.

Additionally, we offer excellent customer support to assist you with any questions or issues.

By choosing our **Telegram** email extraction software, you gain access to a **reliable** and efficient solution for all your email scraping needs. Whether you are looking to extract emails from **Telegram** channels or generate email lists, our tool is designed to deliver exceptional results.

### **Telegram** Email Scraper Scalability 📈

The **Telegram** Email Scraper is built to handle projects of any size, making it a scalable solution for email extraction. Whether you need to scrape emails from a single **Telegram** channel or multiple channels/groups, the tool can accommodate your requirements.

Its **advanced** algorithms ensure **efficient** data collection, even for **large-scale** scraping tasks. The software is optimized to process high volumes of data without compromising on speed or accuracy.

With **customizable** settings, you can tailor the scraping process to suit your specific needs. This makes it an ideal choice for businesses, researchers, and marketers seeking to extract large amounts of email data.

By leveraging the scalability of our **Telegram** email scraping tool, you can achieve your goals **efficient**ly and effectively.

### **Telegram** Email Scraper Legal Guidelines ⚖️

**Yes**—scraping **Telegram** is **legal** as long as you follow **ethical** and **compliant** practices. The **Telegram** Email Scraper extracts only **publicly available** information from **public** **Telegram** channels and groups, making it **safe** and **compliant** for **research**, **marketing**, and **analysis**.

#### Legal & Ethical Guidelines

⚖️ **Ensure** you have proper permissions to use data from **Telegram** channels or groups
⚖️ **Do not** use the tool to collect data from private groups or channels
⚖️ **Avoid** using the extracted data for spamming or unsolicited marketing purposes
⚖️ Comply with all relevant data protection laws and regulations such as GDPR
⚖️ Respect the privacy of **Telegram** users and handle their data responsibly
⚖️ **Do not** share or sell the extracted data without proper authorization
⚖️ **Use** the tool only for ethical and legitimate purposes
⚖️ Regularly review and update your practices to align with legal requirements

### Input Parameters 🧩

📦 Example Input (JSON)

```json
{
  "keywords": ["marketing"],
  "platform": "Telegram",
  "location": "",
  "emailDomains": ["@gmail.com", "@outlook.com"],
  "maxEmails": 10,
  "engine": "legacy",
  "proxyConfiguration": { "useApifyProxy": false }
}
```

### Input Table

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| keywords | array | ✅ Yes | Keywords used to find relevant Telegram channel/group pages. One or more. |
| platform | string | No | Platform to scrape. Currently `Telegram`. |
| location | string | No | Optional location filter. Empty = global. |
| emailDomains | array | No | Keep only emails from these domains (e.g. `@gmail.com`). Custom/business domains supported. Empty = all domains. |
| maxEmails | integer | No | Max emails to collect per keyword (default `10`, range 1–100000). |
| engine | string | No | Processing engine. Currently `legacy`. |
| proxyConfiguration | object | No | Proxy settings. Empty = the actor auto-selects the best proxy (recommended). |

> ℹ️ Emails are sourced from publicly available information only. Yield depends on how many channels/groups publicly expose a contact email in their description or posts. Broaden `keywords`/`emailDomains` and raise `maxEmails` for more results.

### Output Format 📤

📝 Example Output (JSON)

```json
[
  {
    "network": "t.me",
    "keyword": "marketing",
    "title": "Indie Devs Marketing Hub",
    "description": "A public channel for indie developers sharing marketing tips and collaborations. Contact us at hello@indiedevs.example.com",
    "url": "https://t.me/indiedevsmarketing",
    "email": "hello@indiedevs.example.com"
  }
]
```

### Output Table

| Data Type | Description |
| --- | --- |
| network | Source platform (t.me) |
| keyword | Keyword that triggered the result |
| title | Result title (usually the channel/group name) |
| description | Public snippet, may contain contact info |
| url | Direct Telegram channel/group link |
| email | Extracted email address |

### FAQ ❓

#### What is the Telegram **Email Scraper**?

The Telegram Email Scraper is a tool designed to extract email addresses and other publicly available data from Telegram channels and groups.

#### Can I use the tool for **private** Telegram groups?

**No**, the tool only collects data that is publicly available; it does not access private groups or channels.

#### What formats are supported for **export**ing data?

The tool supports exporting data in formats such as **CSV** and **JSON**.

#### Is the Telegram **Email Scraper** easy to use?

**Yes**, the tool features a **user-friendly** interface suitable for users of all technical skill levels.

#### Can I scrape data from multiple Telegram channels or groups?

**Yes**, the tool allows you to collect data from multiple public channels or groups in a single run.

#### Does the tool offer filtering options?

**Yes**, you can configure filters to target specific keywords, locations, or email domains.

#### Is the **extract**ed data **secure**?

**Yes**, the tool includes robust data security measures to protect user privacy.

#### Can I use the tool for marketing purposes?

**Yes**, but ensure **compliance** with legal and ethical guidelines when using the data.

#### What support is available for the tool?

We offer customer support to assist with any questions or issues related to the tool.

#### How accurate is the email **extract**ion process?

The tool is designed to ensure high accuracy and minimize duplicate entries.

#### Are there any restrictions on the number of emails I can **extract**?

**No**, the tool is scalable and can handle projects of any size (subject to the `maxEmails` setting).

#### Do I need technical skills to use the tool?

**No**, the Telegram Email Scraper is designed to be **user-friendly** and requires no advanced technical skills.

#### Is the tool **legal** to use?

**Yes**, as long as you comply with legal and ethical guidelines, the tool is legal to use.

# Actor input Schema

## `keywords` (type: `array`):

🎯 The words that power your search! Add one or more keywords (e.g. \['marketing']) and the actor finds public Telegram channel/group pages matching them, then 📧 extracts any email addresses it finds. 💡 Tip: more specific keywords = more targeted leads.

## `platform` (type: `string`):

📱 The site to scrape. Currently locked to Telegram — more platforms coming soon! 🚀

## `location` (type: `string`):

🗺️ Optional geo-targeting! Add a city or region (e.g. 'London' 🇬🇧, 'New York' 🗽, 'Dubai' 🏙️) to narrow results to pages mentioning that place. ✨ Leave empty to search the whole globe 🌍.

## `emailDomains` (type: `array`):

🎛️ Keep only emails from the domains you care about — type as many as you like! ✍️ Popular picks: 📮 @gmail.com · 📨 @outlook.com · 💌 @hotmail.com · 💜 @yahoo.com · ☁️ @icloud.com · 📬 @aol.com · 🔒 @protonmail.com · 📥 @live.com · 📧 @gmx.com · 🟡 @yandex.com · 📗 @zoho.com. 🏢 Custom/business domains work too — e.g. @yourcompany.com. 🕳️ Leave empty to collect emails from ALL domains. 💡 Adding a domain also sharpens the search 🎯.

## `maxEmails` (type: `integer`):

🎚️ How many emails to collect per keyword before moving on. ⚡ Higher = more leads but longer runs. Default is 10 ✅ (range 1 – 100,000).

## `engine` (type: `string`):

🔧 The processing engine. Currently 'legacy' 🛡️ — a reliable, battle-tested extraction pipeline. More engines on the roadmap! 🚧

## `proxyConfiguration` (type: `object`):

🌐 Control how the actor connects to the internet. 🆓 Leave it empty and the actor auto-selects the best proxy for reliable results. 🔄 On any failed response it rotates the connection and retries up to 3× automatically. 🧠 Advanced users can plug in custom proxies here.

## Actor input object example

```json
{
  "keywords": [
    "marketing"
  ],
  "platform": "Telegram",
  "location": "",
  "emailDomains": [
    "@gmail.com"
  ],
  "maxEmails": 10,
  "engine": "legacy",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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 = {
    "keywords": [
        "marketing"
    ],
    "emailDomains": [
        "@gmail.com"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-engine/telegram-email-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 = {
    "keywords": ["marketing"],
    "emailDomains": ["@gmail.com"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("scraper-engine/telegram-email-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "marketing"
  ],
  "emailDomains": [
    "@gmail.com"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scraper-engine/telegram-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraper-engine/telegram-email-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8mscoqQESI9wZJkEv/builds/Yq8tbWQcxfr4QNFy8/openapi.json