Spotify

Поиск, плейлисты, библиотека и воспроизведение Spotify

Spotify — стриминг музыки, подкастов и аудиокниг.

С Spotify в Pailot вы можете:

Искать треки, альбомы, исполнителей и плейлисты; читать карточки
Вести библиотеку (сохранённые треки, альбомы, шоу, эпизоды, аудиокниги)
Создавать и менять плейлисты, управлять подписками на исполнителей
Управлять воспроизведением: play, pause, очередь, громкость, repeat, shuffle, устройство

Нужен OAuth (вход по разрешению сервиса) Spotify. Блок ставят на холст как отдельный шаг или прикрепляют к агенту.

Инструменты

`spotify_search`

Поиск треков, альбомов, исполнителей и плейлистов.

Вход

Параметр	Тип	Обязательный	Описание
`query`	string	Да	Поисковый запрос (например "Bohemian Rhapsody", "artist:Queen", "genre:rock")
`type`	string	Нет	Тип: track, album, artist, playlist или через запятую
`limit`	number	Нет	Максимум результатов (1–50)
`offset`	number	Нет	Индекс первого результата (страница)
`market`	string	Нет	Код страны ISO 3166-1 alpha-2 (например US, GB)

Выход

Параметр	Тип	Описание
`tracks`	array	Найденные треки
↳ `id`	string	ID трека Spotify
↳ `name`	string	Название трека
↳ `artists`	array	Имена исполнителей
↳ `album`	string	Название альбома
↳ `duration_ms`	number	Длительность трека в миллисекундах
↳ `popularity`	number	Популярность (0–100)
↳ `preview_url`	string	URL 30-секундного превью
↳ `external_url`	string	Внешний URL в Spotify
`artists`	array	Найденные исполнители
`albums`	array	Найденные альбомы
`playlists`	array	Найденные плейлисты

`spotify_get_track`

Данные трека по ID.

Вход

Параметр	Тип	Обязательный	Описание
`trackId`	string	Да	ID трека Spotify
`market`	string	Нет	Код страны ISO 3166-1 alpha-2 для доступности трека

Выход

Параметр	Тип	Описание
`id`	string	ID трека Spotify
`name`	string	Название трека
`artists`	array	Исполнители
`album`	object	Данные альбома
`duration_ms`	number	Длительность трека в миллисекундах
`explicit`	boolean	В треке есть explicit-контент
`popularity`	number	Популярность (0–100)
`preview_url`	string	URL 30-секундного превью
`external_url`	string	Внешний URL в Spotify
`uri`	string	URI трека Spotify

`spotify_get_tracks`

Данные нескольких треков по ID (до 50).

Вход

Параметр	Тип	Обязательный	Описание
`trackIds`	string	Да	ID треков Spotify через запятую (макс. 50)
`market`	string	Нет	Код страны ISO 3166-1 alpha-2 для доступности трека

Выход

Параметр	Тип	Описание
`tracks`	array	Список треков
↳ `id`	string	ID трека Spotify
↳ `name`	string	Название трека
↳ `artists`	array	Исполнители
↳ `album`	object	Данные альбома
↳ `duration_ms`	number	Длительность трека в миллисекундах
↳ `explicit`	boolean	В треке есть explicit-контент
↳ `popularity`	number	Популярность (0–100)
↳ `preview_url`	string	URL 30-секундного превью
↳ `external_url`	string	Внешний URL в Spotify

`spotify_get_album`

Альбом по ID, включая список треков.

Вход

Параметр	Тип	Обязательный	Описание
`albumId`	string	Да	ID альбома Spotify
`market`	string	Нет	Код страны ISO 3166-1 alpha-2 для доступности трека

Выход

Параметр	Тип	Описание
`id`	string	ID альбома Spotify
`name`	string	Название альбома
`artists`	array	Исполнители
`album_type`	string	Тип альбома (album, single, compilation)
`total_tracks`	number	Всего треков
`release_date`	string	Дата релиза
`label`	string	Лейбл
`popularity`	number	Популярность (0–100)
`genres`	array	Жанры
`image_url`	string	URL обложки альбома
`tracks`	array	Треки альбома
`external_url`	string	Внешний URL в Spotify

`spotify_get_albums`

Несколько альбомов по ID.

Вход

