We are updating the Data API to match how YouTube counts views for Shorts.
Learn more
VideoCategories
Stay organized with collections
Save and categorize content based on your preferences.
A videoCategory resource identifies a category that has been or could be associated with uploaded videos.
Methods
The API supports the following methods for videoCategories resources:
- list
- Returns a list of categories that can be associated with YouTube videos.
Try it now.
Resource representation
The following JSON structure shows the format of a videoCategories resource:
{
"kind": "youtube#videoCategory",
"etag": etag,
"id": string,
"snippet": {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"title": string,
"assignable": boolean
}
}
Properties
The following table defines the properties that appear in this resource:
| Properties |
kind |
string
Identifies the API resource's type. The value will be youtube#videoCategory. |
etag |
etag
The Etag of this resource. |
id |
string
The ID that YouTube uses to uniquely identify the video category. |
snippet |
object
The snippet object contains basic details about the video category, including its title. |
snippet.channelId |
string
The YouTube channel that created the video category. |
snippet.title |
string
The video category's title. |
snippet.assignable |
boolean
Indicates whether videos can be associated with the category. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eA \u003ccode\u003evideoCategory\u003c/code\u003e resource in the YouTube API defines a category that can be associated with uploaded videos.\u003c/p\u003e\n"],["\u003cp\u003eThe API's \u003ccode\u003evideoCategories\u003c/code\u003e list method returns a list of categories applicable to YouTube videos.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003evideoCategory\u003c/code\u003e resource includes an ID, a title, and information about whether the category is assignable to videos.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003esnippet\u003c/code\u003e section within a \u003ccode\u003evideoCategory\u003c/code\u003e resource provides basic details such as the channel that created it and its title.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ekind\u003c/code\u003e property of the resource is always a string that identifies the resource type as \u003ccode\u003eyoutube#videoCategory\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `videoCategory` resource identifies video categories for YouTube uploads. The API's `videoCategories.list` method retrieves a list of these categories. Each category is represented with a unique ID, title, and the channel ID that created it. The resource also includes an `assignable` property that indicates if videos can be linked to the specific category. The resource type is identified as `youtube#videoCategory`.\n"],null,["A **videoCategory** resource identifies a category that has been or could be associated with uploaded videos.\n\nMethods\n\nThe API supports the following methods for `videoCategories` resources:\n\n[list](/youtube/v3/docs/videoCategories/list)\n: Returns a list of categories that can be associated with YouTube videos.\n [Try it now](/youtube/v3/docs/videoCategories/list#usage).\n\nResource representation\n\nThe following JSON structure shows the format of a `videoCategories` resource: \n\n```verilog\n{\n \"#kind\": \"youtube#videoCategory\",\n \"#etag\": etag,\n \"#id\": string,\n \"#snippet\": {\n \"#snippet.channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"#snippet.title\": string,\n \"#snippet.assignable\": boolean\n }\n}\n```\n\nProperties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|----------------------|-----------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#videoCategory`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the video category. |\n| `snippet` | `object` The `snippet` object contains basic details about the video category, including its title. |\n| snippet.`channelId` | `string` The YouTube channel that created the video category. |\n| snippet.`title` | `string` The video category's title. |\n| snippet.`assignable` | `boolean` Indicates whether videos can be associated with the category. |"]]
