Explore

YTMusic.get_mood_categories() → dict[str, Any]

Fetch “Moods & Genres” categories from YouTube Music.

Return type:

dict[str, Any]

Returns:

Dictionary of sections and categories.

Example:

{
    'For you': [
        {
            'params': 'ggMPOg1uX1ZwN0pHT2NBT1Fk',
            'title': '1980s'
        },
        {
            'params': 'ggMPOg1uXzZQbDB5eThLRTQ3',
            'title': 'Feel Good'
        },
        ...
    ],
    'Genres': [
        {
            'params': 'ggMPOg1uXzVLbmZnaWI4STNs',
            'title': 'Dance & Electronic'
        },
        {
            'params': 'ggMPOg1uX3NjZllsNGVEMkZo',
            'title': 'Decades'
        },
        ...
    ],
    'Moods & moments': [
        {
            'params': 'ggMPOg1uXzVuc0dnZlhpV3Ba',
            'title': 'Chill'
        },
        {
            'params': 'ggMPOg1uX2ozUHlwbWM3ajNq',
            'title': 'Commute'
        },
        ...
    ],
}

YTMusic.get_mood_playlists(params: str) → list[dict[str, Any]]

Retrieve a list of playlists for a given “Moods & Genres” category.

Parameters:

params (str) – params obtained by get_mood_categories()

Return type:

list[dict[str, Any]]

Returns:

List of playlists in the format of get_library_playlists()

YTMusic.get_charts(country: str = 'ZZ') → dict[str, Any]

Get latest charts data from YouTube Music: Artists and playlists of top videos. US charts have an extra Genres section with some Genre charts.

Parameters:

country (str) – ISO 3166-1 Alpha-2 country code. Default: ZZ = Global

Return type:

dict[str, Any]

Returns:

Dictionary containing chart video playlists (with separate daily/weekly charts if authenticated with a premium account), chart genres (US-only), and chart artists.

Example:

{
    "countries": {
        "selected": {
            "text": "United States"
        },
        "options": ["DE",
            "ZZ",
            "ZW"]
    },
    "videos": [
        {
            "title": "Daily Top Music Videos - United States",
            "playlistId": "PL4fGSI1pDJn61unMfmrUSz68RT8IFFnks",
            "thumbnails": []
        }
    ],
    "artists": [
        {
            "title": "YoungBoy Never Broke Again",
            "browseId": "UCR28YDxjDE3ogQROaNdnRbQ",
            "subscribers": "9.62M",
            "thumbnails": [],
            "rank": "1",
            "trend": "neutral"
        }
    ],
    "genres": [
        {
            "title": "Top 50 Pop Music Videos United States",
            "playlistId": "PL4fGSI1pDJn77aK7sAW2AT0oOzo5inWY8",
            "thumbnails": []
        }
    ]
}