# tgAtlas

> Every public Telegram channel worth knowing, measured weekly. Public Telegram data read live through MTProto, with an API for channel lookup, history and discovery.

## API

- [API overview](https://tgatlas.org/api): what the API returns and how it differs from the Bot API.
- [Documentation](https://tgatlas.org/docs): endpoints, pagination, errors.
- [Pricing](https://tgatlas.org/pricing): plans, the monthly request counter and the separate lookup counter.
- [Method](https://tgatlas.org/method): how the weekly snapshot is built and what "measured" means here.

## Machine-readable

- [OpenAPI specification](https://tgatlas.org/openapi.json): all paths with request and response schemas, grouped by subject.
- [Overlay](https://tgatlas.org/overlay.yaml): OpenAPI Overlay 1.0.0 on top of that specification — the two authentication headers plus response shapes taken from live calls.
- [Postman collection](https://tgatlas.org/tgatlas.postman_collection.json): all 19 requests with both RapidAPI headers, importable by URL.
- [Vocabulary](https://tgatlas.org/vocabulary.yaml): the domain in one file — entities, operations, workflows and who uses them.
- [apis.json](https://tgatlas.org/apis.json): typed index of everything the API publishes, for catalogues and agents.
- [Plans](https://tgatlas.org/plans.yaml) and [rate limits](https://tgatlas.org/rate-limits.yaml): quotas and counters as data, not prose.

## Data

- [Channels](https://tgatlas.org/channels): the directory of measured public channels.
- [Topics](https://tgatlas.org/topics): channels grouped by subject.
- [Similar channels](https://tgatlas.org/similar): Telegram's own recommendation graph, one page per seed channel.
- [Reports](https://tgatlas.org/reports): written analyses, each carrying its own measurement date.
- [Open data](https://tgatlas.org/data): what is published and what is deliberately not in it.

## Optional

- [Blog](https://tgatlas.org/blog): tutorials and write-ups.
- [Glossary](https://tgatlas.org/glossary): terms used across the site and API.
- [About](https://tgatlas.org/about): who runs this and how to reach us.