Посібник
API слухачів за місяць у Spotify: слухачі, підписники, місце у світі та топ-міста виконавця
Число під іменем кожного виконавця в застосунку Spotify — слухачі за місяць — відсутнє у Web API. Офіційний об'єкт виконавця містить щонайбільше число підписників і оцінку популярності від 0 до 100, і більше нічого про аудиторію; обидва поля Spotify позначає як застарілі й прибрав їх для застосунків у режимі розробки, створених від 11 лютого 2026 року. Один виклик тут повертає слухачів, підписників, місце у світовому рейтингу та п'ять міст, де виконавця слухають найчастіше.
Автор: Eduardo Airaudo, мейнтейнер API · Оновлено 22 жовтня 2026 р.
Чого немає в офіційному об'єкті виконавця
GET /v1/artists/{id} у Spotify Web API повертає followers.total, ціле число popularity, жанри, зображення та ім'я — перші три позначені як застарілі, а підписники й популярність прибрані для застосунків у режимі розробки, створених від 11 лютого 2026 року. Слухачів за місяць — число, яке сам Spotify виводить на сторінці виконавця і яке насправді відстежують лейбли, менеджери та питчери плейлистів, — немає ніде в довіднику, і жодна область доступу (scope) його не додає.
Популярність — відносна, непрозора оцінка, яку Spotify перераховує за свіжими прослуховуваннями; її не можна перевести в слухачів, порівняти за місяцями чи пояснити клієнтові. Слухачі за місяць — абсолютне число, яке змінюється після релізу, синк-розміщення чи додавання до плейлиста, тому саме його й хочуть знати.
/artist_overview тут повертає сторінку виконавця в тому вигляді, в якому її показує застосунок, разом із блоком про аудиторію. Той самий виклик містить дискографію, схожих виконавців і закріплені елементи, тому числа про аудиторію приходять разом із контекстом, потрібним, щоб їх прочитати.
Що повертається
Взято із записаної відповіді /artist_overview для Arijit Singh (4YRxDV8wJFPHPTeXepOstw), знятої 2026-10-22. Повний запис — на сторінці самого ендпоінта.
- stats.monthlyListeners
- Число про аудиторію на сторінці виконавця: різні слухачі за останні 28 днів, ціле число. У записі — 53 500 280.
- stats.followers
- Число підписників. Spotify прибрав його із власного об'єкта виконавця для застосунків у режимі розробки, створених від 11 лютого 2026 року; застосунки з розширеною квотою його досі отримують. У записі — 195 766 074.
- stats.worldRank
- Місце виконавця у світовому рейтингу Spotify за слухачами — у записі 56. Відсутнє у виконавців поза набором, що ранжується.
- stats.topCities.items[]
- П'ять рядків із полями city, region, country і numberOfListeners. Запис починається з Pune, IN — слухачів: 4 174 171, далі Delhi, New Delhi, Mumbai і Bengaluru.
- profile.name
- Відображуване ім'я. У записі також є біографія, список externalLinks (для цього виконавця порожній), закріплений елемент і власні плейлисти виконавця в profile, а ознаки верифікації немає.
- discography, relatedContent
- Останній реліз, альбоми, сингли, участь в інших релізах і блок схожих виконавців — у тій самій відповіді: один виклик покриває всю сторінку виконавця.
53 500 280
stats.monthlyListeners
195 766 074
stats.followers
#56
stats.worldRank
Три числа з одного запису, 2026-10-22. Вони наведені, щоб наочно показати структуру відповіді, а не як актуальні значення: натисніть «Виконати» на сторінці ендпоінта, щоб отримати сьогоднішні.
Один виконавець, пакет до 10 або рейтинг
- Artist overviewGET /artist_overview
- Artist overview (batch)GET /artist_overview_batch
- Most-listened artists (monthly listeners)GET /top_20_by_monthly_listeners
- Most-followed artistsGET /top_20_by_followers
/artist_overview_batch приймає до 10 ID через кому й повертає такий самий об'єкт для кожного виконавця, тож пакет граничного розміру (10) — це один запит, а не 10.
Словами специфікації, /top_20_by_monthly_listeners — «Wikipedia's list of the most-streamed artists on Spotify: up to 50 rows of {rank, artist, monthlyListeners}, where monthlyListeners is in millions (129.8 means 129,800,000). Not country-specific», а /top_20_by_followers — «Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific». Жоден із них не приймає параметрів.
Записана відповідь зі слухачами, знята 2026-10-22, містить рядків: 50 з полями rank, artist і monthlyListeners у мільйонах — перший рядок: Bruno Mars, 128,6.
Отримання даних про аудиторію виконавця
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/artist_overview?id=4YRxDV8wJFPHPTeXepOstw" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
ID — це 22-символьний рядок після /artist/ у будь-якому URL Spotify. Є лише ім'я? ID поверне /search?q=&type=artists.
Відстеження числа з часом
Spotify публікує одне поточне значення, а не історію. Часовий ряд будуєте ви самі: викликайте /artist_overview за розкладом, зберігайте stats.monthlyListeners з позначкою часу й обчислюйте різницю між рядками. Щоденне завдання за списком виконавців (розмір списку — 25) — це пакетних запитів на день: 3, запитів на місяць: 90, у межах безкоштовного рівня: 1 000.
Щоб історія накопичувалася на боці API, /tracking/track?spotifyType=artist&spotifyId= реєструє виконавця; його рядки monthly_listeners_change і followers_change збираються в /tracking/logs, який ви опитуєте. Вебхуки охоплюють лише зміни плейлистів. Обидва описано в довіднику в групі Tracking; це операційні ендпоінти, тому демо на цьому сайті їх не виконує.
Без коду: Spotify Monthly Listeners Scraper (opens in a new tab) on Apify returns monthly listeners, followers, world rank and top cities for any artist. spotify-monthly-listeners (opens in a new tab) on GitHub has daily monthly listeners, followers and world rank for 500 artists, as CSV and JSON history.
Запитання
Чи повертає Spotify Web API слухачів за місяць?
Ні. В об'єкті виконавця в довіднику Web API перелічено followers.total, популярність, жанри, зображення та ім'я. Перші три позначені як застарілі, а підписники й популярність прибрані для застосунків у режимі розробки, створених від 11 лютого 2026 року. Слухачі за місяць показуються у власних клієнтах Spotify, але не входять до документованого API, і жодна область доступу OAuth їх не відкриває.
Наскільки свіже число?
Огляди виконавців кешуються приблизно на годину, тому відповідь може відставати від числа в застосунку Spotify не більше ніж на цей строк. Додайте cache=false, щоб примусово отримати свіжі дані; заголовок X-Cache показує, як було отримано кожну відповідь. Кнопки «Виконати» на цьому сайті теж проходять через власний кеш демо, тож число там може бути старішим.
Чи можна отримати слухачів за місяць одразу для багатьох виконавців?
Так. GET /artist_overview_batch приймає до 10 ID виконавців через кому й повертає для кожного такий самий об'єкт огляду, тож пакет граничного розміру (10) — це один запит. GET /artists?ids= теж приймає список, але повертає власний об'єкт виконавця Spotify: без слухачів за місяць, а у багатьох виконавців і без числа підписників.
Чи є worldRank глобальною позицією?
Це місце, яке сам Spotify показує на сторінці виконавця («№56 у світі» у використаному тут записі). У виконавців поза набором, що ранжується, поля worldRank немає, тому вважайте його необов'язковим.
Що таке топ-міста?
stats.topCities.items перелічує п'ять міст із найбільшим числом слухачів виконавця; у кожного є city, region, country і numberOfListeners. Це той самий блок, який сторінка виконавця показує в розділі «Про виконавця».
Чи можна отримати історію слухачів виконавця за місяць?
Не від Spotify: він публікує лише поточне значення. Зберігайте число за розкладом — і історія у вас від цього дня; пакетних викликів на день: 3 для списку виконавців (розмір списку — 25) — це запитів на місяць: 90.
Який тариф мені потрібен?
Будь-який. Ендпоінти з цього посібника є в кожному тарифі — і на RapidAPI, і на прямому порталі, а тарифи відрізняються місячним обсягом. Кожен тариф RapidAPI допускає запитів на секунду: 5, а кожен прямий ключ включає 10. Безкоштовний тариф RapidAPI допускає запитів на місяць: 1 000.
Джерела
- Get Artist — довідник Spotify Web API — офіційний об'єкт виконавця: підписники, популярність і жанри позначені як застарілі; поля слухачів за місяць немає.
- Зміни лютого 2026 року — довідник Spotify for Developers — підписники й популярність виконавця прибрані для застосунків у режимі розробки, створених від 11 лютого 2026 року.
- GET /artist_overview на цьому сайті — записана відповідь, на якій ґрунтується ця сторінка, повністю, з датою зйомки.
- GET /top_20_by_monthly_listeners на цьому сайті — рейтинг платформи з власним записом.
More guides
- Spotify Web API alternativeEndpoint-by-endpoint mapping from the official API, including everything Spotify removed on 27 November 2024.
- Spotify API without OAuthOne header instead of the client-credentials flow — and the things a key genuinely cannot do.
- Spotify lyrics APIWhy the Web API has no lyrics endpoint, and how to get line-synced lyrics as JSON, LRC or SRT.
- Spotify charts APIDaily Top 200 and viral charts as JSON: rank movement, stream counts, credits, and how to backfill.
- Spotify play count APILifetime streams for any track, by Spotify id or ISRC, one or a batch per call — and why a 0 means under 1,000.
- Spotify audio features API after the 2024 deprecationTempo, energy, danceability, recommendations and related artists after Spotify removed them for new apps.
- Spotify API rate limitsThe official 30-second rolling window, what each plan here allows per second and per month, and how to stay under it.
- Spotify scraper on ApifyPlay counts, charts, lyrics and credits as a scheduled run with no API key — and when an API key is the better tool.
- Spotify MCP serverPlay counts, monthly listeners and charts inside Claude, Cursor or VS Code: an open-source MCP server that runs with your own key.
What changed in the API and on these pages, and when: What's new.
Отримайте ключ і запитайте першого виконавця
Ті самі ендпоінти в усіх трьох каналах, ціни різні. Безкоштовний рівень RapidAPI: запитів на місяць — 1 000 — вистачить, щоб щодня відстежувати список виконавців.
Не готові купувати? Отримайте безкоштовний пробний ключ: запитів — 500 за 7 дн., без картки.