Watch Time by Country for a Video

This query provides watch time and engagement metrics broken down by country for a specific video on your YouTube channel over a specified time period.

It differs from 'Watch Time by Country' in that a filter is set for a specific video.

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

Parameters

Dimension

The dimension is set to "Country" which provides a breakdown of metrics by viewer location.

Start Date

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

• Cannot be in the future.

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.

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)

Default sort is by estimated minutes watched in descending order ("-estimatedMinutesWatched").

• Examples:
  • "-views" for sorting by views in descending order
  • "-estimatedMinutesWatched" for sorting by watch time in descending order
  • "-averageViewPercentage" for sorting by average view percentage 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.

Columns

• Dimension: Country code (e.g., US, GB, DE, JP).

• Views: Total number of views your video received from each country.

• Estimated Minutes Watched: The estimated total number of minutes that viewers from each country spent watching your video.

• Average View Duration: Average length of time, in minutes, that viewers from each country spent watching your video.

• Average View Percentage: Average percentage of your video that viewers from each country watched.

• Subscribers Gained: Number of subscribers gained from each country through this video.

Notes

• Results are automatically sorted by watch time (estimated minutes watched) in descending order.
• Country codes follow the ISO 3166-1 alpha-2 standard (e.g., US for United States, GB for United Kingdom).
• This query is particularly useful for understanding how your video performs across different geographic regions and identifying where it resonates most with viewers.