Руководство

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_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.

Получение данных об аудитории исполнителя

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.

Источники

More guides

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

Получите ключ и запросите первого исполнителя

Одни и те же эндпоинты во всех трёх каналах, цены разные. Бесплатный уровень RapidAPI: запросов в месяц — 1 000 — хватит, чтобы ежедневно отслеживать список исполнителей.

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

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