I18nRegions: list

Returns a list of content regions that the YouTube website supports.

Quota impact: A call to this method has a quota cost of 1 unit.

Common use cases


HTTP request

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


The following table lists the parameters that this query supports. All of the parameters listed are query parameters.

Required parameters
part string
The part parameter specifies the i18nRegion resource properties that the API response will include. Set the parameter value to snippet.
Optional parameters
hl string
The hl parameter specifies the language that should 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.


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

  "kind": "youtube#i18nRegionListResponse",
  "etag": etag,
  "items": [
    i18nRegion resource


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

kind string
Identifies the API resource's type. The value will be youtube#i18nRegionListResponse.
etag etag
The Etag of this resource.
items[] list
A list of regions where YouTube is available. In this map, the i18n region ID is the map key, and its value is the corresponding i18nRegion resource.


The API does not define any error messages that are unique to this API method. However, this method could still return general API errors listed in the error message documentation.

Try it!

Use the APIs Explorer to call this API and see the API request and response.