explaingit

hhhkarimi/telegram-channel-csv-exporter

Analysis updated 2026-07-13

14PythonAudience · researcherComplexity · 2/5Setup · easy

TLDR

A tool that downloads posts from public Telegram channels and saves them as spreadsheet-ready CSV files, without needing Telegram's official developer API.

Mindmap

mindmap
  root((repo))
    What it does
      Scrapes public Telegram posts
      Exports to CSV spreadsheet
      Captures text and dates
    How it works
      Uses tgstat.com first
      Falls back to t.me/s/
      No API credentials needed
    Use cases
      Track news coverage
      Archive channel posts
      Analyze marketing trends
    Audience
      Researchers
      Journalists
      Marketers
    Interface options
      Desktop visual GUI
      Interactive command line
      Scriptable command line
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Archive all posts from a public news channel over a specific time period.

USE CASE 2

Track how a currency exchange channel posted rates over a month for analysis.

USE CASE 3

Export Telegram channel data into Excel for research or reporting purposes.

What is it built with?

Python

How does it compare?

hhhkarimi/telegram-channel-csv-exporter0c33/agentic-aialbertusreza/pr-pilot
Stars141414
LanguagePythonPythonPython
Setup difficultyeasyhardeasy
Complexity2/54/52/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Only requires Python installed, no Telegram API credentials or external services are needed to run the tool.

No license information is provided, so default copyright restrictions may apply, check the repository for details before use.

In plain English

Telegram Channel CSV Exporter lets you pull posts from any public Telegram channel and save them as a spreadsheet. Instead of dealing with Telegram's official developer API, which requires registration and credentials, this tool scrapes publicly available web previews of channel posts. You get the post text, publish date, view count, and direct link for each message, all organized into a clean CSV file. The tool works by first trying to pull data from a statistics site called tgstat.com. If that site blocks the request or shows a captcha, it automatically falls back to Telegram's own public web preview at t.me/s/. You just provide the channel name and a date range, and it collects every post in that window. It accepts both Gregorian and Jalali (Persian) calendar dates, which makes it especially practical for users working with Iranian sources. This is built for researchers, journalists, or marketers who need to archive or analyze what a channel has posted over time. For example, if you want to track how a news channel covered an event over a month, or archive the posts of a currency exchange channel for research, you can run the tool and import the resulting CSV directly into Excel. The file is specifically encoded so that Persian text displays correctly in Excel without garbled characters. Users can interact with the tool in three ways. There is a simple visual desktop interface where you type in the channel name and dates, an interactive command-line mode that prompts you step by step, and a direct command-line mode for people who want to script or automate the process. For very large date ranges, you can add a delay between requests to avoid getting rate-limited. The project is straightforward about its tradeoffs. It only works on public channels, and it cannot access private, restricted, or members-only content. Because it relies on public web previews rather than the official API, it is subject to the limitations and potential blocking of those web sources. The author emphasizes using it responsibly and respecting platform rules.

Copy-paste prompts

Prompt 1
Help me set up and run the Telegram Channel CSV Exporter to download posts from a public channel named 'example_channel' from January 2024 to March 2024.
Prompt 2
Show me how to use the scriptable command-line mode to automate downloading posts from multiple Telegram channels with a delay between requests.
Prompt 3
I have a CSV file exported by the Telegram Channel CSV Exporter containing Persian text. Help me open it correctly in Excel without garbled characters.
Prompt 4
Guide me through using the interactive command-line mode to pull posts from a public Telegram channel using Jalali calendar dates.

Frequently asked questions

What is telegram-channel-csv-exporter?

A tool that downloads posts from public Telegram channels and saves them as spreadsheet-ready CSV files, without needing Telegram's official developer API.

What language is telegram-channel-csv-exporter written in?

Mainly Python. The stack also includes Python.

What license does telegram-channel-csv-exporter use?

No license information is provided, so default copyright restrictions may apply, check the repository for details before use.

How hard is telegram-channel-csv-exporter to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is telegram-channel-csv-exporter for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.