Watch Time by Country

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

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 (Optional)

Defines specific data criteria:

• Examples:
  • "country==US" to see data only from the United States
  • "country==GB" to see data only from the United Kingdom

Columns

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

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

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

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

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

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

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 which countries engage most with your content and where you might want to focus your content strategy.