YouTube Subscriber Count API: Rounding, Quota and Tracking

November 9, 2026

Short answer

The YouTube subscriber count API is the YouTube Data API's channels.list method, which returns statistics.subscriberCount for a channel at a cost of 1 quota unit per call. Since September 2019 the value is rounded down to three significant figures for channels above 1,000 subscribers, so 1,234,567 comes back as 1,230,000. Only the channel owner sees the exact live count, in YouTube Studio.

Getting a YouTube subscriber count by API takes one call. Understanding what the number means takes a little more, because the API rounds it, and the rounding shapes every chart you make. This guide covers the call, the rounding rule with a worked table, hidden counts, quota math for many channels, and how to track growth honestly.

The call: channels.list with part=statistics

curl "https://www.googleapis.com/youtube/v3/channels?part=statistics&forHandle=@veritasium&key=YOUR_API_KEY"

The answer holds four statistics, defined in Google's channel resource:

Field	What it is
`subscriberCount`	Subscribers, "rounded down to three significant figures", returned as a string
`hiddenSubscriberCount`	Whether the count is publicly visible
`viewCount`	Total views across the channel's videos
`videoCount`	Public videos only, "even to owners"

channels.list costs 1 unit and takes exactly one filter: id (a comma-separated list of channel ids), forHandle, forUsername or mine. Its maxResults runs from 0 to 50, so batch ids in groups of 50.

Why the YouTube API subscriber count is rounded

On 10 September 2019 Google changed the API so that subscriber counts for channels with more than 1,000 subscribers are "rounded down to three significant figures" (revision history). YouTube's help center describes the public side: for 1,000 to 9,999 subscribers, the shown count updates every 10 new subscribers, and 1,234 appears as 1.23K.

Real subscribers	API returns	Step size	Gain needed to move
987	987	1	1
1,234	1,230	10	Up to 10
45,678	45,600	100	Up to 100
1,234,567	1,230,000	10,000	Up to 10,000
12,345,678	12,300,000	100,000	Up to 100,000

The rule in one line: above 999, the step is 10 to the power of (number of digits minus 3). The real count is somewhere from the reported value up to the reported value plus the step, minus one. So a channel shown at 1,230,000 has between 1,230,000 and 1,239,999 subscribers.

def step(reported):
    return 1 if reported < 1000 else 10 ** (len(str(reported)) - 3)

def bounds(reported):
    return reported, reported + step(reported) - 1

print(bounds(1230000))   # (1230000, 1239999)

Hidden subscriber counts

Check hiddenSubscriberCount before you trust subscriberCount. TechCrunch reported in June 2022 that from 29 July 2022 YouTube channels could no longer hide their subscriber counts, a move against impersonation spam. The field remains in the API, so keep the check and treat a hidden count as unknown, never as zero.

Python: subscriber counts for many channels

import requests

KEY = "YOUR_API_KEY"
API = "https://www.googleapis.com/youtube/v3/channels"

def subscribers(channel_ids):
    out = {}
    for i in range(0, len(channel_ids), 50):
        r = requests.get(API, params={"part": "statistics", "id": ",".join(channel_ids[i:i + 50]),
                                      "maxResults": 50, "key": KEY}, timeout=30).json()
        for ch in r.get("items", []):
            s = ch["statistics"]
            out[ch["id"]] = None if s.get("hiddenSubscriberCount") else int(s["subscriberCount"])
    return out

Quota math. Each batch of up to 50 channels is 1 unit. Checking 5,000 channels daily is 100 units, 1% of the default 10,000 units a day (quota costs). If you only have handles, resolve each once with forHandle (1 unit each), store the UC id, and batch by id from then on.

Track YouTube subscriber growth

Rounding turns growth into a staircase. A channel at 1.23M gaining 300 subscribers a day shows no change for about a month, then jumps 10,000. Ways to report it honestly:

Record step changes, not daily deltas. Store the date each new step first appears. Growth rate = step size / days between steps.
Show ranges. Plot the lower and upper bounds as a band, not a single line.
Use a longer window for big channels. For channels above 1 million, monthly growth is the smallest unit that means anything.
Watch views too. Google does not describe channel viewCount as rounded, so it moves between subscriber steps. Note that Google said on 27 August 2026 that YouTube will count public views "the moment a video begins to play", so mark that date on long view charts.

Live subscriber counter sites get the same rounded figure from the API. Any number they show between steps is an estimate, not YouTube's count.

The storage rule that affects tracking

YouTube's developer policies say statistics retrieved without the channel owner's authorization "must not" be stored for more than 30 days; after that you delete or refresh them. You may show historical data if it is presented accurately for its time, and you may not replace API data with your own calculated substitutes. If you build a long history from the official API, read section III.E.4 first and keep the raw API values separate from any estimates you add.

This is not legal advice. Terms and law change, and the answer depends on where you are and what you do with the data. Our guide to the main web scraping cases has the background.

Doing it with ScrapeIO

The YouTube channel API takes an @handle, channel URL or UC id and returns followers (subscribers), posts (videos) and profile details for 1 credit, with no Google project or quota. Hidden counts come back as null, never 0. Use the YouTube channel videos API to see which uploads drove a jump. The YouTube MCP server gives AI agents the same data, and YouTube competitor analysis shows a full workflow.

FAQ

Is the YouTube subscriber count API free?

Yes. channels.list is part of the free YouTube Data API and costs 1 unit of the 10,000 units each project gets per day.

Why does the YouTube API show a rounded subscriber count?

Since September 2019 Google rounds counts above 1,000 down to three significant figures, matching the abbreviated numbers on YouTube.

Can I get the exact subscriber count of a channel?

Only the owner can, in YouTube Studio's realtime card. The Data API returns the rounded figure for every channel.

How much quota does checking subscriber counts use?

1 unit per channels.list call, and you can batch up to 50 channel ids in each call.

Can a YouTube channel hide its subscriber count?

YouTube removed that option in July 2022, according to TechCrunch. The API still has a hiddenSubscriberCount flag, so check it.

Sources

Checked on 9 November 2026 from each vendor's own pages. Prices and limits change; follow the links before you decide.

100 free credits, no card. Credits never expire.

Get API key