Track reach and ERR of your Telegram channels in chat

The agent calls api.tgstat.ru and reads Telegram channel analytics: channel cards and statistics, posts and stories, mentions and reposts, the dynamics of subscribers and views. On top of the raw numbers it calculates average reach, ER and ERR, builds daily dynamics and names the posts that carried the period, and for a single post it pulls an hourly breakdown of views, reactions and shares.

TGStat is an index on top of public channels, not Telegram itself. The agent sees exactly what the service has managed to index: private channels and chats never make it into the results, and a freshly created channel takes time to accumulate statistics. So the agent searches brand mentions across the index and states its boundaries: an empty result means «not in the index», not «nobody writes about you».

There is almost nothing to write here, and the agent does not hide it: TGStat cannot publish a post, edit a channel or message subscribers. The one changing action is adding a channel to the service index, and the agent performs it only on an explicit request. Everything else is reading: bringing your own channels into a single report and comparing other people's by subscribers, reach and ERR when picking placement slots.

How much comes back is bounded by the request quota, and the agent budgets it in advance: it checks the remaining quota before searching, splits a long period into date windows and fetches posts and mentions page by page rather than in one sweep. A repeated question about the same channel does not cost a second request while the numbers have not moved. The agent holds the request rate within the limit, and if there is no data it says so directly instead of showing an empty table.