Руководство

API прослушиваний Spotify: число прослушиваний любого трека за всё время по ID или ISRC

Web API Spotify никогда не сообщает, сколько раз трек был воспроизведён. Ближе всего к этому популярность — оценка от 0 до 100, которая, по описанию в самом справочнике, зависит в основном от общего числа прослушиваний и помечена как устаревшая. Эти эндпоинты возвращают само число: для одного трека по ID Spotify или ISRC либо для списка треков за один вызов (до 50).

Автор: Eduardo Airaudo, сопровождающий API · Обновлено 22 октября 2026 г.

Чего нет в официальном объекте трека

GET /v1/tracks/{id} в Spotify Web API возвращает альбом, исполнителей, duration_ms, explicit, external_ids, название, popularity и ещё несколько полей. Ни одно из них не считает прослушивания. Ближе всего популярность: в справочнике Spotify это значение от 0 до 100, которое вычисляется в основном по тому, сколько прослушиваний было у трека и насколько они свежие, и помечено как устаревшее. Изменения Spotify в феврале 2026 года убрали его для приложений в режиме разработки, созданных начиная с 11 февраля 2026 года.

Оценка не заменяет счётчик. Она относительная, поэтому не складывается по альбому или каталогу, и она отдаёт предпочтение недавним прослушиваниям — тот же справочник говорит, что песни, которые много слушают сейчас, получают более высокую оценку, чем песни, которые много слушали раньше, — так что она не скажет, сколько раз трек слушали за всё время.

Словами спецификации, группа Partner этого API — «Spotify's internal (pathfinder) data, including play counts». /partner/track/count возвращает число прослушиваний одного трека за всё время, /partner/tracks/count — пакета треков сразу (до 50), а /partner/track включает его в полную запись трека.

Что возвращается

Поле за полем, как их определяют схемы ответов в спецификации. Вызов для одного трека называет число streams, пакетный — playcount.

Один трек

GET /partner/track/count

streams: Число прослушиваний за всё время, целое (int64). В спецификации может быть null, а для трека с числом прослушиваний меньше 1 000 равно 0.
spotify_track_id: ID трека в Spotify.
isrc: ISRC трека. В спецификации может быть null.
result: success или error, рядом — короткое сообщение в поле message.

Пакет

GET /partner/tracks/count

tracks[]: По одной записи на каждый запрошенный ID, в порядке запроса.
tracks[].playcount: Прослушивания за всё время (int64, может быть null); 0 для трека с числом прослушиваний меньше 1 000.
tracks[].status: ok, not_found или error; если статус error, добавляется текст в поле error.
tracks[].name: Название трека; null, если трек не найден.
tracks[].artists[]: id и name каждого исполнителя.
tracks[].releaseDate: Дата выхода альбома трека: YYYY-MM-DD или с меньшей точностью.
missing[]: Запрошенные ID, статус которых не ok.

0 означает «меньше 1 000», а не «ни разу не слушали». В спецификации сказано, что Spotify сообщает 0 для треков с числом прослушиваний меньше 1 000, поэтому храните 0 как «меньше 1 000», а не как число.

Записанный образец · получен 2026-10-22

GET /partner/track/count

{

"result": "success",

"message": "Data Retrieved.",

"spotify_track_id": "7qiZfU4dY1lWllzX7mPBI3",

"streams": 5152826895

}

Строк: 6 — тело записанного ответа целиком.

Записанный образец · получен 2026-10-22

GET /partner/tracks/count

