GuideCategories: list

The YouTube Data API (v3) is an experimental API version, which means it is still in development. We'll be adding many more features to the API while it is still an experimental version. Until the experimental label is removed, however, the Deprecation Policy for YouTube APIs won't apply to this version as discussed in the API Terms of Service.

Returns a list of categories that can be associated with YouTube channels. Try it now.

Request

HTTP request

GET https://www.googleapis.com/youtube/v3/guideCategories

Parameters

Parameter name	Value	Description
Required parameters
`part`	`string`	The `part` parameter specifies a comma-separated list of one or more `guideCategory` resource properties that the API response will include. The `part` names that you can include in the parameter value are `id` and `snippet`. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in a `guideCategory` resource, the `snippet` property contains other properties, such as the category's title. If you set `part=snippet`, the API response will also contain all of those nested properties.
Filters (specify exactly one of the following parameters)
`id`	`string`	The `id` parameter specifies a comma-separated list of the YouTube channel category ID(s) for the resource(s) that are being retrieved. In a `guideCategory` resource, the `id` property specifies the YouTube channel category ID.
`regionCode`	`string`	The `regionCode` parameter instructs the API to return the list of guide categories available in the specified country. The parameter value is an ISO 3166-1 alpha-2 country code.
Optional parameters
`hl`	`string`	The `hl` parameter specifies the language that will be used for text values in the API response. The default value is `en-US`.

Request body

Do not provide a request body when calling this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "youtube#guideCategoryListResponse",
  "etag": etag,
  "items": [
    guideCategories resource
  ]
}

Properties

The following table defines the properties that appear in this resource:

Property name	Value	Description
`kind`	`string`	The type of the API response. For this operation, the value will be `youtube#guideCategoryListResponse`.
`etag`	`etag`	The ETag of the response.
`items[]`	`list`	A list of categories that can be associated with YouTube channels. In this map, the category ID is the map key, and its value is the corresponding `guideCategory` resource.

Try it!

Use the API Explorer to call this method on live data and see the API request and response.

YouTube