Metrics
YouTube metrics via API
Your customer connects their YouTube account and your product queries 51 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"comparison_start": "2026-09-01",
"comparison_end": "2026-09-30",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:views",
"component": "number_v1",
"metrics": [
"views"
]
}
]
}More YouTube request examples
The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).
Chart
Subscribers gained by day
The difference in the total number of subscribers, as a result of subtracting the number of lost subscribers from the number of new subscribers for the analyzed period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:subscribers_by_day",
"component": "chart_v1",
"metrics": [
"subscribersGained"
],
"dimensions": [
"day"
]
}
]
}Table
Featured videos
Videos that had the greatest impact on your audience during the period analyzed.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:engaging_videos",
"component": "datatable_v1",
"metrics": [
"views",
"likes",
"subscribersGained",
"publishedAt"
],
"dimensions": [
"video"
]
}
]
}Number
Likes (Total)
Total number of 'likes' received on the channel's videos, shorts, or live streams during the reporting period.
POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
{
"customer_integration": "<connection uuid>",
"start": "2026-10-01",
"end": "2026-10-31",
"metrics": [
{
"id": "m1",
"reference_key": "youtube:likes",
"component": "number_v1",
"metrics": [
"likes"
]
}
]
}Numbers
42 metrics
Views (Total)
Total number of times the channel's videos, shorts, or live streams were viewed during the reporting period.
youtube:viewsLikes (Total)
Total number of 'likes' received on the channel's videos, shorts, or live streams during the reporting period.
youtube:likesDislikes (Total)
Total number of 'dislikes' received on the channel's videos, shorts, or live streams during the reporting period.
youtube:dislikesComments (Total)
Total number of comments received on the channel's videos, shorts, or live streams during the reporting period.
youtube:commentsShares (Total)
Total number of times the channel's videos, shorts, or live streams were shared by viewers during the reporting period.
youtube:sharesSubscribers gained (by day)
Total number of new subscribers acquired from the channel's videos, shorts, or live streams during the reporting period.
youtube:subscribers_gainedSubscribers Lost (Total)
Total number of subscribers who unfollowed the channel, counted from the channel's videos, shorts, or live streams during the reporting period.
youtube:subscribers_lostSubscribers in the period
Net change in subscribers. The difference between the number of new subscribers and the number of subscribers lost in the analyzed period.
youtube:subscribers_variationEstimated minutes watched (by day)
Total time (in hours) that viewers watched the channel's videos, shorts, or live streams.
youtube:estimated_minutes_watchedAverage view percentage
Average percentage of playback of videos watched on the channel, during the analyzed period.
youtube:average_view_percentageAverage view duration
The average length, in seconds, of video playbacks.
youtube:average_view_durationChannel's views
Total number of views on the channel over time.
youtube:view_countChannel's subscriptions
Total number of subscribers on the channel over time. Youtube may take some time to update this metric or even round the number, so it may be a little off from the real number.
youtube:subscriber_countChannel's videos
Total number of videos on the channel over time.
youtube:video_countChannel's videos in period
Total number of videos published during the analyzed period.
youtube:video_count_in_periodAd impressions
Number of ad impressions served on your channel's videos. Only available for monetized channels (YouTube Partner Program). This is not the thumbnail impressions shown in YouTube Studio.
youtube:impressionsEstimated revenue
Google's estimated total net revenue, including all advertising and other non-advertising sources, for the selected period and region. This revenue estimate is subject to adjustment at the end of the month and does not include advertising sold and displayed by partners.
youtube:estimed_revenueCTR
Views divided by ad impressions. Only available for monetized channels (YouTube Partner Program). This is not the thumbnail click-through rate shown in YouTube Studio.
youtube:ctrViews (Shorts)
Total number of times your shorts were viewed during the review period.
youtube:views_shortsTotal time watched (Shorts)
Total time (in hours) that users watched your shorts during the analyzed period.
youtube:estimated_minutes_watched_shortsLikes (Shorts)
The number of times that users indicated that they liked a short by giving it a positive rating during the analyzed period.
youtube:likes_shortsDislikes (Shorts)
The number of times that users indicated that they disliked a short by giving it a negative rating during the analyzed period.
youtube:dislikes_shortsComments (Shorts)
The number of times users commented on a short during the analyzed period.
youtube:comments_shortsShares (Shorts)
The number of times that users shared a short through the 'Share' button during the analyzed period.
youtube:shares_shortsSubscribers gained (Shorts)
The number of times that users subscribed to the channel after watching a short during the analyzed period.
youtube:subscribers_gained_shortsSubscribers lost (Shorts)
The number of times that users unsubscribed from the channel after watching a short during the analyzed period.
youtube:subscribers_lost_shortsViews (Live)
Total number of times your live were viewed during the review period.
youtube:views_live_streamWatch Time (Live)
Total time (in hours) that users watched your live during the analyzed period.
youtube:estimated_minutes_watched_live_streamLikes (Live)
The number of times that users indicated that they liked a live by giving it a positive rating during the analyzed period.
youtube:likes_live_streamDislikes (Live)
The number of times that users indicated that they disliked a live by giving it a negative rating during the analyzed period.
youtube:dislikes_live_streamComments (Live)
The number of times users commented on a live during the analyzed period.
youtube:comments_live_streamShares (Live)
The number of times that users shared a live through the 'Share' button during the analyzed period.
youtube:shares_live_streamSubscribers gained (Live)
The number of times that users subscribed to the channel after watching a live during the analyzed period.
youtube:subscribers_gained_live_streamSubscribers lost (Live)
The number of times that users unsubscribed from the channel after watching a live during the analyzed period.
youtube:subscribers_lost_live_streamViews (Video)
Number of times content in the "Videos" category was viewed during the period analyzed. This metric does not include views of Shorts or live streams.
youtube:views_video_on_demandWatch Time (Video)
Total time, in hours, that viewers watched content in the "Videos" category during the analyzed period. This metric does not include watch time for Shorts or live streams.
youtube:estimated_minutes_watched_video_on_demandLikes (Video)
Number of times content in the "Videos" category was "liked" during the analyzed period. This metric does not include views of Shorts or live streams.
youtube:likes_video_on_demandDislikes (Video)
Number of times content in the "Videos" category was "disliked" during the analyzed period. This metric does not include views of Shorts or live streams.
youtube:dislikes_video_on_demandComments (Video)
Number of times users commented on content in the "Videos" category during the analyzed period. This metric does not include comments on Shorts or live streams.
youtube:comments_video_on_demandShares (Video)
Number of times users shared content in the "Videos" category using the "Share" button during the analyzed period. This metric does not include shares of Shorts or live streams.
youtube:shares_video_on_demandSubscribers Gained (Video)
Total number of new subscribers acquired from content in the "Videos" category during the analyzed period. This metric does not include subscribers gained from Shorts or live streams.
youtube:subscribers_gained_video_on_demandSubscribers Lost (Video)
Total number of subscribers who unfollowed the channel as a result of content in the "Videos" category during the time period analyzed. This metric does not include subscribers lost due to Shorts or live streams.
youtube:subscribers_lost_video_on_demand
Charts
5 metrics
Subscribers gained by day
The difference in the total number of subscribers, as a result of subtracting the number of lost subscribers from the number of new subscribers for the analyzed period.
youtube:subscribers_by_dayChannel Display Time
Channel display time in hours. This includes public, private, unlisted and excluded videos.
youtube:channel_display_time% Viewers by Age and Gender
This graph shows the percentage of viewers who watched the channel's videos, grouped by age and gender.
youtube:viewers_by_age_and_genderViewer percentage by gender
This graph allows you to check the percentage of views of ad videos, grouped by genre.
youtube:views_by_genderViewer percentage by age group
This graph allows you to check the percentage of views of ad videos, grouped by age group.
youtube:views_by_age
Tables
4 metrics
Featured videos
Videos that had the greatest impact on your audience during the period analyzed.
youtube:engaging_videosAll videos in the period
Videos posted during the analyzed period.
youtube:all_videosViews by country
Your channel’s audience by geographic location. The data is based on the IP address.
youtube:most_accessed_countriesBest performing shorts
Performance of the most watched Shorts during the analyzed period.
youtube:performance_shorts
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
