For AI agents and assistants
This is the machine-readable way into the catalogue: the same data as on the site, without the markup. Take the JSON from the addresses below — there is no need to parse HTML.
Endpoints
| Address | Returns | Description |
|---|---|---|
| /ai/index.json | Manifest | Every address, the licence and the citation rules |
| /ai/dataset.json | Dataset | Schema.org Dataset: fields, method, coverage |
| /ai/entities.json | Objects | The whole open index in a single file |
| /ai/top.json | Top | The 100 objects with the highest score |
| /ai/categories.json | Categories | Volume, average and maximum score |
| /ai/facts.json | Facts | Summary figures with the basis stated for each |
| /ai/entity/<username>.json | Object card | A full object plus its measurement history |
| /llms.txt | llms.txt | A short map of the section |
Terms
- CC BY 4.0 licence. The data may be quoted and reused, commercial use included.
- Attribution is required: name tgsonar.com and the date from the
measured_atfield — Telegram metrics move every day, and a number without a date misleads. - Crawl rate — one request per second. The limit is technical: the site runs on shared hosting.
- Trap. The address
/crawl-trap/is disallowed in robots.txt and leads nowhere. A hit on it is logged and means the crawler does not read robots.txt. We do not block it, but it is flagged in our reports.
What you can learn here
- Медианная вовлечённость Telegram-канала в базе — 18.1%. — 9606 каналов с измеренными просмотрами
- У 1668 из 9606 каналов (17%) вовлечённость ниже 5% — типичный признак несходящихся метрик.
- 550 объектов из 11397 оказались недоступны на момент проверки.
- 724 каналов не публиковали ничего за последние 30 дней.
- Балл выставлен 7789 объектам из 11397: остальным не хватает данных — меньше 100 подписчиков или нет просмотров.
Limits of the data
We measure what Telegram shows publicly, and we say plainly what we do not know. The score is a percentile inside a category: using it to weigh a film channel against a trading channel is meaningless. For comparison across categories there are three indexes on an absolute 0–100 scale — trust, usefulness, activity — and confidence: how many independent measurements stand behind the number. One measurement is a hypothesis, not a fact, and the data says so.
What the data does not hold: the content of posts, personal details of authors, judgements about anyone's good faith. An object missing from the catalogue means nothing beyond the fact that we have not reached it yet.
Large categories
- Разное objects
- Новости objects
- IT и технологии objects
- Бизнес и маркетинг objects
- Образование и наука objects
- Финансы и инвестиции objects
- Развлечения objects
- Разное objects
Benchmarks by category — the Benchmarks section. The score formula is worked through in the methodology.