{

"tracks": [

{

"id": "7qiZfU4dY1lWllzX7mPBI3",

"name": "Shape of You",

"artists": [

{

"id": "6eUKZXaKkcviH0Ku9w2n3V",

"name": "Ed Sheeran"

}

"playcount": 5152826895,

"releaseDate": "2017-03-03",

"status": "ok"

}

"missing": []

}

Строк: 18 — тело записанного ответа целиком.

Один трек или 50 за вызов

GET /partner/track/countTrack play count
Lifetime play count of one track, by Spotify id (spotify_track_id, or its alias id) or by isrc. Spotify reports 0 for tracks with fewer than 1,000 plays. Play counts are cached for 1 hour; for many tracks use /partner/tracks/count.
Параметрыspotify_track_id, id, isrc, cache
GET /partner/tracks/countTrack play counts (batch)
Lifetime play counts for up to 50 tracks in one call. Entries come back in request order with status ok, not_found or error; ids without a play count are also listed in missing. Each id is cached for 1 hour.
Параметрыids, cache
GET /partner/trackPartner track data
Track with its play count (data.trackUnion.playcount), album, artists and content ratings. Add slim=1 to keep only {id, uri, profile.name, visuals.avatarImage} of each artist (the full payload embeds the first artist's discography and is ~100 KB).
Параметрыid, slim, cache

/partner/tracks/count принимает до 50 ID через запятую и отвечает в том порядке, в каком вы их передали, поэтому пакет предельного размера (50) — это один запрос, а не 50.

Получение числа прослушиваний

Один трек по ID Spotify

curl -X GET \

"https://spotify-proxy.checkleaked.cc/spotify-data/partner/track/count?id=0VjIjW4GlUZAMYd2vXMi3b" \

-H "x-rapidapi-key: $SPOTIFY_API_KEY"

ID — это 22-символьная строка после /track/ в любом URL Spotify. Чтобы найти трек по ISRC, передайте isrc= вместо id=.

Треков за один вызов — до 50

curl -X GET \

"https://spotify-proxy.checkleaked.cc/spotify-data/partner/tracks/count?ids=0VjIjW4GlUZAMYd2vXMi3b%2C7qiZfU4dY1lWllzX7mPBI3" \

-H "x-rapidapi-key: $SPOTIFY_API_KEY"

Прежде чем читать число, смотрите status каждой записи. Записи возвращаются в порядке ID; запись без числа прослушиваний помечается на своём месте как not_found или error и повторно перечисляется в missing.

Прослушивания без кода

Если числа нужны для таблицы, а не для вашего кода, их в виде датасета отдают два Apify Actor от того же автора. Для запуска нужен аккаунт Apify, но не ключ API: вы вставляете ссылки и скачиваете JSON или CSV.

Spotify Play Count Scraper (откроется в новой вкладке)eduair94/spotify-play-count-scraper
Вставьте ссылки, URI или ID треков, альбомов, исполнителей или плейлистов; он возвращает по строке на каждый трек с числом прослушиваний — топ-треки или всю дискографию исполнителя, каждый трек альбома или плейлиста — и, по запросу, строку со слушателями исполнителя за месяц.
Spotify Scraper (откроется в новой вкладке)eduair94/spotify-scraper
Универсальный Actor: категорий — 61, из них про прослушивания — 5 (track_play_count, album_play_counts, artist_play_counts, artist_discography_play_counts, playlist_play_counts), а также isrc, который находит трек по ISRC вместе с числом прослушиваний.

Оба берут плату за результат по ценам на 22 октября 2026 г.: $0.001 за строку на бесплатном тарифе Apify, вплоть до $0.0006 на тарифе Gold и выше. Когда запуск выгоднее ключа, а когда нет, описано в руководстве по скраперу.

Уже накопленная история: spotify-most-streamed-songs (opens in a new tab) on GitHub has daily play counts and daily streams for 1,000 of the most-streamed songs, as CSV and JSON history.

Используйте его из ИИ-ассистента (MCP): спросите у Claude, Cursor или VS Code, сколько прослушиваний у трека, и инструмент get_track_play_count MCP-сервера Spotify вернёт числа прослушиваний за всё время из этого API. Настроить MCP-сервер.

Вопросы

Возвращает ли Spotify Web API число прослушиваний?

Нет. В объекте трека в справочнике Web API нет поля с числом прослушиваний. Ближайшее к нему поле, популярность, — это оценка от 0 до 100, которую Spotify вычисляет в основном по общему числу прослушиваний и их свежести; справочник помечает его как устаревшее, а изменения Spotify в феврале 2026 года убрали его для приложений в режиме разработки, созданных начиная с 11 февраля 2026 года.

Почему у трека 0 прослушиваний?

Потому что их меньше 1 000. В спецификации сказано, что Spotify сообщает 0 для треков с числом прослушиваний меньше 1 000, так что 0 означает «меньше 1 000», а не «ни разу не слушали».

Можно ли получить прослушивания сразу для многих треков?

Да. GET /partner/tracks/count принимает до 50 ID треков через запятую и отвечает в порядке запроса; у каждой записи статус ok, not_found или error, а ID без числа прослушиваний дополнительно перечисляются в missing. Пакет предельного размера (50) — это один запрос, а не 50.

Можно ли найти трек по ISRC?

Да. GET /partner/track/count принимает isrc вместо ID Spotify, так что каталогу, где ключом служит ISRC, не нужен предварительный поиск ID.

Насколько свежее число?

Прослушивания кэшируются на час, поэтому число, как правило, не старше этого срока. Значение X-Cache, начинающееся с STALE или FALLBACK, означает, что отдана более старая копия, потому что живой запрос был медленным или завершился ошибкой; X-Cache-Stale-Age показывает её возраст в секундах. Добавьте cache=false, чтобы получить свежее значение. Кнопки «Выполнить» на этом сайте тоже проходят через собственный кэш демо, поэтому число там может быть старше.

Можно ли получить прослушивания без написания кода?

Да, на Apify: для запуска нужен аккаунт Apify, но не ключ API. Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) принимает ссылки на треки, альбомы, исполнителей или плейлисты и возвращает по строке на каждый трек с числом прослушиваний; у Spotify Scraper (eduair94/spotify-scraper) категорий прослушиваний — 5 из 61. Оба берут плату за результат.

Какой тариф мне нужен?

Любой. Оба эндпоинта прослушиваний есть в каждом тарифе — и на RapidAPI, и на прямом портале, а тарифы различаются месячным объёмом. Каждый тариф RapidAPI допускает запросов в секунду: 5, а каждый прямой ключ включает 10. Бесплатный тариф RapidAPI допускает запросов в месяц: 1 000.

Источники

Get Track — справочник Spotify Web API — официальный объект трека: без числа прослушиваний, поле «популярность» помечено как устаревшее.
Изменения февраля 2026 года — справочник Spotify for Developers — популярность трека среди удалённых полей.
Руководство по миграции от февраля 2026 года — Spotify for Developers — кого касаются удаления: приложений в режиме разработки, новых — с 11 февраля 2026 года; приложения с расширенной квотой не затронуты.
GET /partner/track/count на этом сайте — его параметры, статусы ошибок и кнопка «Выполнить».
GET /partner/tracks/count на этом сайте — пакетный вызов, с тем же.
Spotify Play Count Scraper на Apify — путь без кода: его входные данные и цена за строку в опубликованном виде.

What changed in the API and on these pages, and when: What's new.

Получите ключ и вытяните первое число прослушиваний

Оба эндпоинта прослушиваний есть в каждом тарифе — и на RapidAPI, и на прямом портале; на Apify два Actor выше возвращают те же числа строками датасета с оплатой за результат. Бесплатный уровень RapidAPI: запросов в месяц — 1 000. Если брать пакеты по 50 за вызов, максимум значений прослушиваний — 50 000.

RapidAPI Apify Прямой портал

Не готовы покупать? Получите бесплатный пробный ключ: запросов — 500 за 7 дн., без карты.