Параметр	Тип	Обязательный	Описание
`albumIds`	string	Да	ID альбомов через запятую (макс. 20)
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`albums`	json	Список альбомов

`spotify_get_album_tracks`

Треки альбома.

Вход

Параметр	Тип	Обязательный	Описание
`albumId`	string	Да	The ID альбома Spotify
`limit`	number	Нет	Сколько треков вернуть (1–50)
`offset`	number	Нет	Индекс первого трека

Выход

Параметр	Тип	Описание
`tracks`	json	Список треков
`total`	number	Всего треков
`next`	string	URL следующей страницы

`spotify_get_saved_albums`

Сохранённые альбомы пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Сколько альбомов вернуть (1–50)
`offset`	number	Нет	Индекс первого альбома
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`albums`	json	Сохранённые альбомы
`total`	number	Всего сохранённых альбомов
`next`	string	URL следующей страницы

`spotify_save_albums`

Сохранить альбомы в библиотеку.

Вход

Параметр	Тип	Обязательный	Описание
`albumIds`	string	Да	ID альбомов через запятую (макс. 20)

Выход

Параметр	Тип	Описание
`success`	boolean	Альбомы сохранены

`spotify_remove_saved_albums`

Убрать альбомы из библиотеки.

Вход

Параметр	Тип	Обязательный	Описание
`albumIds`	string	Да	ID альбомов через запятую (макс. 20)

Выход

Параметр	Тип	Описание
`success`	boolean	Альбомы удалены из библиотеки

`spotify_check_saved_albums`

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

Вход

Параметр	Тип	Обязательный	Описание
`albumIds`	string	Да	ID альбомов через запятую (макс. 20)

Выход

Параметр	Тип	Описание
`results`	json	Массив boolean по каждому альбому

`spotify_get_artist`

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

Вход

Параметр	Тип	Обязательный	Описание
`artistId`	string	Да	ID исполнителя Spotify

Выход

Параметр	Тип	Описание
`id`	string	ID исполнителя Spotify
`name`	string	Имя исполнителя
`genres`	array	Жанры associated with the artist
`popularity`	number	Популярность (0–100)
`followers`	number	Число подписчиков
`image_url`	string	URL изображения исполнителя
`external_url`	string	Внешний URL в Spotify

`spotify_get_artists`

Несколько исполнителей по ID.

Вход

Параметр	Тип	Обязательный	Описание
`artistIds`	string	Да	ID исполнителей через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`artists`	json	Исполнители

`spotify_get_artist_albums`

Альбомы исполнителя. Можно фильтровать по типу.

Вход

Параметр	Тип	Обязательный	Описание
`artistId`	string	Да	ID исполнителя Spotify
`include_groups`	string	Нет	Тип альбома: album, single, appears_on, compilation (через запятую)
`limit`	number	Нет	Максимум альбомов (1–50)
`offset`	number	Нет	Индекс первого альбома
`market`	string	Нет	Код страны ISO 3166-1 alpha-2

Выход

Параметр	Тип	Описание
`albums`	array	Исполнитель
↳ `id`	string	ID альбома Spotify
↳ `name`	string	Название альбома
↳ `album_type`	string	Тип (album, single, compilation)
↳ `total_tracks`	number	Число треков
↳ `release_date`	string	Дата релиза
↳ `image_url`	string	URL обложки
↳ `external_url`	string	Внешний URL в Spotify
`total`	number	Всего доступных альбомов
`next`	string	URL следующей страницы

`spotify_get_artist_top_tracks`

Топ-10 треков исполнителя.

Вход

Параметр	Тип	Обязательный	Описание
`artistId`	string	Да	ID исполнителя Spotify
`market`	string	Нет	Код страны ISO 3166-1 alpha-2 (обязателен для этого метода)

Выход

Параметр	Тип	Описание
`tracks`	array	Исполнитель
↳ `id`	string	ID трека Spotify
↳ `name`	string	Название трека
↳ `album`	object	Данные альбома
↳ `duration_ms`	number	Длительность трека в миллисекундах
↳ `popularity`	number	Популярность (0–100)
↳ `preview_url`	string	URL 30-секундного превью
↳ `external_url`	string	Внешний URL в Spotify

`spotify_follow_artists`

Подписаться на исполнителей.

Вход

