getTrendingVideos

Discover popular videos by region and category using YouTube Data API v3. Filter trending content with country codes and category IDs to find what's currently popular in specific areas.

Instructions

Retrieves trending videos based on region and category. Returns a list of videos that are currently popular in the specified region and category. Use this when you want to discover what's trending in specific areas or categories. To get available category IDs and their names, use the getVideoCategories tool first.

Input Schema

Name	Required	Description	Default
`categoryId`	No	YouTube category ID to filter trending videos by category. Use getVideoCategories tool to get available category IDs.
`maxResults`	No	Maximum number of trending videos to return (1-500, default: 10)
`regionCode`	No	Two-letter country code (e.g., 'US', 'GB', 'JP'). Defaults to 'US'	US

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "categoryId": {
      "description": "YouTube category ID to filter trending videos by category. Use getVideoCategories tool to get available category IDs.",
      "type": "string"
    },
    "maxResults": {
      "default": 10,
      "description": "Maximum number of trending videos to return (1-500, default: 10)",
      "maximum": 500,
      "minimum": 1,
      "type": "number"
    },
    "regionCode": {
      "default": "US",
      "description": "Two-letter country code (e.g., 'US', 'GB', 'JP'). Defaults to 'US'",
      "maxLength": 2,
      "minLength": 2,
      "type": "string"
    }
  },
  "type": "object"
}

mcp-youtube