Search and Filter Telegram Channels with the API
The catalog combines classification, audience size and channel statistics in one filtered result. It is useful for prospecting, research and building a segment to monitor.
Access: Advanced and Team Credits API keys include catalog access. A Subscription API key requires catalog access to be enabled separately.
Build a selection
Read countries, languages and categories from /v1/dictionaries/countries, /languages and /categories. Reuse their identifiers in filters instead of guessing translated display names.
curl --fail-with-body --get "https://api.tlmtr.io/v1/catalog/search" \
-H "x-api-key: $TELEMETRIO_API_KEY" \
--data-urlencode "country=ukraine" \
--data-urlencode "members_min=1000" \
--data-urlencode "privacy=Public" \
--data-urlencode "limit=50" \
--data-urlencode "skip=0"
The response contains:
| Field | Meaning |
|---|---|
items | The current page of channels with available metadata/statistics |
count | The total matching count |
audience_count | Aggregate audience count returned for the selection |
Audience counts across channels can include the same person more than once. They are not a deduplicated count of people.
Paging and sorting
Catalog search uses limit and skip. The maximum page size is 100 and maximum skip is 1,000. Keep the same filters and sort settings while paging; live catalog data can change between calls.
Use the reference for supported sort values and filter ranges. An omitted metric can mean no data; do not silently turn it into zero in your analysis.
Cost and next steps
For Credits API keys, catalog search has an inclusive search price and does not add a new-channel charge for every catalog row. Calling channel-info endpoints to enrich the result follows their own charging rules.
To record the set matching your filters and identify later additions/removals, use snapshots and diffs. Catalog access alone does not enable snapshots for Subscription API keys.