Параметр	Тип	Обязательный	Описание
`artistIds`	string	Да	ID исполнителей для подписки (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Подписка на исполнителей успешна

`spotify_unfollow_artists`

Отписаться от исполнителей.

Вход

Параметр	Тип	Обязательный	Описание
`artistIds`	string	Да	ID исполнителей для отписки (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Отписка успешна

`spotify_get_followed_artists`

Исполнители, на которых подписан пользователь.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Сколько исполнителей вернуть (1–50)
`after`	string	Нет	Курсор страницы (ID последнего исполнителя предыдущего запроса)

Выход

Параметр	Тип	Описание
`artists`	json	Исполнители, на которых подписаны
`total`	number	Всего подписок на исполнителей
`next`	string	Курсор следующей страницы

`spotify_check_following`

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

Вход

Параметр	Тип	Обязательный	Описание
`type`	string	Да	Что проверять: artist или user
`ids`	string	Да	ID исполнителей или пользователей через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`results`	json	Массив boolean по каждому ID

`spotify_get_show`

Данные подкаста.

Вход

Параметр	Тип	Обязательный	Описание
`showId`	string	Да	ID шоу Spotify
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`id`	string	ID шоу
`name`	string	Название шоу
`description`	string	Описание шоу
`publisher`	string	Издатель
`total_episodes`	number	Всего эпизодов
`explicit`	boolean	Есть explicit-контент
`languages`	json	Языки
`image_url`	string	URL обложки
`external_url`	string	Внешний URL в Spotify

`spotify_get_shows`

Несколько подкастов по ID.

Вход

Параметр	Тип	Обязательный	Описание
`showIds`	string	Да	ID шоу через запятую (макс. 50)
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`shows`	json	Список шоу

`spotify_get_show_episodes`

Эпизоды подкаста.

Вход

Параметр	Тип	Обязательный	Описание
`showId`	string	Да	ID шоу Spotify
`limit`	number	Нет	Сколько эпизодов вернуть (1–50)
`offset`	number	Нет	Индекс первого эпизода
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`episodes`	json	Список эпизодов
`total`	number	Всего эпизодов
`next`	string	URL следующей страницы

`spotify_get_saved_shows`

Сохранённые подкасты пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Сколько шоу вернуть (1–50)
`offset`	number	Нет	Индекс первого шоу

Выход

Параметр	Тип	Описание
`shows`	json	Сохранённые шоу
`total`	number	Всего сохранённых шоу
`next`	string	URL следующей страницы

`spotify_save_shows`

Сохранить подкасты в библиотеку.

Вход

Параметр	Тип	Обязательный	Описание
`showIds`	string	Да	ID шоу через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Шоу сохранены

`spotify_remove_saved_shows`

Убрать подкасты из библиотеки.

Вход

Параметр	Тип	Обязательный	Описание
`showIds`	string	Да	ID шоу через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Шоу удалены из библиотеки

`spotify_check_saved_shows`

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

Вход

Параметр	Тип	Обязательный	Описание
`showIds`	string	Да	ID шоу через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`results`	json	Массив boolean по каждому шоу

`spotify_get_episode`

Данные эпизода подкаста.

Вход

Параметр	Тип	Обязательный	Описание
`episodeId`	string	Да	ID эпизода Spotify
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`id`	string	ID эпизода
`name`	string	Название эпизода
`description`	string	Описание эпизода
`duration_ms`	number	Длительность в мс
`release_date`	string	Дата релиза
`explicit`	boolean	Есть explicit-контент
`show`	json	Данные родительского шоу
`image_url`	string	URL обложки
`external_url`	string	Внешний URL в Spotify

`spotify_get_episodes`

Несколько эпизодов по ID.

Вход

Параметр	Тип	Обязательный	Описание
`episodeIds`	string	Да	ID эпизодов через запятую (макс. 50)
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`episodes`	json	Список эпизодов

`spotify_get_saved_episodes`

Сохранённые эпизоды пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Сколько эпизодов вернуть (1–50)
`offset`	number	Нет	Индекс первого эпизода
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`episodes`	json	Сохранённые эпизоды
`total`	number	Всего сохранённых эпизодов
`next`	string	URL следующей страницы

`spotify_save_episodes`

Сохранить эпизоды в библиотеку.

Вход

Параметр	Тип	Обязательный	Описание
`episodeIds`	string	Да	ID эпизодов через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Эпизоды сохранены

`spotify_remove_saved_episodes`

Убрать эпизоды из библиотеки.

Вход

Параметр	Тип	Обязательный	Описание
`episodeIds`	string	Да	ID эпизодов через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Эпизоды удалены из библиотеки

`spotify_check_saved_episodes`

Проверить, сохранены ли эпизоды в библиотеке.

Вход

Параметр	Тип	Обязательный	Описание
`episodeIds`	string	Да	ID эпизодов через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`results`	json	Массив boolean по каждому эпизоду

`spotify_get_audiobook`

Данные аудиокниги.

Вход

Параметр	Тип	Обязательный	Описание
`audiobookId`	string	Да	ID аудиокниги Spotify
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`id`	string	ID аудиокниги
`name`	string	Название аудиокниги
`authors`	json	Авторы
`narrators`	json	Чтецы
`publisher`	string	Издатель
`description`	string	Описание
`total_chapters`	number	Всего глав
`languages`	json	Языки
`image_url`	string	URL обложки
`external_url`	string	Внешний URL в Spotify

`spotify_get_audiobooks`

Несколько аудиокниг по ID.

Вход

Параметр	Тип	Обязательный	Описание
`audiobookIds`	string	Да	ID аудиокниг через запятую (макс. 50)
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`audiobooks`	json	Список аудиокниг

`spotify_get_audiobook_chapters`

Главы аудиокниги.

Вход

Параметр	Тип	Обязательный	Описание
`audiobookId`	string	Да	ID аудиокниги Spotify
`limit`	number	Нет	Сколько глав вернуть (1–50)
`offset`	number	Нет	Индекс первой главы
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`chapters`	json	Список глав
`total`	number	Всего глав
`next`	string	URL следующей страницы

`spotify_get_saved_audiobooks`

Сохранённые аудиокниги пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Сколько аудиокниг вернуть (1–50)
`offset`	number	Нет	Индекс первой аудиокниги

Выход

Параметр	Тип	Описание
`audiobooks`	json	Сохранённые аудиокниги
`total`	number	Всего сохранённых аудиокниг
`next`	string	URL следующей страницы

`spotify_save_audiobooks`

Сохранить аудиокниги в библиотеку.

Вход

Параметр	Тип	Обязательный	Описание
`audiobookIds`	string	Да	ID аудиокниг через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Аудиокниги сохранены

`spotify_remove_saved_audiobooks`

Убрать аудиокниги из библиотеки.

Вход

Параметр	Тип	Обязательный	Описание
`audiobookIds`	string	Да	ID аудиокниг через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Аудиокниги удалены из библиотеки

`spotify_check_saved_audiobooks`

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

Вход

Параметр	Тип	Обязательный	Описание
`audiobookIds`	string	Да	ID аудиокниг через запятую (макс. 50)

Выход

Параметр	Тип	Описание
`results`	json	Массив boolean по каждой аудиокниге

`spotify_get_playlist`

Плейлист по ID.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`market`	string	Нет	Код страны ISO 3166-1 alpha-2 для доступности трека

Выход

Параметр	Тип	Описание
`id`	string	ID плейлиста Spotify
`name`	string	Имя плейлиста
`description`	string	Описание плейлиста
`public`	boolean	Плейлист публичный
`collaborative`	boolean	Совместный плейлист
`owner`	object	Владелец плейлиста
`image_url`	string	URL обложки плейлиста
`total_tracks`	number	Всего треков
`snapshot_id`	string	ID снимка плейлиста (версия)
`external_url`	string	Внешний URL в Spotify

`spotify_get_playlist_tracks`

Треки плейлиста.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`limit`	number	Нет	Максимум треков (1–100)
`offset`	number	Нет	Индекс первого трека
`market`	string	Нет	Код страны ISO 3166-1 alpha-2 для доступности трека

Выход

Параметр	Тип	Описание
`tracks`	array	Список треков in the playlist
↳ `added_at`	string	Когда трек добавили
↳ `added_by`	string	ID пользователя who added the track
↳ `track`	object	Данные трека
`total`	number	Всего треков in playlist
`next`	string	URL следующей страницы

`spotify_get_playlist_cover`

Обложка плейлиста.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify

Выход

Параметр	Тип	Описание
`images`	json	Обложки

`spotify_get_user_playlists`

Плейлисты текущего пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Максимум плейлистов (1–50)
`offset`	number	Нет	Индекс первого плейлиста

Выход

Параметр	Тип	Описание
`playlists`	array	Пользователь
↳ `id`	string	ID плейлиста Spotify
↳ `name`	string	Имя плейлиста
↳ `description`	string	Описание плейлиста
↳ `public`	boolean	Публичный
↳ `collaborative`	boolean	Совместный
↳ `owner`	string	Отображаемое имя владельца
↳ `total_tracks`	number	Число треков
↳ `image_url`	string	URL обложки
↳ `external_url`	string	Внешний URL в Spotify
`total`	number	Всего плейлистов
`next`	string	URL следующей страницы

`spotify_create_playlist`

Создать плейлист текущего пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`name`	string	Да	Имя нового плейлиста
`description`	string	Нет	Описание плейлиста
`public`	boolean	Нет	Сделать плейлист публичным
`collaborative`	boolean	Нет	Совместный плейлист (public должно быть false)

Выход

Параметр	Тип	Описание
`id`	string	ID плейлиста Spotify
`name`	string	Имя плейлиста
`description`	string	Описание плейлиста
`public`	boolean	Плейлист публичный
`collaborative`	boolean	Совместный
`snapshot_id`	string	ID снимка плейлиста
`external_url`	string	Внешний URL в Spotify

`spotify_update_playlist`

Обновить имя, описание и видимость плейлиста.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`name`	string	Нет	Новое имя плейлиста
`description`	string	Нет	Новое описание плейлиста
`public`	boolean	Нет	Сделать плейлист публичным

Выход

Параметр	Тип	Описание
`success`	boolean	Обновление успешно

`spotify_add_playlist_cover`

Загрузить обложку плейлиста (JPEG, до 256 КБ).

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`imageBase64`	string	Да	JPEG в base64 (макс. 256 КБ)

Выход

Параметр	Тип	Описание
`success`	boolean	Загрузка успешна

`spotify_add_tracks_to_playlist`

Добавить треки в плейлист.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`uris`	string	Да	URI Spotify через запятую (например spotify:track:xxx,spotify:track:yyy)
`position`	number	Нет	Позиция вставки (с нуля). Если нет — в конец.

Выход

Параметр	Тип	Описание
`snapshot_id`	string	Новый ID снимка после изменения

`spotify_remove_tracks_from_playlist`

Убрать треки из плейлиста.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`uris`	string	Да	URI для удаления через запятую

Выход

Параметр	Тип	Описание
`snapshot_id`	string	Новый ID снимка после изменения

`spotify_reorder_playlist_items`

Переставить треки в плейлисте.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`range_start`	number	Да	Начальный индекс для перестановки
`insert_before`	number	Да	Индекс, перед которым вставить
`range_length`	number	Нет	Сколько элементов переставить
`snapshot_id`	string	Нет	ID снимка для контроля одновременных правок

Выход

Параметр	Тип	Описание
`snapshot_id`	string	Новый ID снимка плейлиста

`spotify_replace_playlist_items`

Заменить все треки плейлиста.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`uris`	string	Да	URI Spotify через запятую (макс. 100)

Выход

Параметр	Тип	Описание
`snapshot_id`	string	Новый ID снимка плейлиста

`spotify_follow_playlist`

Подписаться на плейлист (сохранить).

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`public`	boolean	Нет	Плейлист будет в публичных списках

Выход

Параметр	Тип	Описание
`success`	boolean	Подписка успешна

`spotify_unfollow_playlist`

Отписаться от плейлиста.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify

Выход

Параметр	Тип	Описание
`success`	boolean	Отписка успешна

`spotify_check_playlist_followers`

Проверить, подписаны ли пользователи на плейлист.

Вход

Параметр	Тип	Обязательный	Описание
`playlistId`	string	Да	ID плейлиста Spotify
`userIds`	string	Да	ID пользователей для проверки (макс. 5)

Выход

Параметр	Тип	Описание
`results`	json	Массив boolean по каждому пользователю

`spotify_get_current_user`

Профиль текущего пользователя.

Вход

Параметр	Тип	Обязательный	Описание

Выход

Параметр	Тип	Описание
`id`	string	ID пользователя Spotify
`display_name`	string	Отображаемое имя
`email`	string	Адрес email
`country`	string	Код страны
`product`	string	Уровень подписки (free, premium)
`followers`	number	Число подписчиков
`image_url`	string	URL аватара
`external_url`	string	URL профиля Spotify

`spotify_get_user_profile`

Профиль пользователя по ID.

Вход

Параметр	Тип	Обязательный	Описание
`userId`	string	Да	ID пользователя Spotify

Выход

Параметр	Тип	Описание
`id`	string	ID пользователя
`display_name`	string	Отображаемое имя
`followers`	number	Число подписчиков
`image_url`	string	URL аватара
`external_url`	string	Внешний URL в Spotify

`spotify_get_top_tracks`

Топ-треки текущего пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`time_range`	string	Нет	Период: short_term (~4 недели), medium_term (~6 месяцев), long_term (годы)
`limit`	number	Нет	Сколько треков вернуть (1–50)
`offset`	number	Нет	Индекс первого трека

Выход

Параметр	Тип	Описание
`tracks`	array	Пользователь
↳ `id`	string	ID трека Spotify
↳ `name`	string	Название трека
↳ `artists`	array	Исполнители
↳ `album`	object	Данные альбома
↳ `duration_ms`	number	Длительность в миллисекундах
↳ `popularity`	number	Оценка популярности
↳ `external_url`	string	Внешний URL в Spotify
`total`	number	Всего топ-треков
`next`	string	URL следующей страницы

`spotify_get_top_artists`

Топ-исполнители текущего пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`time_range`	string	Нет	Период: short_term (~4 недели), medium_term (~6 месяцев), long_term (годы)
`limit`	number	Нет	Сколько исполнителей вернуть (1–50)
`offset`	number	Нет	Индекс первого исполнителя

Выход

Параметр	Тип	Описание
`artists`	array	Пользователь
↳ `id`	string	ID исполнителя Spotify
↳ `name`	string	Имя исполнителя
↳ `genres`	array	Жанры
↳ `popularity`	number	Оценка популярности
↳ `followers`	number	Число подписчиков
↳ `image_url`	string	URL изображения исполнителя
↳ `external_url`	string	Внешний URL в Spotify
`total`	number	Всего топ-исполнителей
`next`	string	URL следующей страницы

`spotify_get_saved_tracks`

Сохранённые треки пользователя.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Сколько треков вернуть (1–50)
`offset`	number	Нет	Индекс первого трека
`market`	string	Нет	Код страны ISO 3166-1 alpha-2

Выход

Параметр	Тип	Описание
`tracks`	array	Пользователь
↳ `added_at`	string	Когда трек сохранили
↳ `track`	object	Данные трека
`total`	number	Всего сохранённых треков
`next`	string	URL следующей страницы

`spotify_save_tracks`

Сохранить треки в библиотеку.

Вход

Параметр	Тип	Обязательный	Описание
`trackIds`	string	Да	Comma-separated ID трека Spotifys to save (max 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Треки сохранены

`spotify_remove_saved_tracks`

Убрать треки из библиотеки.

Вход

Параметр	Тип	Обязательный	Описание
`trackIds`	string	Да	ID треков для удаления (макс. 50)

Выход

Параметр	Тип	Описание
`success`	boolean	Треки удалены из библиотеки

`spotify_check_saved_tracks`

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

Вход

Параметр	Тип	Обязательный	Описание
`trackIds`	string	Да	ID треков для проверки (макс. 50)

Выход

Параметр	Тип	Описание
`results`	json	ID треков и признак «в библиотеке»
`all_saved`	boolean	Все треки в библиотеке
`none_saved`	boolean	Ни один трек не в библиотеке

`spotify_get_recently_played`

Недавно прослушанные треки.

Вход

Параметр	Тип	Обязательный	Описание
`limit`	number	Нет	Сколько треков вернуть (1–50)
`after`	number	Нет	Unix-время в мс. Вернуть записи после этого курсора.
`before`	number	Нет	Unix-время в мс. Вернуть записи до этого курсора.

Выход

Параметр	Тип	Описание
`items`	array	Недавно прослушанные треки
↳ `played_at`	string	Когда трек слушали
↳ `track`	object	Данные трека
`next`	string	URL следующей страницы

`spotify_get_new_releases`

Новые альбомные релизы Spotify.

Вход

Параметр	Тип	Обязательный	Описание
`country`	string	Нет	Код страны ISO 3166-1 alpha-2 (например US, GB)
`limit`	number	Нет	Сколько релизов вернуть (1–50)
`offset`	number	Нет	Индекс первого релиза

Выход

Параметр	Тип	Описание
`albums`	json	Новые релизы
`total`	number	Всего новых релизов
`next`	string	URL следующей страницы

`spotify_get_categories`

Категории каталога Spotify.

Вход

Параметр	Тип	Обязательный	Описание
`country`	string	Нет	Код страны ISO 3166-1 alpha-2 (например US, GB)
`locale`	string	Нет	Код локали (например en_US, es_MX)
`limit`	number	Нет	Сколько категорий вернуть (1–50)

Выход

Параметр	Тип	Описание
`categories`	json	Категории каталога
`total`	number	Всего категорий

`spotify_get_markets`

Страны, где доступен Spotify.

Вход

Параметр	Тип	Обязательный	Описание

Выход

Параметр	Тип	Описание
`markets`	json	Коды стран ISO

`spotify_get_playback_state`

Текущее воспроизведение: устройство, трек, прогресс.

Вход

Параметр	Тип	Обязательный	Описание
`market`	string	Нет	Код страны ISO 3166-1 alpha-2

Выход

Параметр	Тип	Описание
`is_playing`	boolean	Воспроизведение активно
`device`	object	Активное устройство
`progress_ms`	number	Прогресс в миллисекундах
`currently_playing_type`	string	Тип воспроизводимого контента
`shuffle_state`	boolean	Перемешивание включено
`repeat_state`	string	Повтор: off, track, context
`track`	object	Текущий трек

`spotify_get_currently_playing`

Что сейчас играет.

Вход

Параметр	Тип	Обязательный	Описание
`market`	string	Нет	Код страны ISO для рынка

Выход

Параметр	Тип	Описание
`is_playing`	boolean	Воспроизведение активно
`progress_ms`	number	Позиция в треке (мс)
`track`	json	Текущий трек

`spotify_get_devices`

Устройства воспроизведения.

Вход

Параметр	Тип	Обязательный	Описание

Выход

Параметр	Тип	Описание
`devices`	array	Доступные устройства воспроизведения
↳ `id`	string	ID устройства
↳ `is_active`	boolean	Устройство активно
↳ `is_private_session`	boolean	Приватная сессия
↳ `is_restricted`	boolean	Устройство ограничено
↳ `name`	string	Имя устройства
↳ `type`	string	Тип устройства (Computer, Smartphone и т. д.)
↳ `volume_percent`	number	Текущая громкость (0–100)

`spotify_get_queue`

Очередь воспроизведения.

Вход

Параметр	Тип	Обязательный	Описание

Выход

Параметр	Тип	Описание
`currently_playing`	json	Текущий трек
`queue`	json	Треки в очереди

`spotify_play`

Запустить или продолжить воспроизведение: треки, альбомы, плейлисты.

Вход

Параметр	Тип	Обязательный	Описание
`device_id`	string	Нет	ID устройства. Если нет — активное устройство.
`context_uri`	string	Нет	URI альбома, исполнителя или плейлиста (например spotify:album:xxx)
`uris`	string	Нет	URI треков через запятую
`offset`	number	Нет	Позиция в контексте (с нуля)
`position_ms`	number	Нет	Позиция в треке (миллисекунды)

Выход

Параметр	Тип	Описание
`success`	boolean	Воспроизведение запущено

`spotify_pause`

Поставить воспроизведение на паузу.

Вход

Параметр	Тип	Обязательный	Описание
`device_id`	string	Нет	ID устройства для паузы. Если нет — активное.

Выход

Параметр	Тип	Описание
`success`	boolean	Воспроизведение на паузе

`spotify_skip_next`

Перейти к следующему треку.

Вход

Параметр	Тип	Обязательный	Описание
`device_id`	string	Нет	ID устройства. Если нет — активное.

Выход

Параметр	Тип	Описание
`success`	boolean	Переключение успешно

`spotify_skip_previous`

Перейти к предыдущему треку.

Вход

Параметр	Тип	Обязательный	Описание
`device_id`	string	Нет	ID устройства. Если нет — активное.

Выход

Параметр	Тип	Описание
`success`	boolean	Переключение успешно

`spotify_seek`

Перемотать текущий трек.

Вход

Параметр	Тип	Обязательный	Описание
`position_ms`	number	Да	Позиция перемотки в миллисекундах
`device_id`	string	Нет	Целевое устройство

Выход

Параметр	Тип	Описание
`success`	boolean	Перемотка успешна

`spotify_add_to_queue`

Добавить трек в очередь.

Вход

Параметр	Тип	Обязательный	Описание
`uri`	string	Да	URI трека (например spotify:track:xxx)
`device_id`	string	Нет	ID устройства. Если нет — активное.

Выход

Параметр	Тип	Описание
`success`	boolean	Трек добавлен в очередь

`spotify_set_volume`

Установить громкость.

Вход

Параметр	Тип	Обязательный	Описание
`volume_percent`	number	Да	Громкость (0–100)
`device_id`	string	Нет	ID устройства. Если нет — активное.

Выход

Параметр	Тип	Описание
`success`	boolean	Громкость установлена

`spotify_set_repeat`

Режим повтора.

Вход

Параметр	Тип	Обязательный	Описание
`state`	string	Да	Повтор: off, track или context
`device_id`	string	Нет	Целевое устройство

Выход

Параметр	Тип	Описание
`success`	boolean	Режим повтора установлен

`spotify_set_shuffle`

Включить или выключить перемешивание.

Вход

Параметр	Тип	Обязательный	Описание
`state`	boolean	Да	true — перемешивание, false — выкл.
`device_id`	string	Нет	Целевое устройство

Выход

Параметр	Тип	Описание
`success`	boolean	Перемешивание установлено

`spotify_transfer_playback`

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

Вход

Параметр	Тип	Обязательный	Описание
`device_id`	string	Да	ID устройства, куда перенести воспроизведение
`play`	boolean	Нет	Начать воспроизведение на новом устройстве

Выход

Параметр	Тип	Описание
`success`	boolean	Перенос успешен

SMTP Amazon SQS

На этой странице

На этой странице

Инструменты

spotify_search

spotify_get_track

spotify_get_tracks

spotify_get_album

spotify_get_albums

spotify_get_album_tracks

spotify_get_saved_albums

spotify_save_albums

spotify_remove_saved_albums

spotify_check_saved_albums

spotify_get_artist

spotify_get_artists

spotify_get_artist_albums

spotify_get_artist_top_tracks

spotify_follow_artists

spotify_unfollow_artists

spotify_get_followed_artists

spotify_check_following

spotify_get_show

spotify_get_shows

spotify_get_show_episodes

spotify_get_saved_shows

spotify_save_shows

spotify_remove_saved_shows

spotify_check_saved_shows

spotify_get_episode

spotify_get_episodes

spotify_get_saved_episodes

spotify_save_episodes

spotify_remove_saved_episodes

spotify_check_saved_episodes

spotify_get_audiobook

spotify_get_audiobooks

spotify_get_audiobook_chapters

spotify_get_saved_audiobooks

spotify_save_audiobooks

spotify_remove_saved_audiobooks

spotify_check_saved_audiobooks

spotify_get_playlist

spotify_get_playlist_tracks

spotify_get_playlist_cover

spotify_get_user_playlists

spotify_create_playlist

spotify_update_playlist

spotify_add_playlist_cover

spotify_add_tracks_to_playlist

spotify_remove_tracks_from_playlist

spotify_reorder_playlist_items

spotify_replace_playlist_items

spotify_follow_playlist

spotify_unfollow_playlist

spotify_check_playlist_followers

spotify_get_current_user

spotify_get_user_profile

spotify_get_top_tracks

spotify_get_top_artists

spotify_get_saved_tracks

spotify_save_tracks

spotify_remove_saved_tracks

spotify_check_saved_tracks

spotify_get_recently_played

spotify_get_new_releases

spotify_get_categories

spotify_get_markets

spotify_get_playback_state

spotify_get_currently_playing

spotify_get_devices

spotify_get_queue

spotify_pause

spotify_skip_next

spotify_skip_previous

spotify_add_to_queue

spotify_set_volume

spotify_set_repeat

spotify_set_shuffle

spotify_transfer_playback

Получить доступ

Копилот собирает процесс. Менеджер запускает сам. Можно поставить в контур компании.

Получить доступ