Poradnik

API słuchaczy miesięcznie na Spotify: słuchacze, obserwujący, miejsce w rankingu świata i miasta według wykonawcy

Liczby pod nazwą każdego wykonawcy w aplikacji Spotify — słuchaczy miesięcznie — nie ma w Web API. Oficjalny obiekt wykonawcy zawiera co najwyżej liczbę obserwujących i wynik popularności od 0 do 100, nic więcej o odbiorcach, a Spotify oznacza oba jako przestarzałe i usunęło je dla aplikacji w trybie deweloperskim utworzonych od 11 lutego 2026. Jedno wywołanie tutaj zwraca słuchaczy, obserwujących, miejsce w rankingu świata i pięć miast, w których wykonawca jest najczęściej słuchany.

Autor: Eduardo Airaudo, opiekun API · Aktualizacja: 22 października 2026

Czego brakuje w oficjalnym obiekcie wykonawcy

GET /v1/artists/{id} w Web API Spotify zwraca followers.total, liczbę całkowitą popularity, gatunki, obrazy i nazwę — pierwsze trzy oznaczone jako przestarzałe, a obserwujący i popularność usunięte dla aplikacji w trybie deweloperskim utworzonych od 11 lutego 2026. Słuchaczy miesięcznie — liczby, którą sam Spotify umieszcza na stronie wykonawcy i którą naprawdę śledzą wytwórnie, menedżerowie i kuratorzy playlist — nie ma nigdzie w dokumentacji, a żaden zakres jej nie dodaje.

Popularność to względny, nieprzejrzysty wynik, który Spotify przelicza na nowo z ostatnich odtworzeń; nie da się jej przeliczyć na słuchaczy, porównywać między miesiącami ani wyjaśnić klientowi. Słuchacze miesięcznie to bezwzględna liczba, która rusza się razem z premierą, synchronizacją lub dodaniem do playlisty, dlatego właśnie ją wszyscy chcą znać.

/artist_overview zwraca tutaj stronę wykonawcy w takiej postaci, w jakiej renderuje ją aplikacja, razem z blokiem o odbiorcach. To samo wywołanie zawiera dyskografię, podobnych wykonawców i przypięte elementy, więc liczby o odbiorcach przychodzą z kontekstem potrzebnym do ich odczytania.

Co wraca w odpowiedzi

Na podstawie zapisanej odpowiedzi /artist_overview dla wykonawcy Arijit Singh (4YRxDV8wJFPHPTeXepOstw), zarejestrowanej: 2026-10-22. Pełny zapis jest na stronie samego endpointu.

stats.monthlyListeners
Liczba odbiorców ze strony wykonawcy: unikalni słuchacze z ostatnich 28 dni, jako liczba całkowita. 53 500 280 w zapisie.
stats.followers
Liczba obserwujących. Spotify usunęło ją z własnego obiektu wykonawcy dla aplikacji w trybie deweloperskim utworzonych od 11 lutego 2026; aplikacje z rozszerzonym limitem nadal ją dostają. 195 766 074 w zapisie.
stats.worldRank
Pozycja wykonawcy w globalnym rankingu Spotify według słuchaczy — 56 w zapisie. Brak dla wykonawców spoza rankingu.
stats.topCities.items[]
Pięć wierszy z polami city, region, country i numberOfListeners. Zapis zaczyna się od Pune, IN z liczbą słuchaczy 4 174 171, potem Delhi, New Delhi, Mumbai i Bengaluru.
profile.name
Wyświetlana nazwa. Zapis zawiera też biografię, listę externalLinks (dla tego wykonawcy pustą), przypięty element i własne playlisty wykonawcy w profile, a nie zawiera flagi weryfikacji.
discography, relatedContent
Najnowsze wydanie, albumy, single, występuje na i blok podobnych wykonawców, w tej samej odpowiedzi — jedno wywołanie obejmuje całą stronę wykonawcy.

53 500 280

stats.monthlyListeners

195 766 074

stats.followers

#56

stats.worldRank

Trzy liczby z jednego zapisu, 2026-10-22. Pokazano je, by uzmysłowić kształt odpowiedzi, a nie jako bieżące wartości — dzisiejsze dostaje się, naciskając Uruchom na stronie endpointu.

Jeden wykonawca, wsad wykonawców (limit: 10) albo ranking

/artist_overview_batch przyjmuje ID oddzielone przecinkami (limit: 10) i zwraca ten sam obiekt dla każdego wykonawcy, więc paczka o rozmiarze 10 kosztuje jedno zapytanie zamiast 10.

Według specyfikacji /top_20_by_monthly_listeners to „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”, a /top_20_by_followers to „Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. Żaden z nich nie przyjmuje parametrów.

