Telegram Analytics API Overview
Use the API to find Telegram channels and groups, retrieve their statistics and publications, search posts, and follow changes over time.
Start with your first request. If you already have an integration, check API keys, credits and limits to understand its access and billing.
Choose a workflow
| Your task | Guide |
|---|---|
| Find a channel and retrieve its information | Channels and groups |
| Build a filtered list of channels | Catalog |
| Retrieve publications or search their text | Messages and search |
| Read subscriber/reach history and channel mentions | Charts and mentions |
| Track channels entering or leaving a selection | Snapshots and diffs |
| Handle IDs, pagination, dates and retries | Integration essentials |
The API Reference lists exact parameters, response schemas and status codes. Download the matching OpenAPI document to generate a client.
API keys
The API supports Credits API keys and Subscription API keys. Both use the x-api-key header; the key determines which access and billing rules apply. GET /v1/usage/info identifies your key with key_type.
Catalog and post search are included with Advanced and Team credits access. Subscription-key features and allowances are configured separately. See plans and limits.
Help
Contact technical support for integration questions and sales for Subscription API access or individual limits. Follow the Changelog for contract and documentation changes.