docs(readme): add output format, CSV columns, rate-limit and visibility notes

This commit is contained in:
tiennm99 committed 2026-05-11 21:45:51 +07:00
1 parent fc9b70349f
commit 294ecf571f
1 file changed
+23 -1
+23 -1
View File
@@ -1,6 +1,6 @@
# export-telegram-group-members # export-telegram-group-members
Export Telegram group members Export Telegram group members to CSV using Telethon — admin auth required for full member visibility.
## How to use ## How to use
@@ -23,3 +23,25 @@ pip install -r requirements.txt
```bash ```bash
python main.py python main.py
``` ```
## Output format
Results are saved to a timestamped folder (e.g. `2025-01-15 10-30-00/`). Each group produces one CSV file named after the group title:
```
id,username,first_name,last_name
123456789,johndoe,John,Doe
987654321,,Jane,Smith
```
Columns: `id`, `username`, `first_name`, `last_name`. Members without a username have an empty `username` field.
## Rate limits and visibility notes
- Telegram limits how fast you can fetch participants; large groups may take longer.
- For **supergroups**, only admins can retrieve the full member list — regular members see a partial list or get an error.
- For private groups where you are not a member, access will be denied.
## License
Apache-2.0 — see [LICENSE](LICENSE).