Telegram Channel Catalog and Snapshots API

Advanced channel catalog search, snapshots, and diffs. A snapshot saves the channels matching filters at creation time. A diff compares the current catalog against the original snapshot, not the previous diff. Snapshots and diffs expire 30 days after their own creation. Snapshot creation and diff evaluation are bounded by your current plan or Subscription key settings and the datastore ceiling; larger results return 422 without truncation. Active-resource caps depend on your API limits: inspect active_count and active_limit in list responses. Diff caps apply across all your snapshots. Page size is 1–1000 (default 100). Catalog and snapshot access must both be enabled. Concurrent snapshot creations or concurrent diff creations for the same user return 429; honor Retry-After for temporary conflicts. Standard API request quotas, rate limits, and credit billing also apply.

📄️Filter the Telegram Channel Catalog

Search the Telegram channel catalog with classification, audience and statistics filters, sorting and paginated results.

📄️List Telegram Catalog Snapshots

List your active catalog snapshots with cursor pagination and inspect active-resource counts and limits for your API access.

📄️Create a Telegram Catalog Snapshot

Save the channels matching catalog filters as a baseline for later comparisons. Review snapshot access, capacity and creation errors.

📄️Get a Telegram Catalog Snapshot

Retrieve a saved catalog snapshot's filters, channel count, creation time and expiry by snapshot ID using the Telemetr.io API.

📄️Delete a Telegram Catalog Snapshot

Delete a catalog snapshot owned by your user and review how cascade deletion handles its dependent snapshot diffs.

📄️Compare a Telegram Catalog Snapshot

Compare current catalog matches with a saved snapshot to record added and removed channels. Inspect access limits and conflict responses.

📄️List Telegram Catalog Snapshot Diffs

List active catalog snapshot diffs, optionally filter by snapshot ID, and paginate through your stored comparisons.

📄️Get a Telegram Catalog Snapshot Diff

Retrieve a catalog diff's source snapshot, added and removed channel counts, and timestamps using its diff ID.

📄️Delete a Telegram Catalog Snapshot Diff

Delete a stored catalog diff and its change lists while retaining the original snapshot for subsequent comparisons.

📄️Read Channels Added or Removed in a Diff

Page through internal channel IDs added to or removed from a catalog selection compared with the original saved snapshot.