Find Telegram Channels and Groups with the API

Use channel search when you have a name, username or channel link. Use the catalog to select channels by audience and statistical filters.

Search, then use the internal ID

curl --fail-with-body --get "https://api.tlmtr.io/v1/channels/search" \
  -H "x-api-key: $TELEMETRIO_API_KEY" \
  --data-urlencode "term=telegram" --data-urlencode "limit=5"

The response is an array of short results. Each contains internal_id, peer, title, members_count and verified; other metadata may be absent. Use the returned peer to distinguish channels from groups.

Store the internal_id without transforming it. It is different from a Telegram numeric ID. If you already have a Telegram ID, use /v1/utils/resolve_telegram_id; inspect tracked as well as the resolved ID.

Select the endpoint

Need	Channel	Group
Basic information	/v1/channel/info	/v1/group/info
Current statistics	/v1/channel/stats	/v1/group/stats
Publications/messages	/v1/messages/channel	/v1/messages/group

All these calls take internal_id. Set CHANNEL_ID to a result from search:

curl --fail-with-body --get "https://api.tlmtr.io/v1/channel/stats" \
  -H "x-api-key: $TELEMETRIO_API_KEY" \
  --data-urlencode "internal_id=$CHANNEL_ID"

Retrieve several channels

GET /v1/channels/info-batch accepts a comma-separated ids parameter with up to 100 internal IDs. Its response has a channels array.

curl --fail-with-body --get "https://api.tlmtr.io/v1/channels/info-batch" \
  -H "x-api-key: $TELEMETRIO_API_KEY" \
  --data-urlencode "ids=$CHANNEL_ID,$OTHER_CHANNEL_ID"

Compare returned IDs with those requested; do not assume positional correspondence. With a Credits API key, the call can charge for multiple newly accessed channels. Batch requests remain subject to both balance and unique-channel ceilings.

Access and failures

Free credits access is restricted to verified channels. History depth and monthly allowances depend on your API access. A resolved ID does not by itself grant permission to read that channel.

Use messages and search for publications, or charts and mentions for changes over time.