Посібник

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 дн., без картки.