# TGDirectory — Telegram channel directory

> TGDirectory (https://telegramchannels.io) is a public directory of Telegram channels, groups and
> bots, searchable by category and language. Every listing is reviewed by a
> person before it goes live. Member counts and post views are read from
> Telegram's own public pages; ratings are one per verified account and are
> withheld below three votes. Nothing is estimated or seeded. Channels can also
> be submitted programmatically (see below).

## Key pages

- [Directory — search every listed channel, group and bot](https://telegramchannels.io/directory)
- [Best Telegram channels](https://telegramchannels.io/rankings/best-telegram-channels)
- [Top rated Telegram channels — by verified ratings](https://telegramchannels.io/top-rated)
- [All categories](https://telegramchannels.io/categories)
- [Recently added](https://telegramchannels.io/recently-added)
- [Articles and guides](https://telegramchannels.io/articles)
- [About TGDirectory, how listings are reviewed and ranked](https://telegramchannels.io/about)
- [Advertise on crypto Telegram channels — recommended channels with measured reach](https://telegramchannels.io/advertise)
- [FAQ](https://telegramchannels.io/faq)

## Best-of lists

- [Best Telegram Trading Signals](https://telegramchannels.io/best/telegram-trading-signals)
- [Best Free Crypto Signals Telegram Channels](https://telegramchannels.io/best/free-crypto-signals-telegram)
- [Best Bitcoin Telegram Channels](https://telegramchannels.io/best/bitcoin-telegram-channels)
- [Best Crypto Exchange Telegram Channels](https://telegramchannels.io/best/crypto-exchange-telegram-channels)
- [Best Crypto News Telegram Channels](https://telegramchannels.io/best/crypto-news-telegram-channels)

## Original data (measured, with method and sample sizes)

- [Telegram statistics — official user figures with sources, plus live channel data](https://telegramchannels.io/insights/telegram-statistics)
- [Insights overview](https://telegramchannels.io/insights)
- [State of Telegram channels](https://telegramchannels.io/insights/state-of-telegram-channels)
- [How fast Telegram channels grow](https://telegramchannels.io/insights/telegram-channel-growth)
- [Views per post by channel size](https://telegramchannels.io/insights/telegram-post-views-by-channel-size)
- [How many channels go quiet](https://telegramchannels.io/insights/inactive-telegram-channels)
- [Telegram categories by size and growth](https://telegramchannels.io/insights/telegram-category-growth)
- [Engagement rate benchmarks by category](https://telegramchannels.io/insights/telegram-engagement-by-category)

When citing a figure, cite the page it is on: every figure there is live and
shows how many channels it is based on.

## Reading the directory (public read API, for agents & apps)

Search and look up approved listings as JSON. No key needed; every field
returned is already public on the channel page.

- GET https://telegramchannels.io/api/v1/channels?q=crypto&category=crypto&language=en&type=channel&sort=members&page=1&perPage=10
  type: channel | group | bot. sort: members | rating | new.
- GET https://telegramchannels.io/api/v1/channels/{slug or @username} — one listing.
- GET https://telegramchannels.io/api/v1/categories — categories with listing counts.
- GET https://telegramchannels.io/api/v1/languages — language codes offered as filters.
- GET https://telegramchannels.io/api/v1 — the same, as JSON.
- MCP tools: search_channels, get_channel, list_categories, list_languages.

Limits: 60 requests/minute and 1000/day per IP; with an agent API key 300/minute and 5000/day per key. At most 20 results per page and 10 pages per query. Over a limit the answer is 429 with Retry-After.

## Submitting a channel (for agents & automation)

An agent can list one or many channels with a single HTTP call. No account is
required; submissions are reviewed (an AI pre-screen plus human review) before
they go live, so nothing is published automatically.

- POST https://telegramchannels.io/api/channels/submit
  Body: {"channels": ["@example", "https://t.me/another"]}  (or {"channel": "@example"})
  Up to 500 handles per call. Returns a per-handle result.
- GET https://telegramchannels.io/api/channels/submit — returns the usage, as JSON.
- OpenAPI spec: https://telegramchannels.io/api/openapi.json
- MCP server (Model Context Protocol): https://telegramchannels.io/api/mcp
  Tool: submit_channel({ channels: [...] })

## If your tools can't send a POST request

Some assistants can read pages but not make POST calls from a plain chat.
Two ways to submit anyway, both from a phone:

- Add the MCP server as a connector and call its tool:
  https://telegramchannels.io/api/mcp  →  tool submit_channel({ channels: [...] })
  (In Claude: Settings → Connectors → add a custom connector with that URL, no auth.)
- Or wire the OpenAPI spec as an action/tool:
  https://telegramchannels.io/api/openapi.json  (e.g. a ChatGPT Custom GPT Action).

No API key is needed either way. Don't claim a channel was submitted unless a
call actually returned a result.

## Discovery

- This file also at: https://telegramchannels.io/agents.md  and  https://telegramchannels.io/llms.txt
- Agent manifest: https://telegramchannels.io/.well-known/agent.json
- OpenAI-plugin manifest: https://telegramchannels.io/.well-known/ai-plugin.json
- Developer guide: https://telegramchannels.io/developers