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"
      ]
    }
  ]
}
Example: "Views (Total)" in October, compared to September.

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:views
  • Likes (Total)

    Total number of 'likes' received on the channel's videos, shorts, or live streams during the reporting period.

    youtube:likes
  • Dislikes (Total)

    Total number of 'dislikes' received on the channel's videos, shorts, or live streams during the reporting period.

    youtube:dislikes
  • Comments (Total)

    Total number of comments received on the channel's videos, shorts, or live streams during the reporting period.

    youtube:comments
  • Shares (Total)

    Total number of times the channel's videos, shorts, or live streams were shared by viewers during the reporting period.

    youtube:shares
  • Subscribers gained (by day)

    Total number of new subscribers acquired from the channel's videos, shorts, or live streams during the reporting period.

    youtube:subscribers_gained
  • Subscribers 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_lost
  • Subscribers 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_variation
  • Estimated minutes watched (by day)

    Total time (in hours) that viewers watched the channel's videos, shorts, or live streams.

    youtube:estimated_minutes_watched
  • Average view percentage

    Average percentage of playback of videos watched on the channel, during the analyzed period.

    youtube:average_view_percentage
  • Average view duration

    The average length, in seconds, of video playbacks.

    youtube:average_view_duration
  • Channel's views

    Total number of views on the channel over time.

    youtube:view_count
  • Channel'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_count
  • Channel's videos

    Total number of videos on the channel over time.

    youtube:video_count
  • Channel's videos in period

    Total number of videos published during the analyzed period.

    youtube:video_count_in_period
  • Ad 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:impressions
  • Estimated 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_revenue
  • CTR

    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:ctr
  • Views (Shorts)

    Total number of times your shorts were viewed during the review period.

    youtube:views_shorts
  • Total time watched (Shorts)

    Total time (in hours) that users watched your shorts during the analyzed period.

    youtube:estimated_minutes_watched_shorts
  • Likes (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_shorts
  • Dislikes (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_shorts
  • Comments (Shorts)

    The number of times users commented on a short during the analyzed period.

    youtube:comments_shorts
  • Shares (Shorts)

    The number of times that users shared a short through the 'Share' button during the analyzed period.

    youtube:shares_shorts
  • Subscribers gained (Shorts)

    The number of times that users subscribed to the channel after watching a short during the analyzed period.

    youtube:subscribers_gained_shorts
  • Subscribers lost (Shorts)

    The number of times that users unsubscribed from the channel after watching a short during the analyzed period.

    youtube:subscribers_lost_shorts
  • Views (Live)

    Total number of times your live were viewed during the review period.

    youtube:views_live_stream
  • Watch Time (Live)

    Total time (in hours) that users watched your live during the analyzed period.

    youtube:estimated_minutes_watched_live_stream
  • Likes (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_stream
  • Dislikes (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_stream
  • Comments (Live)

    The number of times users commented on a live during the analyzed period.

    youtube:comments_live_stream
  • Shares (Live)

    The number of times that users shared a live through the 'Share' button during the analyzed period.

    youtube:shares_live_stream
  • Subscribers gained (Live)

    The number of times that users subscribed to the channel after watching a live during the analyzed period.

    youtube:subscribers_gained_live_stream
  • Subscribers lost (Live)

    The number of times that users unsubscribed from the channel after watching a live during the analyzed period.

    youtube:subscribers_lost_live_stream
  • Views (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_demand
  • Watch 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_demand
  • Likes (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_demand
  • Dislikes (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_demand
  • Comments (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_demand
  • Shares (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_demand
  • Subscribers 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_demand
  • Subscribers 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_day
  • Channel 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_gender
  • Viewer percentage by gender

    This graph allows you to check the percentage of views of ad videos, grouped by genre.

    youtube:views_by_gender
  • Viewer 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_videos
  • All videos in the period

    Videos posted during the analyzed period.

    youtube:all_videos
  • Views by country

    Your channel’s audience by geographic location. The data is based on the IP address.

    youtube:most_accessed_countries
  • Best 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.