Mwongozo

API ya wasikilizaji wa kila mwezi wa Spotify: wasikilizaji, wafuasi, nafasi duniani na miji inayoongoza kwa kila msanii

Namba iliyo chini ya jina la kila msanii kwenye programu ya Spotify — wasikilizaji wa kila mwezi — haimo kwenye Web API. Kitu rasmi cha msanii kina kiwango cha juu cha idadi ya wafuasi na alama ya popularity ya 0–100, hakuna kingine kuhusu hadhira, na Spotify imeviweka vyote alama ya vilivyositishwa na kuviondoa kwa programu za development mode zilizoundwa kuanzia tarehe 11 Februari 2026. Ombi moja hapa hurudisha wasikilizaji, wafuasi, nafasi duniani na miji mitano ambako msanii anachezwa zaidi.

Na Eduardo Airaudo, mtunzaji wa API · Imesasishwa 22 Oktoba 2026

Kile ambacho kitu rasmi cha msanii kinaacha

GET /v1/artists/{id} kwenye Spotify Web API hurudisha followers.total, namba nzima ya popularity, aina (genres), picha na jina — vitatu vya kwanza vimewekwa alama ya vilivyositishwa, na wafuasi na popularity viliondolewa kwa programu za development mode zilizoundwa kuanzia tarehe 11 Februari 2026. Wasikilizaji wa kila mwezi — namba ambayo Spotify yenyewe huiweka kwenye ukurasa wa msanii na ile ambayo lebo, mameneja na wapendekezaji wa orodha za kucheza huifuatilia kwa kweli — haionekani popote kwenye marejeo, na hakuna scope inayoiongeza.

Popularity ni alama ya kulinganisha, isiyo wazi, inayokokotolewa upya na Spotify kutokana na mara zilizochezwa hivi karibuni; haiwezi kubadilishwa kuwa wasikilizaji, kulinganishwa kati ya miezi, wala kuelezwa kwa mteja. Wasikilizaji wa kila mwezi ni idadi kamili inayosogea kwa kutolewa kwa wimbo, nafasi ya sync au kuongezwa kwenye orodha ya kucheza, ndiyo maana ndiyo namba ambayo watu wanaitaka.

/artist_overview hapa hurudisha ukurasa wa msanii kama programu inavyouonyesha, pamoja na sehemu ya hadhira. Ombi hilohilo hubeba diskografia, wasanii wanaohusiana na vitu vilivyobandikwa, kwa hiyo namba za hadhira huja na muktadha unaohitajika kuzisoma.

Kinachorudi

Imesomwa kutoka kwenye jibu lililorekodiwa la /artist_overview kwa Arijit Singh (4YRxDV8wJFPHPTeXepOstw), lililonaswa 2026-10-22. Rekodi kamili iko kwenye ukurasa wa endpoint yenyewe.

stats.monthlyListeners
Namba ya hadhira kwenye ukurasa wa msanii: wasikilizaji tofauti katika siku 28 zilizopita, kama namba nzima. 53,500,280 kwenye rekodi.
stats.followers
Idadi ya wafuasi. Spotify iliiondoa kwenye kitu chake cha msanii kwa programu za development mode zilizoundwa kuanzia tarehe 11 Februari 2026; programu za extended-quota bado huipata. 195,766,074 kwenye rekodi.
stats.worldRank
Nafasi ya msanii kwenye orodha ya kimataifa ya Spotify kwa wasikilizaji — 56 kwenye rekodi. Haipo kwa wasanii walio nje ya orodha iliyopangwa.
stats.topCities.items[]
Mistari mitano ya city, region, country na numberOfListeners. Rekodi inaanza na Pune, IN ikiwa na wasikilizaji 4,174,171, kisha Delhi, New Delhi, Mumbai na Bengaluru.
profile.name
Jina la kuonyeshwa. Rekodi pia ina wasifu, orodha ya externalLinks (tupu kwa msanii huyu), kitu kilichobandikwa na orodha za kucheza za msanii mwenyewe chini ya profile, na hakuna alama ya kuthibitishwa.
discography, relatedContent
Toleo la hivi karibuni, albamu, single, appears-on na sehemu ya wasanii wanaohusiana, katika jibu lilelile — ombi moja linashughulikia ukurasa mzima wa msanii.

53,500,280

stats.monthlyListeners

195,766,074

stats.followers

#56

stats.worldRank

Namba tatu kutoka rekodi moja, 2026-10-22. Zinaonyeshwa kufanya umbo liwe wazi, si kama takwimu za sasa — bonyeza Endesha kwenye ukurasa wa endpoint kupata za leo.

Msanii mmoja, wasanii 10, au orodha ya nafasi

/artist_overview_batch hupokea hadi ID 10 zilizotenganishwa kwa koma na hurudisha kitu kilekile kwa kila msanii, kwa hiyo wasanii 10 wanagharimu ombi moja badala ya maombi 10.

Kwa maneno ya spec, /top_20_by_monthly_listeners ni “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” na /top_20_by_followers ni “Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. Hakuna inayopokea kigezo.

Jibu lililorekodiwa la wasikilizaji, lililonaswa 2026-10-22, lina mistari 50 ya rank, artist na monthlyListeners kwa mamilioni — mstari wa kwanza unamsoma Bruno Mars kwa 128.6.

