The Number You Are Refreshing Is in the Other YouTube API

September 17, 2026· Updated Platform Guides8 min read
A tired man in pyjamas sits on the edge of a bed at night, hunched over a phone in a red case, face tight with anxious hope.
TL;DR: Yes, but only through the YouTube Reporting API; the Analytics API has neither number. The Reporting API's reach reports, available since January 15, 2026, give thumbnail impressions and click-through rate per video per day, as daily CSV files from a scheduled job, typically 48 to 72 hours behind. Studio shows them soonest, within a few hours of publishing.

Twenty days in, zero impressions on longform. u/SpecialUnlikely9341 posted that to r/NewTubers(opens in new tab), and a reply of theirs further down names the feeling:

"That's my issue, its not like i want instant millions of views, but at least 100-200 testing views. It feels like this new channel is kinda shadowbanned."

This post answers a smaller question than that one: where the number you keep refreshing can be read from outside Studio, and by what.

Correction, October 9, 2026: an earlier version of this post said thumbnail impressions and click-through rate were not available through any official YouTube API, and that no tool outside Studio could show them. That was wrong. The YouTube Reporting API has carried both since January 15, 2026(opens in new tab).

YouTube has two analytics APIs, and thumbnail impressions and click-through rate are in only one of them. The Analytics API answers a query on the spot and has no metric for either. The Reporting API delivers bulk files once a day and has both. Google's overview of the two(opens in new tab) lists reach reports as bulk reports, not as query reports.

The test

On 2026-09-12 we sent three requests to reports.query(opens in new tab), the Analytics API's query method, with a valid OAuth token and the yt-analytics.readonly scope (Google's page for the method also asks for youtube.readonly), against one channel:

Table: Request, Result
RequestResult
metrics=impressions
400 — Unknown identifier (impressions)
metrics=impressionClickThroughRate
400 — Unknown identifier
metrics=views,averageViewPercentage
200, rows returned

That third row is the whole argument. It is a control: same token, same scope, same channel, same date range, same encoding. It returns data. So the two failures are not a permissions problem, not an expired credential, not a malformed request. The query method does not know those two names.

The Analytics API's metrics reference(opens in new tab) agrees. Read on 2026-10-09, it lists no metric for thumbnail impressions or for their click-through rate. (adImpressions exists and is a different quantity: advertising impressions, not thumbnail impressions.) We have not re-run the three requests since September, so read the table as a dated result.

Where the number does live

The test asked one of the two APIs. The other is the YouTube Reporting API, and its channel reports page(opens in new tab) lists two reach reports, channel_reach_basic_a1 and channel_reach_combined_a1. Both carry video_thumbnail_impressions and video_thumbnail_impressions_ctr. The basic report has one row per video per day, and the combined one adds traffic source, device type and operating system.

Google's revision history(opens in new tab) dates both reports to January 15, 2026. The Reporting API's metric definitions(opens in new tab) count an impression when a thumbnail is shown for more than 1 second with at least 50% of it on screen, which is the rule YouTube's help page(opens in new tab) gives for the number in Studio.

Getting the files takes more than one request. You create a reporting job(opens in new tab) for a report, and from then on YouTube posts one CSV file per day. For a day with no data, the file holds a header row and nothing else.

The same page says the first file can be fetched within 48 hours of creating the job, a new job also gets files for the 30 days before it, and a file stays downloadable for 60 days (30 for those earlier days). It lists the same yt-analytics.readonly scope the test used.

Table: What you want, YouTube Analytics API, YouTube Reporting API
What you wantYouTube Analytics APIYouTube Reporting API
How you ask
One request to reports.query, answered on the spotA scheduled job, then one CSV file per day
Thumbnail impressions
No such metric in the referencevideo_thumbnail_impressions
Impressions click-through rate
No such metric in the referencevideo_thumbnail_impressions_ctr
Views and watch time
views, estimatedMinutesWatchedviews, watch_time_minutes

So what is actually happening when you refresh

