How to scrape Telegram Channel Posts with Python

A public channel's latest posts with views, newest first. This tutorial gets it with a short Python program and the Telegram Channel Posts API. Each successful call costs 1 credit; errors and not-found answers are free.

1. Get an API key

Sign in to get a key and 100 free credits, no card. Then put the key in an environment variable so it stays out of your code:

export SCRAPEIO_API_KEY="your_key_here"

2. Set up Python

pip install requests

3. Write the code

Save this as scrape.py.

import os
import requests

API_KEY = os.environ["SCRAPEIO_API_KEY"]
URL = "https://scrapeio.com/v1/telegram/channel/posts"
params = {"handle": "nike"}

items = []
while True:
    r = requests.get(URL, params=params, headers={"x-api-key": API_KEY}, timeout=60)
    r.raise_for_status()
    data = r.json()["data"]
    items += data.get("items", [])
    if not data.get("has_more") or not data.get("cursor") or len(items) >= 100:
        break
    params["cursor"] = data["cursor"]

print(len(items), "items")
print(items[:3])

The loop follows data.cursor until data.has_more is false, and stops at 100 items. Each page is one call, so it costs 1 credit.

4. Run it

python scrape.py

The response has the same envelope on every endpoint: success, cached, credits_used, credits_remaining and data. Shared fields such as handle, followers, plays, likes and created_at have the same names on every platform.

Parameters

Errors and what you pay

Same endpoint in other languages

Node.js · JavaScript · TypeScript · Go · Rust · Java · C# · PHP · Ruby · Kotlin · Swift · R

Prefer no code?

Connect the MCP server to Claude Code, Cursor or Codex and ask in plain English. The agent uses the telegram_channel_posts tool for you.

More Telegram tutorials in Python

• How to scrape Telegram Channel with Python
• How to scrape Telegram Post with Python