Артисты

class yandex_music._client.artists.ArtistsMixin

Артисты.

Миксин для методов, связанных с артистами.

artists(artist_ids, *args, **kwargs)

Получение исполнителя/исполнителей.

Parameters:

  • artist_ids (str | int | list из str | list из int) – Уникальный идентификатор исполнителя или исполнителей.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Исполнитель или исполнители.

Return type:

list из yandex_music.Artist

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_brief_info(artist_id, *args, **kwargs)

Получение информации об артисте.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор исполнителя.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Информация об артисте или None.

Return type:

yandex_music.BriefInfo | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_tracks(artist_id, page=0, page_size=20, *args, **kwargs)

Получение треков артиста.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • page (int, optional) – Номер страницы.

  • page_size (int, optional) – Количество треков на странице.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Страница списка треков артиста или None.

Return type:

yandex_music.ArtistsTracks | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_direct_albums(artist_id, page=0, page_size=20, sort_by='year', *args, **kwargs)

Получение альбомов артиста.

Note

Известные значения для sort_by: year, rating.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • page (int, optional) – Номер страницы.

  • page_size (int, optional) – Количество альбомов на странице.

  • sort_by (str, optional) – Параметр для сортировки.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Страница списка альбомов артиста или None.

Return type:

yandex_music.ArtistAlbums | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_similar(artist_id, *args, **kwargs)

Получение похожих артистов.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Похожие артисты или None.

Return type:

yandex_music.ArtistSimilar | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

Получение ссылок на страницы артиста.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Ссылки на страницы артиста или None.

Return type:

yandex_music.ArtistLinks | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_also_albums(artist_id, page=0, page_size=20, sort_by='year', *args, **kwargs)

Получение сборников и альбомов, в которых участвовал артист.

Note

Известные значения для sort_by: year, rating.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • page (int, optional) – Номер страницы.

  • page_size (int, optional) – Количество альбомов на странице.

  • sort_by (str, optional) – Параметр для сортировки.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Страница списка альбомов артиста или None.

Return type:

yandex_music.ArtistAlbums | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_discography_albums(artist_id, page=0, page_size=20, sort_by='year', *args, **kwargs)

Получение дискографии артиста.

Note

Известные значения для sort_by: year, rating.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • page (int, optional) – Номер страницы.

  • page_size (int, optional) – Количество альбомов на странице.

  • sort_by (str, optional) – Параметр для сортировки.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Страница списка дискографии артиста или None.

Return type:

yandex_music.ArtistAlbums | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_safe_direct_albums(artist_id, sort_by='year', sort_order='desc', limit=20, *args, **kwargs)

Получение безопасных альбомов артиста.

Note

Известные значения для sort_by: year, rating. Известные значения для sort_order: asc, desc.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • sort_by (str, optional) – Параметр для сортировки.

  • sort_order (str, optional) – Порядок сортировки.

  • limit (int, optional) – Количество альбомов.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Список альбомов артиста или None.

Return type:

yandex_music.ArtistAlbums | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_track_ids(artist_id, page=0, page_size=20, *args, **kwargs)

Получение идентификаторов треков артиста.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • page (int, optional) – Номер страницы.

  • page_size (int, optional) – Количество треков на странице.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Список идентификаторов треков.

Return type:

list из str

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_about(artist_id, *args, **kwargs)

Получение информации «Об артисте».

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Информация «Об артисте» или None.

Return type:

yandex_music.ArtistAbout | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_clips(artist_id, *args, **kwargs)

Получение клипов артиста.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Клипы артиста или None.

Return type:

yandex_music.ArtistClips | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_donation(artist_id, *args, **kwargs)

Получение информации о донатах артиста.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Информация о донатах артиста или None.

Return type:

yandex_music.ArtistDonations | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_info(artist_id, *args, **kwargs)

Получение подробной информации об артисте.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Подробная информация об артисте или None.

Return type:

yandex_music.ArtistInfo | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_skeleton(artist_id, skeleton_id='web-artist-default', *args, **kwargs)

Получение скелетона страницы артиста.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • skeleton_id (str, optional) – Идентификатор скелетона.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Скелетон страницы артиста или None.

Return type:

yandex_music.ArtistSkeleton | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.

artists_trailer(artist_id, *args, **kwargs)

Получение трейлера артиста.

Parameters:

  • artist_id (str | int) – Уникальный идентификатор артиста.

  • *args – Произвольные аргументы (будут переданы в запрос).

  • **kwargs – Произвольные именованные аргументы (будут переданы в запрос).

Returns:

Трейлер артиста или None.

Return type:

yandex_music.ArtistTrailer | None

Raises:

yandex_music.exceptions.YandexMusicError – Базовое исключение библиотеки.