Studio shows you the fastest copy of the number, and there are others. YouTube's help page(opens in new tab) says the key metrics card in Studio has impressions and click-through rate within a few hours of publishing.

The API copy runs behind. Google's own example(opens in new tab) is a job scheduled on September 1: the file for that day is ready on September 3. In exchange you get a row per video per day that you can keep and chart, which no amount of refreshing gives you.

Whether a dashboard can show the number depends on which API it reads. One built only on reports.query has no impressions metric to ask for. One that schedules a reach report has it.

Studio can also hand you the report you have open as a file: Advanced Mode has an Export current view(opens in new tab) option, and the help page caps a download at 500 rows.

What this does not tell you

It does not tell you why impressions are low on a new channel. We have not tested that, nobody outside YouTube can, and the honest answer is that we do not know the mechanism.

This post is about one API we called and one whose documentation we read, not about how ranking works. We have not scheduled a reach report ourselves.

It also does not mean the number is meaningless. It means the copy a program can read is a daily file, and Google's Data Model page(opens in new tab) puts the usual processing delay for analytics data at 48 to 72 hours. That suits a weekly review better than a same-hour check.

u/RetroOne_, in the same thread(opens in new tab), described their own timeline:

"It takes longer that way. With consistency it took 4 to 8 weeks from going to no impressions to 1k-20k impression each video depending if I have a good thumbnail or not."

That is one person's experience, not a benchmark, and we would be inventing a rule if we turned it into one. But it is a useful counterweight to twenty days feeling like a verdict. The thread itself(opens in new tab) is a good picture of what that week feels like.

What to do with the metrics you can actually reach

If you want a feedback loop rather than a refresh habit, build it on what the two APIs return:

  • Average view percentage tells you whether the video holds people once they arrive. It is exportable, chartable, and comparable across your catalogue.
  • Views over time shows whether anything is compounding, which twenty days of zeroes genuinely cannot.
  • Watch time is one of the signals YouTube says its discovery system uses(opens in new tab), and one you can see moving. The Partner Program's entry thresholds are counted in subscribers plus qualified watch hours or qualified Shorts views(opens in new tab), not in impressions.
  • Thumbnail impressions and click-through rate from a reach report show whether the title and thumbnail earn the click, per video and per day.

The first three say nothing about whether your thumbnail is working. The fourth does, and YouTube's own FAQ(opens in new tab) says to read click-through rate only after a substantial number of impressions, not right after uploading. Until then, retention answers a question that matters more early on: whether the video holds people once they arrive.

Two related posts: consistency as a quality metric and what an audience actually is.

FAQ

Is my new channel shadowbanned?

We cannot answer that and neither can anyone outside YouTube. What we can say is narrower. The Analytics API has no thumbnail impressions metric for any channel, so a dashboard with no impressions column is not a sign of anything happening to yours.

Can a third-party analytics tool show me impressions?

Yes, if it reads the YouTube Reporting API: the reach reports there carry thumbnail impressions and click-through rate per video per day. A tool that only calls reports.query has no such metric to ask for. adImpressions in particular is advertising impressions and is not what Studio's thumbnail impressions mean.

Why is it in one API and not the other?

We do not know, and we are not going to guess at YouTube's reasoning. Google's overview(opens in new tab) says only this: "Data that is available in one API might not be available in the other."

What should I watch instead in the first month?

Average view percentage and watch time, because they answer whether the video works once someone arrives. Impressions tell you about the thumbnail and title, which matters. Read them on a schedule, in Studio or from a reach report, rather than on every refresh.

Twenty days of refreshing is not a feedback loop.

Comparing videos beats judging one stalled number, and that takes videos. ViralFaceless makes the Shorts, and you download and post them yourself. The numbers stay in YouTube's own tools.

See how it works

About the Author

Dmitry Vladyka
Dmitry Vladyka

Founder at Dimantika

Co-founder of Dimantika. Builds Clipwright and ViralFaceless with coding agents. Previously ran GlockSoft with a partner for about 15 years. Writes about products and finding customers.

View all posts