Back to home

API Documentation

Welcome to the official ests.sctools.org API documentation and specification! This documentation is intended for developers who wish to integrate the API into their own streams or applications.

This API currently has no rate limiting in place and is openly available to all users. Please be mindful of the API's usage and do not abuse it. SCTools is not responsible for any misuse of the API.

Get channel

GET

/api/get/{id}

Get data for a specific YouTube channel ID.

Parameters

id

The YouTube channel ID to get data for. You can find this ID by going to the channel's YouTube page, going to "About", "Share", and then "Copy channel ID".

Query parameters

verbose

When set to "true", the response will include additional data

Example request

GET https://ests.sctools.org/api/get/UCX6OQ3DkcsbYNE6H8uQQuVA

Example response

{
  "info": {
    "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "name": "MrBeast",
    "avatar": "https://www.banner.tf/UCX6OQ3DkcsbYNE6H8uQQuVA",
    "country": "US"
  },
  "stats": {
    "apiCount": 300000000,
    "estCount": 300320516,
    "viewCount": 76881604277,
    "videoCount": 800
  },
  "averages": {
    "hourly": 8229,
    "daily": 422410
  },
  "nextUpdate": 1743604687604
}

Get a batch of channels

GET

/api/get/{ids}

Get data for multiple YouTube channel IDs in one request.

Parameters

ids

A comma-separated list of YouTube channel IDs to get data for. Only 50 IDs can be requested at a time.

Example request

GET https://ests.sctools.org/api/get/UCX6OQ3DkcsbYNE6H8uQQuVA,UC-lHJZR3Gqxm24_Vd_AJ5Yw

Example response

[
  {
    "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "apiCount": 300000000,
    "estCount": 300320516,
    "averages": {
      "hourly": 8229,
      "daily": 422410
    }
  },
  {
    "id": "UC-lHJZR3Gqxm24_Vd_AJ5Yw",
    "apiCount": 110000000,
    "estCount": 110839875,
    "averages": {
      "hourly": -34,
      "daily": -1011 
    }
  }
]

Get total statistics

GET

/api/stats

Get the total statistics for the SCTools estimations.

Example request

GET https://ests.sctools.org/api/stats

Example response

{
  "channels": 229,
  "updates": 19251,
  "subscribers": 10667056000
}