🕊️ Telegram All-in-One Scraper

Scrape messages from public Telegram channels — no API key, no login, no phone number. 🇫🇷🇬🇧

---

✨ Features / Fonctionnalités

🇫🇷	🇬🇧
📝 Texte des messages	Message text
👁️ Vues	Views count
🖼️ Médias (photos, vidéos)	Media (photos, videos)
📅 Dates précises	Exact timestamps
🔗 Lien direct vers chaque post	Direct link to each post
📚 Pagination complète	Full history pagination
📅 Filtre par dates	Date range filter
📦 Sortie JSON/CSV/XLSX (Apify dataset)	JSON/CSV/XLSX output (Apify dataset)
🧑🤝🧑 Multi-canaux en un run	Multiple channels in one run

Sans clé API, sans login, sans numéro de téléphone. No API key, no login, no phone number.

---

🚀 Usage

Input

{
  "channels": ["durov", "startupflow", "techcrunch"],
  "maxMessages": 1000,
  "maxTotalResults": 20000,
  "startDate": "2026-01-01",
  "endDate": "",
  "keywords": ["AI", "agent"],
  "maxPages": 500,
  "delay": 1.0
}

Output (dataset)

{
  "channel": "durov",
  "date": "2026-06-01T15:40:13+00:00",
  "text": "💎 TON's native currency is becoming Gram...",
  "views": "11.4M",
  "author": null,
  "photo": "https://cdn4.telegram-cdn.org/file/...",
  "video": null,
  "url": "https://t.me/durov/522"
}

---

📦 Output limits / Limites de sortie

Preset	Messages/channel	Total/run	Pages/channel	Usage
Preview	100	500	25	Validate a target cheaply
Standard (default)	1,000	20,000	500	Monitoring and normal exports
Large	50,000	100,000	3,000	Historical backfills

• Up to 20 public channels per run.
• Every customer launch is an independent Apify run.
• The global result budget prevents accidental runaway runs.
• Actual output depends on public history availability, filters, runtime and Telegram responses.
• The Actor never claims that a configured maximum is guaranteed.

💰 Pricing / Tarification

Pricing will be configured and verified on Apify before Store publication. Until then, this private MVP does not claim or trigger pay-per-event charges.

La tarification sera configurée et vérifiée sur Apify avant publication dans le Store. En attendant, ce MVP privé n’annonce et ne déclenche aucun frais PPE.

---

🛠️ Développement local

pip install -r requirements.txt
python proto_scraper.py durov 2        # test rapide
python -m src.main                     # mode acteur (SDK Apify)

📁 Structure

telegram-scraper/
├── src/
│   ├── main.py           # Actor Apify (SDK)
│   └── scraper_core.py   # logique pure (fetch + parse)
├── .actor/
│   └── input_schema.json # schéma d'entrée
├── Dockerfile
├── requirements.txt
└── README.md