Поиск

class yandex_music._client.search.SearchMixin

Поиск.

Миксин для методов поиска.

search(text, nocorrect=False, type_='all', page=0, playlist_in_best=True, *args, **kwargs)

Осуществление поиска по запросу и типу, получение результатов.

Note

Известные значения для поля type_: all, artist, user, album, playlist, track, podcast, podcast_episode.

При поиске type=all не возвращаются подкасты и эпизоды. Указывайте конкретный тип для поиска.

Parameters:
  • text (str) – Текст запроса.

  • nocorrect (bool) – Если False, то ошибочный запрос будет исправлен. Например, запрос “Гражданская абарона” будет исправлен на “Гражданская оборона”.

  • type (str) – Среди какого типа искать (трек, плейлист, альбом, исполнитель, пользователь, подкаст).

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

  • playlist_in_best (bool) – Выдавать ли плейлисты лучшим вариантом поиска.

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

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

Returns:

Результаты поиска или None.

Return type:

yandex_music.Search | None

Raises:

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

search_suggest(part, *args, **kwargs)

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

Parameters:
  • part (str) – Часть поискового запроса.

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

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

Returns:

Подсказки для запроса или None.

Return type:

yandex_music.Suggestions | None

Raises:

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