Skip to main content

Compare a Telegram Catalog Snapshot

POST 
/v1/catalog/snapshots/:snapshot_id/diffs

Apply the snapshot's saved filters to the current catalog and store channels added or removed relative to the original snapshot, not the previous diff. The original snapshot is not updated. Returns counts; use List diff changes with change_type=added or removed to retrieve channel IDs. Removed means no longer matching the saved result, not necessarily deleted from Telegram.

The saved baseline and current matching set must both fit the maximum from your current API plan or Subscription key settings. Larger sets return 422 without truncation. Each diff expires 30 days after its creation. Your active diff cap applies across all snapshots and is returned as active_limit by List diffs. Reaching it returns 429 DIFF_LIMIT_REACHED. Only one diff creation per user can run at a time; concurrent requests return 429 DIFF_CREATION_IN_PROGRESS. Snapshot mutation conflicts also return 429. Retry temporary conflicts after Retry-After. The source snapshot must be active. Catalog and snapshot access must both be enabled.

Request​

Responses​

Response Headers
    x-credits-cost

    Milli-credits charged for this successful request. Present for Credits API keys.

    x-credits-remaining

    Remaining milli-credit balance after this request. Present for Credits API keys.