Pata namba za hadhira za msanii

ID ni mfuatano wa herufi 22 baada ya /artist/ kwenye URL yoyote ya Spotify. Una jina badala yake? /search?q=&type=artists hurudisha ID.

Kufuatilia namba kadri muda unavyopita

Spotify huchapisha thamani moja ya sasa, si historia. Mfululizo wa muda ni wako kuujenga: ita /artist_overview kwa ratiba, hifadhi stats.monthlyListeners pamoja na muhuri wa muda, kisha toa tofauti kati ya mistari. Kazi ya kila siku kwa orodha ya wasanii 25 ni maombi 3 ya kundi kwa siku — maombi 90 kwa mwezi, ndani ya 1,000 za kiwango cha bure.

Ili API ihifadhi historia, /tracking/track?spotifyType=artist&spotifyId= husajili msanii; mistari yake ya monthly_listeners_change na followers_change hukusanywa kwenye /tracking/logs, unayoiuliza mara kwa mara. Webhook hushughulikia mabadiliko ya orodha za kucheza pekee. Zote mbili ziko kwenye marejeo chini ya Tracking; ni endpoint za uendeshaji, kwa hiyo onyesho la tovuti hii haziendeshi.

Bila msimbo: 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.

Maswali

Je, Spotify Web API hurudisha wasikilizaji wa kila mwezi?

Hapana. Kitu cha msanii kwenye marejeo ya Web API kinaorodhesha followers.total, popularity, aina, picha na jina. Vitatu vya kwanza vimewekwa alama ya vilivyositishwa, na wafuasi na popularity viliondolewa kwa programu za development mode zilizoundwa kuanzia tarehe 11 Februari 2026. Wasikilizaji wa kila mwezi huonyeshwa kwenye programu za Spotify zenyewe lakini si sehemu ya API iliyoandikwa, na hakuna scope ya OAuth inayoufichua.

Namba hii ni ya sasa kiasi gani?

Muhtasari wa msanii huhifadhiwa kwenye akiba kwa takriban saa moja, kwa hiyo jibu linaweza kuwa nyuma ya namba kwenye programu ya Spotify kwa muda huo. Ongeza cache=false kulazimisha upatikanaji mpya; header ya X-Cache inaeleza jinsi kila jibu lilivyotolewa. Vitufe vya Endesha kwenye tovuti hii pia hupitia akiba ya onyesho yenyewe, kwa hiyo namba huko inaweza kuwa ya zamani zaidi.

Je, naweza kupata wasikilizaji wa kila mwezi wa wasanii wengi kwa wakati mmoja?

Ndiyo. GET /artist_overview_batch hupokea hadi ID 10 za wasanii zilizotenganishwa kwa koma na hurudisha kitu kilekile cha muhtasari kwa kila mmoja, kwa hiyo wasanii 10 wanagharimu ombi moja. GET /artists?ids= pia hupokea orodha, lakini hurudisha kitu cha msanii cha Spotify chenyewe: bila wasikilizaji wa kila mwezi, na kwa wasanii wengi bila idadi ya wafuasi pia.

Je, worldRank ni nafasi ya kimataifa?

Ni nafasi ambayo Spotify yenyewe huonyesha kwenye ukurasa wa msanii (“#56 in the world” kwenye rekodi iliyotumika hapa). Wasanii walio nje ya orodha iliyopangwa hawana sehemu ya worldRank, kwa hiyo ichukulie kuwa ya hiari.

Miji inayoongoza ni ipi?

stats.topCities.items huorodhesha miji mitano yenye wasikilizaji wengi zaidi wa msanii, kila mmoja ukiwa na city, region, country na numberOfListeners. Ni sehemu ileile ambayo ukurasa wa msanii huonyesha chini ya “Kuhusu”.

Je, naweza kupata historia ya wasikilizaji wa kila mwezi wa msanii?

Si kutoka Spotify, ambayo huchapisha thamani ya sasa pekee. Hifadhi namba kwa ratiba na utakuwa na historia kuanzia siku hiyo; maombi 3 ya kundi kwa siku kwa wasanii 25 yanagharimu maombi 90 kwa mwezi.

Ninahitaji mpango upi?

Yoyote. Endpoint zinazotumiwa na mwongozo huu ziko kwenye kila mpango, RapidAPI na lango la moja kwa moja pia, na mipango hutofautiana kwa wingi wa kila mwezi. Kila mpango wa RapidAPI unaruhusu maombi 5 kwa sekunde na kila ufunguo wa moja kwa moja unajumuisha 10. Mpango wa bure wa RapidAPI unaruhusu maombi 1,000 kwa mwezi.

Vyanzo

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

Pata ufunguo na uvute msanii wako wa kwanza

Endpoint zilezile kwenye zote tatu, zenye bei tofauti. Kiwango cha bure cha RapidAPI ni maombi 1,000 kwa mwezi — vya kutosha kufuatilia orodha ya wasanii kila siku.

Bado hujawa tayari kununua? Pata ufunguo wa majaribio bure: maombi 500 kwa siku 7, bila kadi.