Zapisana odpowiedź ze słuchaczami, zarejestrowana: 2026-10-22, zawiera wiersze (liczba: 50) z polami rank, artist i monthlyListeners wyrażonymi w milionach — pierwszy wiersz to Bruno Mars z wartością 128,6.

Pobieranie liczb o odbiorcach wykonawcy

ID to 22-znakowy ciąg po /artist/ w dowolnym adresie URL Spotify. Jest tylko nazwa? /search?q=&type=artists zwraca ID.

Śledzenie liczby w czasie

Spotify publikuje jedną bieżącą wartość, a nie historię. Szereg czasowy trzeba zbudować samodzielnie: wywoływać /artist_overview według harmonogramu, zapisywać stats.monthlyListeners ze znacznikiem czasu i liczyć różnice między wierszami. Codzienne zadanie dla listy wykonawców (liczba: 25) to zapytania wsadowe dziennie (liczba: 3) — zapytania miesięcznie: 90, w ramach darmowego limitu: 1000.

Aby historię prowadziło samo API, /tracking/track?spotifyType=artist&spotifyId= rejestruje wykonawcę; jego wiersze monthly_listeners_change i followers_change zbierają się w /tracking/logs, które trzeba odpytywać. Webhooki obejmują tylko zmiany playlist. Oba są w dokumentacji w grupie Tracking; to endpointy operacyjne, więc demo na tej stronie ich nie uruchamia.

Bez kodu: 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.

Pytania

Czy Web API Spotify zwraca słuchaczy miesięcznie?

Nie. Obiekt wykonawcy w dokumentacji Web API zawiera followers.total, popularność, gatunki, obrazy i nazwę. Pierwsze trzy są oznaczone jako przestarzałe, a obserwujący i popularność zostały usunięte dla aplikacji w trybie deweloperskim utworzonych od 11 lutego 2026. Słuchacze miesięcznie są widoczni w klientach Spotify, ale nie należą do udokumentowanego API i żaden zakres OAuth ich nie udostępnia.

Jak aktualna jest ta liczba?

Przeglądy wykonawców są buforowane przez około godzinę, więc odpowiedź może być opóźniona względem liczby w aplikacji Spotify do tego czasu. Parametr cache=false wymusza świeże pobranie; nagłówek X-Cache pokazuje, jak obsłużono każdą odpowiedź. Przyciski Uruchom na tej stronie przechodzą też przez własną pamięć podręczną dema, więc liczba może być tam starsza.

Czy można pobrać słuchaczy miesięcznie wielu wykonawców naraz?

Tak. GET /artist_overview_batch przyjmuje ID wykonawców oddzielone przecinkami (limit: 10) i zwraca ten sam obiekt przeglądu dla każdego, więc paczka o rozmiarze 10 kosztuje jedno zapytanie. GET /artists?ids= też przyjmuje listę, ale zwraca własny obiekt wykonawcy Spotify: bez słuchaczy miesięcznie, a dla wielu wykonawców także bez liczby obserwujących.

Czy worldRank to pozycja globalna?

To pozycja, którą Spotify samo wyświetla na stronie wykonawcy („#56 na świecie” w zapisie użytym tutaj). Wykonawcy spoza rankingu nie mają pola worldRank, więc należy traktować je jako opcjonalne.

Czym są miasta z największą liczbą słuchaczy?

stats.topCities.items wymienia pięć miast z największą liczbą słuchaczy wykonawcy, każde z polami city, region, country i numberOfListeners. To ten sam blok, który strona wykonawcy pokazuje w sekcji Informacje.

Czy można pobrać historię słuchaczy miesięcznie wykonawcy?

Nie od Spotify, które publikuje tylko bieżącą wartość. Zapisywanie liczby według harmonogramu daje historię od tego dnia; wywołania wsadowe dziennie (liczba: 3) dla listy wykonawców (liczba: 25) to zapytania miesięcznie: 90.

Jaki plan jest potrzebny?

Dowolny. Endpointy użyte w tym poradniku są w każdym planie, zarówno w RapidAPI, jak i w portalu bezpośrednim, a plany różnią się miesięcznym wolumenem. Każdy plan RapidAPI: zapytania na sekundę: 5, każdy klucz bezpośredni: 10. Darmowy plan RapidAPI: zapytania miesięcznie: 1000.

Źródła

More guides

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

Uzyskaj klucz i pobierz pierwszego wykonawcę

Te same endpointy na wszystkich trzech platformach, w różnych cenach. Darmowy plan RapidAPI: zapytania miesięcznie: 1000 — wystarczy, by codziennie śledzić listę wykonawców.

RapidAPI Apify Portal bezpośredni

Jeszcze nie pora na zakup? Uzyskaj darmowy klucz próbny: zapytania: 500, okres: 7 dni, bez karty.