Country-specific View Counts

This query provides comprehensive performance metrics for a YouTube channel filtered by country over a specified time period. Data can be aggregated by day or month.

Example Output

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 'country==US' to retrieve data for the United States.

• You can change the country code to get data for different countries.
• Examples:
  • "country==GB" for United Kingdom
  • "country==DE" for Germany
  • "country==JP" for Japan

Columns

• Dimension: Day or month.

• Views: Total number of video views from the specified country.

• 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 from the specified country spent watching videos on the channel.

• 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 from the specified country.

Notes

• All metrics are filtered to show data only from the specified country.
• Historical data before September 2012 may calculate likes/dislikes differently.
• Additional metrics like Premium Minutes Watched, Subscribers Lost, and Playlist interactions are available but not shown by default.