Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Spotify: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Сведенияprofile | Найдите альбом или сингл в Spotify по полной ссылке: тип релиза, дату, лейбл, указанных исполнителей, обложку и список треков. | $1.39 за 1 000 запросов | Норма |
Поискsearch | Ищите в Spotify треки, исполнителей, альбомы или плейлисты по ключевому слову: название, тип, исполнители и ссылка для каждого результата, а также показатели, подходящие для его вида. | $1.39 за 1 000 запросов | Норма |
Сведения об исполнителеartist | Получите описание исполнителя Spotify, жанры, число слушателей в месяц, подписчиков и мировую позицию, а также топ-треки, топ-города и похожих исполнителей. | $1.39 за 1 000 запросов | Норма |
Трекtrack | Получите данные одного трека Spotify: исполнителей, альбом, длительность, число прослушиваний, номер трека и диска, дату выхода, лейбл и маркировку контента. | $1.39 за 1 000 запросов | Норма |
Альбомalbum | Получите тип альбома Spotify, исполнителей, дату выхода, лейбл, строку копирайта, обложку и полный список треков по ссылке, URI или ID. | $1.39 за 1 000 запросов | Норма |
Плейлистplaylist | Откройте плейлист Spotify, чтобы увидеть владельца, описание, сохранения, подписчиков, число треков и сами треки. | $1.39 за 1 000 запросов | Норма |
Подкастpodcast | Находите подкасты или отдельные выпуски в Spotify по ключевому слову: издатель, число выпусков, длительность и дата выхода, где это применимо. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Spotify?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
profileСведения Найдите альбом или сингл в Spotify по полной ссылке: тип релиза, дату, лейбл, указанных исполнителей, обложку и список треков. Эта устаревшая точка входа возвращает релизы, а не профили пользователей. Аудио не воспроизводится. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform |
searchПоиск Ищите в Spotify треки, исполнителей, альбомы или плейлисты по ключевому слову: название, тип, исполнители и ссылка для каждого результата, а также показатели, подходящие для его вида. Вид задаётся в | keyword | content_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
artistСведения об исполнителе Получите описание исполнителя Spotify, жанры, число слушателей в месяц, подписчиков и мировую позицию, а также топ-треки, топ-города и похожих исполнителей. Передайте ссылку на исполнителя, URI spotify:artist: или просто ID. Цифры являются снимком на определённый момент, а не доходом или историей. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · bio · monthly_listener_count · follower_count · world_rank · genres · image_url · header_image_url · album_count · single_count · compilation_count · top_cities · top_tracks · related_artists · platform |
trackТрек Получите данные одного трека Spotify: исполнителей, альбом, длительность, число прослушиваний, номер трека и диска, дату выхода, лейбл и маркировку контента. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · artists · album_name · duration_ms · play_count · track_number · disc_number · is_explicit · release_date · preview_url · image_url · added_at · platform · album_id · album_type · label · content_rating |
albumАльбом Получите тип альбома Spotify, исполнителей, дату выхода, лейбл, строку копирайта, обложку и полный список треков по ссылке, URI или ID. Ничего не воспроизводится, а региональные издания одной записи могут различаться. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · album_type · artists · release_date · label · copyright · track_count · image_url · tracks · platform |
playlistПлейлист Откройте плейлист Spotify, чтобы увидеть владельца, описание, сохранения, подписчиков, число треков и сами треки. Плейлист не изменяется, отдельные подписчики не называются, доступность треков не гарантируется. | url | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · name · text · owner_name · save_count · follower_count · track_count · image_url · tracks · platform |
podcastПодкаст Находите подкасты или отдельные выпуски в Spotify по ключевому слову: издатель, число выпусков, длительность и дата выхода, где это применимо. Для выпусков задайте | keyword | content_type | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform |
Что означают параметры действия profile в API Spotify?
Найдите альбом или сингл в Spotify по полной ссылке: тип релиза, дату, лейбл, указанных исполнителей, обложку и список треков. Эта устаревшая точка входа возвращает релизы, а не профили пользователей. Аудио не воспроизводится.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist). Тип входных данных должен соответствовать действию эндпоинта, подставлять один тип вместо другого нельзя. Устаревшие эндпоинты профиля принимают полные ссылки Spotify и возвращают метаданные альбомов и синглов, а не данные пользовательского аккаунта.Spotify: URL ресурсов, URI и идентификаторы пользователей не взаимозаменяемы — Официальная документация Spotify различает URL ресурсов, URI, ID и идентификаторы пользователей. Устаревшее действие `profile` принимает только полные URL истории релизов; несмотря на похожее название, оно не является официальным эндпоинтом профиля пользователя и не разбирает URI автоматически для других действий. · Проверено
Что означают параметры действия search в API Spotify?
Ищите в Spotify треки, исполнителей, альбомы или плейлисты по ключевому слову: название, тип, исполнители и ссылка для каждого результата, а также показатели, подходящие для его вида. Вид задаётся в content_type. Результаты могут различаться по регионам и не показывают динамику популярности.
keywordОбязательный- Поисковый запрос для действия search; тип сущностей задаётся content_type. В действии podcast по умолчанию ищет подкасты целиком, а не данные отдельных выпусков.
content_typeНеобязательный- Фильтрует типы каталога. Для search допустимые значения: tracks, artists, albums или playlists. Действие podcast принимает свои значения: podcasts_shows (по умолчанию) для шоу или podcast_episodes_individual_episodes для отдельных выпусков. Значения одного действия нельзя использовать в другом.Допустимые значения:
albumsartistsplayliststracks
Что означают параметры действия artist в API Spotify?
Получите описание исполнителя Spotify, жанры, число слушателей в месяц, подписчиков и мировую позицию, а также топ-треки, топ-города и похожих исполнителей. Передайте ссылку на исполнителя, URI spotify:artist: или просто ID. Цифры являются снимком на определённый момент, а не доходом или историей.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist). Тип входных данных должен соответствовать действию эндпоинта, подставлять один тип вместо другого нельзя. Устаревшие эндпоинты профиля принимают полные ссылки Spotify и возвращают метаданные альбомов и синглов, а не данные пользовательского аккаунта.Spotify: чем «ежемесячные слушатели» отличаются от «ежемесячных активных слушателей» — Spotify определяет ежемесячных слушателей как уникальных слушателей за последние 28 дней с учётом как самостоятельных прослушиваний, так и алгоритмических рекомендаций. Метрика ежемесячных активных слушателей учитывает только самостоятельные прослушивания. Поле `monthly_listener_count` на этой странице нельзя считать числом ежемесячных активных слушателей, количеством прослушиваний или числом подписчиков. · Проверено
Что означают параметры действия track в API Spotify?
Получите данные одного трека Spotify: исполнителей, альбом, длительность, число прослушиваний, номер трека и диска, дату выхода, лейбл и маркировку контента. duration_ms указан в миллисекундах; ответ не содержит аудиофайла и не подтверждает территориальные права.
urlОбязательный- Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist). Тип входных данных должен соответствовать действию эндпоинта, подставлять один тип вместо другого нельзя. Устаревшие эндпоинты профиля принимают полные ссылки Spotify и возвращают метаданные альбомов и синглов, а не данные пользовательского аккаунта.Spotify: сам по себе ID не указывает тип ресурса — Официальная документация отмечает, что сам по себе ID Spotify без контекста вызова не указывает тип ресурса, тогда как URI содержит информацию о типе. Выбранное действие, путь URL и тип целевого ID должны соответствовать друг другу: строковый ID не преобразуется автоматически из одного типа ресурса в другой. · ПровереноSpotify: треки, родительские альбомы и границы использования контента — Официальная документация Spotify по трекам разделяет объекты `track` и `album` и описывает ограничения на указание авторства, скачивание и обучение моделей. Запрос метаданных через этот эндпоинт не даёт ни скачивания полного аудио, ни права на обучение ИИ; официальные поля платформы и параметры `market` не входят в этот эндпоинт автоматически. · Проверено
Что означают параметры действия album в API Spotify?
Получите тип альбома Spotify, исполнителей, дату выхода, лейбл, строку копирайта, обложку и полный список треков по ссылке, URI или ID. Ничего не воспроизводится, а региональные издания одной записи могут различаться.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist). Тип входных данных должен соответствовать действию эндпоинта, подставлять один тип вместо другого нельзя. Устаревшие эндпоинты профиля принимают полные ссылки Spotify и возвращают метаданные альбомов и синглов, а не данные пользовательского аккаунта.Spotify: сам по себе ID не указывает тип ресурса — Официальная документация отмечает, что сам по себе ID Spotify без контекста вызова не указывает тип ресурса, тогда как URI содержит информацию о типе. Выбранное действие, путь URL и тип целевого ID должны соответствовать друг другу: строковый ID не преобразуется автоматически из одного типа ресурса в другой. · Проверено
Что означают параметры действия playlist в API Spotify?
Откройте плейлист Spotify, чтобы увидеть владельца, описание, сохранения, подписчиков, число треков и сами треки. Плейлист не изменяется, отдельные подписчики не называются, доступность треков не гарантируется.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist). Тип входных данных должен соответствовать действию эндпоинта, подставлять один тип вместо другого нельзя. Устаревшие эндпоинты профиля принимают полные ссылки Spotify и возвращают метаданные альбомов и синглов, а не данные пользовательского аккаунта.Spotify: сам по себе ID не указывает тип ресурса — Официальная документация отмечает, что сам по себе ID Spotify без контекста вызова не указывает тип ресурса, тогда как URI содержит информацию о типе. Выбранное действие, путь URL и тип целевого ID должны соответствовать друг другу: строковый ID не преобразуется автоматически из одного типа ресурса в другой. · Проверено
Что означают параметры действия podcast в API Spotify?
Находите подкасты или отдельные выпуски в Spotify по ключевому слову: издатель, число выпусков, длительность и дата выхода, где это применимо. Для выпусков задайте content_type равным podcast_episodes_individual_episodes. Тип в каждой записи позволяет отличить подкасты от выпусков. Аудио не скачивается.
keywordОбязательный- Поисковый запрос для действия search; тип сущностей задаётся content_type. В действии podcast по умолчанию ищет подкасты целиком, а не данные отдельных выпусков.
content_typeНеобязательный- Фильтрует типы каталога. Для search допустимые значения: tracks, artists, albums или playlists. Действие podcast принимает свои значения: podcasts_shows (по умолчанию) для шоу или podcast_episodes_individual_episodes для отдельных выпусков. Значения одного действия нельзя использовать в другом.Допустимые значения:
podcast_episodes_individual_episodespodcasts_showsSpotify: подкаст-шоу и выпуск являются разными объектами — Официальная документация Spotify группирует выпуски на страницах соответствующих шоу и различает подписку на шоу и сохранение отдельного выпуска. Этот источник поясняет только иерархию ресурсов и не предоставляет возможностей приложения Spotify, таких как воспроизведение аудио, скачивание для офлайн-прослушивания или доступ по платной подписке. · Проверено
Как использовать API Spotify
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"spotify","action":"profile","params":{"url":"<url>"}}'
Вопросы об API Spotify
Какие данные можно получить через API Spotify?
Укажите в platform значение spotify. В текущем каталоге: сведения, поиск, сведения об исполнителе, трек, альбом и more. Эти названия действий соответствуют разным объектам или представлениям Spotify; это не взаимозаменяемые режимы поиска.
Есть ли у Spotify официальный API?
Да. Web API Spotify отдаёт метаданные каталога и данные пользователей, авторизовавших ваше приложение. Новые приложения начинают работу в Development Mode (владелец с Premium, до пяти пользователей и сокращённый набор эндпоинтов), а расширенный доступ получают только зарегистрированные организации с запущенным сервисом и не менее чем 250 000 активных пользователей в месяц.
Официальные источники: «Spotify Web API: quota modes» · «Spotify: update on developer access and platform security» · Проверено
Нужен ли аккаунт разработчика Spotify или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика Spotify, запрашивать доступ к API Spotify или входить через аккаунт Spotify. Действия возвращают только публичные данные Spotify.
Сколько стоит Spotify API за 1 000 запросов?
$1.39 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса profile к платформе Spotify?
Ссылка open.spotify.com, URI spotify:type:ID или ID сущности, соответствующие выбранному действию (artist, track, album или playlist). Тип входных данных должен соответствовать действию эндпоинта, подставлять один тип вместо другого нельзя. Устаревшие эндпоинты профиля принимают полные ссылки Spotify и возвращают метаданные альбомов и синглов, а не данные пользовательского аккаунта. Передайте это значение в поле url объекта params.
Какие поля может вернуть profile на платформе Spotify?
Объявленная схема включает name, type, release_date и label. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Spotify возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.