Appearance

Basic Metrics For A Video ​

This query provides comprehensive performance metrics for a single or multiple videos of a YouTube channel over a specified time period. Data can be aggregated by day or month.

It differs from 'Basic Metrics' in that a filter is set for a specific video or a comma-seperated list of up to 200 videos.

To retrieve data you have to replace VIDEO_ID with a video ID of a video from your channel in the filter field.

Tip: How can I find the video ID of a YouTube video?

Example Output ​

Open

Parameters ​

Dimension ​

Specifies how to aggregate the data:

  • Day: Daily aggregation.
  • Month: Monthly aggregation (requires start and end dates to be first day of a month).

Note: Note that rolling seven or thirty days are not supported by the Analytics API anymore.

Start Date ​

The beginning date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-01-01).

  • Cannot be in the future.
  • Must align with month start if using monthly dimension.

End Date ​

The end date for fetching analytics data in format YYYY-MM-DD (e.g., 2024-09-30).

  • Cannot be in the future.
  • Must be after Start Date.
  • Must align with month end if using monthly dimension.

Tip: For scheduled requests, you may need to update the date daily. Instead of specifying the date manually, you can use 'today' or 'yesterday' as the parameter. When the request runs, the date will automatically adjust to the desired day.

IDs ​

Specifies the channel for which to retrieve data.

  • Options:
    • "channel==MINE": Fetches data for your own channel.
    • "channel==CHANNEL_ID": Retrieves data for a specific channel you own.

Sort (Optional) ​

Determines the order of results:

  • Examples:

    • "-views" for sorting by views in descending order.
    • "-likes" for sorting by likes in descending order.
    • "-estimatedMinutesWatched" for sorting by estimatedMinutesWatched in descending order.

    Tip: You can find the technical names of the metrics you can sort by when you click on the chart symbol at the bottom of the Parameters section.

Filters ​

The filter is pre-set to 'video==VIDEO_ID'. Replace VIDEO_ID with the ID of a video from your channel. You can also enter a comma-seperated list of video IDs to retrieve up to 200 results.

Columns ​

  • Dimension: Day or month.

  • Views: Total number of video views.

  • Premium Views: Views from YouTube Premium subscribers. This number is included in 'Views'.

  • Comments: Total comments added.

  • Likes: The change in total likes (= 'likes added' - 'likes removed'). Before 2012/09/01, 'likes removed' were not subtracted.

  • Dislikes: The change in total dislikes (= 'dislikes added' - 'dislikes removed'). Before 2012/09/01, 'dislikes removed' were not subtracted.

  • Shares: Number of times videos were shared.

  • Estimated Minutes Watched: The estimated total number of minutes that viewers spent watching videos on the channel.

  • Estimated Premium Minutes Watched: Watch time from YouTube Premium subscribers.

  • Average View Duration: This is an important viewer engagement metric and is defined as total watch time divided by total video play count. Measured in minutes.

  • Subscribers Gained: New subscribers gained.

  • Subscribers Lost: Number of subscribers lost.

  • Videos Added to Playlists: Count of playlist additions.

  • Videos Removed from Playlists: Count of playlist removals.

  • Annotation Click Through Rate: Percentage of annotations clicked. Annotations are YouTube info cards that are clickable and displayed during the video. The boxes are clickable by the user.

  • Annotation Close Rate: Percentage of annotations closed.

Notes ​

  • Historical data before September 2012 may calculate likes/dislikes differently.
  • All metrics are returned in a single consolidated view without basic/advanced separation.

-

Copyright © 2024-present Tube2Sheet