Data API

Telegram Data API

Structured JSON data, on demand, with anti-bot bypass built in.

3endpointsRate Limit handled for you

Telegram Data API overview

Extract structured data from Telegram as structured JSON. Choose an endpoint below, check its parameters, and run it in the dashboard playground.

/v1/telegram/… Open playground

Key Features

Structured JSON

Clean, normalized records for structured data. No HTML parsing on your side.

3 endpoints

Across 2 categories, all under one base path.

Anti-bot handled

Rate Limit cleared for you behind the scenes.

Fresh or cached

Serve instantly from the warm store, or force a live scrape per request.

Regions & Languages

Global coverage. Results are returned for the default locale.

Pagination

These endpoints return a single result set (no pagination needed).

Quick Start

Use your dedicated Data API key. Follow this endpoint's method and parameters.

data_api.py

# Install: pip install requests
import json
import os
import requests

params = json.loads("{\"channel\":\"telegram\",\"limit\":20}")
response = requests.request(
    "GET", "https://api.capzy.ai/v1/telegram/channel_posts",
    headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
    params=params,
    timeout=120,
)
response.raise_for_status()
print(response.json())

Per-run pricing

failed requests are free

Endpoint	Category	Price / 1k results
`/v1/data/telegram/channel`Channel Profile	Channels	1 credit / run
`/v1/data/telegram/channel_posts`Channel Posts	Channels	1 credit / run
`/v1/data/telegram/post`Single Post	Posts	1 credit / run