Top 10 videos in a country

This query provides detailed performance metrics for your most popular YouTube videos within a specific country. Videos can be ranked by various metrics such as views, watch time, or engagement, allowing you to understand which content performs best in different regions.

Example Output

Parameters

Dimension

The dimension is set to "Video" which provides metrics aggregated by video ID.

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 views in descending order ("-views").

• Examples:
  • "-estimatedMinutesWatched" for sorting by watch time
  • "-likes" for sorting by likes
  • "-subscribersGained" for sorting by new subscribers

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

Required filter to specify the target country:

• Example: "country==TW" for Taiwan
• Can use any valid ISO country code (US, GB, DE, JP, etc.)

Maximum Results

You can retrieve up to a maximum of 200 results.

Columns

Basic Metrics

• Dimension: Video ID of the content.
• Views: Total number of video views from the specified country.
• Premium Views: Views from YouTube Premium subscribers in that country.
• Comments: Total comments added.
• Likes: Total number of likes received.
• Estimated Minutes Watched: Total watch time in minutes from viewers in the specified country.
• Average View Duration: Average length of time viewers watched the video (in minutes).
• Subscribers Gained: New subscribers gained from this video in the specified country.

Advanced Metrics

• Dislikes: Total number of dislikes received.
• Shares: Number of times the video was shared.
• Estimated Premium Minutes Watched: Watch time from Premium subscribers.
• 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.
• Annotation Close Rate: Percentage of annotations closed.

Notes

• Results are automatically sorted by views in descending order unless specified otherwise.
• All metrics are filtered to show data only from the specified country.
• Historical data before September 2012 may calculate likes/dislikes differently.