Viral videos by region

Learn how to retrieve a list of YouTube's viral videos based on a specified region. To get the most popular videos for a particular geographic region, you need to provide the Region Code parameter.

Parameters

Region Code

Filters the results by region. Enter the ISO 3166-1 alpha-2 country code for the region you are interested in. For example:

• US for the United States
• IN for India
• DE for Germany
• TW for Taiwan

Default value: US

For a complete list of country codes, refer to the Wikipedia country code list.

Maximum Results

Specifies the maximum number of results to return. The API natively supports 50 results for this type of query.

Note: Pagination allows Tube2Sheet to retrieve more than the 50 results natively supported by the YouTube API for this query type. When you request more than 50 results, Tube2Sheet automatically makes multiple API calls, each retrieving up to 50 results, to fulfill your request. Each of these calls counts separately against your monthly request quota, so requesting 500 results would use 10 requests from your quota.

Video Category ID

Filter video search results by category. Note that not all categories may be available in every region. Options include:

• 20: Gaming
• 21: Videoblogging
• 22: People & Blogs
• 43: Shows
• 44: Trailers

Chart

Defines the chart type for retrieving viral videos. The only acceptable value is mostPopular.

Event Type

Limit search to broadcasting events. Options include:

• Completed broadcasts
• Active broadcasts
• Upcoming broadcasts

Columns

The data returned from this query can be customized using various output columns.

Note: Click 'Show more' to display the advanced columns.

• Video ID: The unique identifier for the video.
• Channel ID: The unique identifier for the channel that uploaded the video.
• Video Title: The title of the video.
• Channel Name: The name of the channel that uploaded the video.
• Views: The number of views the video has received.
• Likes: The number of likes the video has received.
• Comments: The number of comments on the video.

Advanced Columns

These columns provide additional details and are available for more in-depth data analysis:

• eTag: Entity tag for the resource.
• Kind ID: The type of resource, e.g., "youtube#video".
• Published at: The date and time when the video was published.
• Description: A brief description of the video.
• Thumbnails: Various thumbnail URLs, widths, and heights (default, medium, high, standard, max res).
• Tags: The tags associated with the video.
• Category ID: The category of the video.
• Live Broadcast Content: Information about whether the video is a live broadcast.
• Default Language: The default language of the video.
• Localized Title: The title of the video in the localized language.
• Localized Description: The description of the video in the localized language.
• Default Audio Language: The default audio language of the video.
• Duration: The duration of the video.
• Dimension: The dimension of the video (2D or 3D).
• Definition: The definition of the video (e.g., HD or SD).
• Caption: Information about whether the video has captions.
• Licensed Content: Indicates whether the video contains licensed content.
• Region Restriction blocked: Indicates if the video is blocked in certain regions.
• Projection: The projection type of the video (e.g., 360-degree).
• Content Rating: The content rating of the video.
• Favorites: The number of times the video was marked as favorite.

---

For additional help, visit our FAQ or Troubleshooting sections.