TLtlmtr
Channels

Statistics

Changed on
get/v1/channel/stats

Request

Query parameters

internal_idstring required

Chat internal id

Response

Channel Statistics

internal_idstring required

Chat internal id

peer'Group' | 'Channel' required

Chat type

titlestring required

Channel name

members_countinteger required

Number of members

ads_index_grade'D' | 'D+' | 'C' | 'C+' | 'B' | 'B+' | 'A' | 'A+'

Ads index grade

err_percentnumber float nullable

ERR, views to member count ratio

err24_percentnumber float nullable

ERR24 views after 24 hours to member count ratio

premium_percentnumber float nullable

Percent of premium users

Only for telemetr.io verified channels

with_username_percentnumber float nullable

Percent of users with username

Only for telemetr.io verified channels

with_photo_percentnumber float nullable

Percent of users with photo

Only for telemetr.io verified channels

generated_atstring date-time required

Date when statistics were generated

Example response

{
  "internal_id": "1B3CMw",
  "peer": "Channel",
  "title": "Zelenskiy / Official",
  "members_count": 840943,
  "ads_index_grade": "A+",
  "engagement": {
    "reactions_avg": 544,
    "comments_avg": 34,
    "forwards_avg": 56
  },
  "gender": {
    "male_percent": 40,
    "female_percent": 60
  }
}

Changes

  • 6c2bfd66c5f2Revision changes
    • breaking

      the response's body type changed from object to no type for status

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added subschema #2 to the response body allOf list for the response status

    • info

      added subschema #2 to the response body allOf list for the response status

  • 80951ad7b3fbRevision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status