Gabay

Spotify monthly listeners API: tagapakinig, tagasunod, world rank, at top na lungsod kada artist

Ang numero sa ilalim ng pangalan ng bawat artist sa Spotify app — ang buwanang tagapakinig — ay wala sa Web API. Ang opisyal na artist object ay may dala lang na follower count at isang 0–100 na popularity score, wala nang iba pa tungkol sa audience, at minarkahan ng Spotify na deprecated ang dalawa at inalis ang mga ito para sa mga app sa development mode na ginawa mula 11 Pebrero 2026. Ibinabalik ng isang tawag dito ang mga tagapakinig, tagasunod, world rank, at ang limang lungsod kung saan pinakamadalas pakinggan ang artist.

Ni Eduardo Airaudo, maintainer ng API · Na-update Oktubre 22, 2026

Ano ang hindi isinasama ng opisyal na artist object

Ibinabalik ng GET /v1/artists/{id} sa Spotify Web API ang followers.total, isang popularity integer, mga genre, mga larawan, at pangalan — ang unang tatlo ay minarkahang deprecated, at inalis ang followers at popularity para sa mga app sa development mode na ginawa mula 11 Pebrero 2026. Ang buwanang tagapakinig — ang numerong inilalagay mismo ng Spotify sa pahina ng artist at ang talagang sinusubaybayan ng mga label, manager, at playlist pitcher — ay wala kahit saan sa reference, at walang scope na nagdaragdag nito.

Ang popularity ay isang relative at malabong score na kinakalkula muli ng Spotify mula sa mga kamakailang play; hindi ito mako-convert sa mga tagapakinig, hindi maihahambing sa pagitan ng mga buwan, at hindi maipapaliwanag sa kliyente. Ang buwanang tagapakinig ay absolute na bilang na gumagalaw kasabay ng isang release, sync placement, o pagdagdag sa playlist, kaya ito ang numerong gusto ng mga tao.

Ibinabalik ng /artist_overview dito ang pahina ng artist gaya ng pagre-render nito ng app, kasama ang audience block. Dala rin ng parehong tawag ang diskograpiya, mga kaugnay na artist, at mga pinned item, kaya kasama ng mga numero ng audience ang konteksto na kailangan para mabasa ang mga ito.

Ano ang ibinabalik

Binasa mula sa naitalang /artist_overview response para sa Arijit Singh (4YRxDV8wJFPHPTeXepOstw), kinuha noong 2026-10-22. Nasa sariling pahina ng endpoint ang buong recording.

stats.monthlyListeners
Ang audience figure sa pahina ng artist: mga natatanging tagapakinig sa nakaraang 28 araw, bilang integer. 53,500,280 sa recording.
stats.followers
Follower count. Inalis ito ng Spotify sa sarili nitong artist object para sa mga app sa development mode na ginawa mula 11 Pebrero 2026; nakukuha pa rin ito ng mga app na may extended quota. 195,766,074 sa recording.
stats.worldRank
Ang posisyon ng artist sa pandaigdigang ranking ng Spotify ayon sa mga tagapakinig — 56 sa recording. Wala para sa mga artist na labas sa na-rank na set.
stats.topCities.items[]
Limang row ng city, region, country, at numberOfListeners. Nagsisimula ang recording sa Pune, IN na may 4,174,171 tagapakinig, sunod ang Delhi, New Delhi, Mumbai, at Bengaluru.
profile.name
Display name. Dala rin ng recording ang biography, isang externalLinks na listahan (walang laman para sa artist na ito), ang pinned item, at ang sariling mga playlist ng artist sa ilalim ng profile, at walang verified flag.
discography, relatedContent
Pinakabagong release, mga album, single, appears-on, at ang block ng mga kaugnay na artist, sa parehong response — isang tawag ang sumasaklaw sa buong pahina ng artist.

53,500,280

stats.monthlyListeners

195,766,074

stats.followers

#56

stats.worldRank

Tatlong numero mula sa isang recording, 2026-10-22. Ipinapakita ang mga ito para gawing konkreto ang hugis, hindi bilang mga kasalukuyang numero — pindutin ang Run sa pahina ng endpoint para sa numero ngayon.

Isang artist, 10 artist, o isang ranking

Tumatanggap ang /artist_overview_batch ng hanggang 10 id na pinaghiwalay ng kuwit at ibinabalik ang parehong object kada artist, kaya isang request lang ang gastos ng 10 artist sa halip na 10.

Sa mga salita ng spec, ang /top_20_by_monthly_listeners ay “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” at ang /top_20_by_followers ay “Wikipedia's list of the most-followed artists on Spotify (followers in millions). Not country-specific”. Walang tumatanggap ng parameter sa dalawa.

Ang naitalang listeners response, kinuha noong 2026-10-22, ay may 50 row ng rank, artist, at monthlyListeners na nakasaad sa milyon — ang unang row ay Bruno Mars sa 128.6.

Kunin ang mga numero ng audience ng artist

Ang id ay ang 22-character na string pagkatapos ng /artist/ sa kahit anong Spotify URL. Pangalan ang hawak? Ibinabalik ng /search?q=&type=artists ang id.

Pagsubaybay sa numero sa paglipas ng panahon

Isang kasalukuyang value lang ang inilalathala ng Spotify, hindi history. Ikaw ang bubuo ng time series: tawagin ang /artist_overview ayon sa iskedyul, itala ang stats.monthlyListeners kasama ang timestamp, at kunin ang pagkakaiba ng mga row. Ang araw-araw na job para sa roster na 25 artist ay 3 batch request kada araw — 90 request kada buwan, sakop ng 1,000 ng libreng tier.

Para ang API ang magtago ng history, nirerehistro ng /tracking/track?spotifyType=artist&spotifyId= ang artist; nag-iipon sa /tracking/logs, na ipo-poll, ang mga monthly_listeners_change at followers_change row nito. Mga pagbabago lang sa playlist ang sakop ng mga webhook. Nasa reference ang dalawa sa ilalim ng Tracking; operational endpoint ang mga ito, kaya hindi pinapatakbo ng demo sa site na ito.

Nang walang code: 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.

Mga tanong

Nagbabalik ba ng monthly listeners ang Spotify Web API?

Hindi. Inililista ng artist object sa Web API reference ang followers.total, popularity, mga genre, mga larawan, at pangalan. Minarkahang deprecated ang unang tatlo, at inalis ang followers at popularity para sa mga app sa development mode na ginawa mula 11 Pebrero 2026. Ipinapakita ang monthly listeners sa sariling mga client ng Spotify pero hindi ito bahagi ng naka-document na API at walang OAuth scope na naglalantad nito.

Gaano kasariwa ang numero?

Naka-cache nang humigit-kumulang isang oras ang mga artist overview, kaya maaaring mahuli ang response sa figure sa Spotify app nang hanggang ganoon katagal. Idagdag ang cache=false para pilitin ang bagong kuha; sinasabi ng X-Cache header kung paano inihain ang bawat response. Dumadaan din sa sariling cache ng demo ang mga Run button sa site na ito, kaya maaaring mas luma ang numero roon.

Puwede bang kunin ang buwanang tagapakinig ng maraming artist nang sabay-sabay?

Oo. Tumatanggap ang GET /artist_overview_batch ng hanggang 10 artist id na pinaghiwalay ng kuwit at ibinabalik ang parehong overview object para sa bawat isa, kaya isang request lang ang gastos ng 10 artist. Tumatanggap din ng listahan ang GET /artists?ids=, pero ibinabalik nito ang sariling artist object ng Spotify: walang monthly listeners, at para sa maraming artist ay walang follower count din.

Pandaigdigang posisyon ba ang worldRank?

Ito ang rank na mismong ipinapakita ng Spotify sa pahina ng artist (“#56 in the world” sa recording na ginamit dito). Walang worldRank field ang mga artist na labas sa na-rank na set, kaya ituring itong opsyonal.

Ano ang top cities?

Inililista ng stats.topCities.items ang limang lungsod na may pinakamaraming tagapakinig para sa artist, bawat isa ay may city, region, country, at numberOfListeners. Ito ang parehong block na ipinapakita ng pahina ng artist sa ilalim ng About.

Makakakuha ba ng history ng buwanang tagapakinig ng isang artist?

Hindi mula sa Spotify, na kasalukuyang value lang ang inilalathala. Itala ang numero ayon sa iskedyul at magkakaroon ng history mula sa araw na iyon; 90 request kada buwan ang gastos ng 3 batch call kada araw para sa 25 artist.

Anong plan ang kailangan?

Kahit alin. Nasa bawat plan ang mga endpoint na ginagamit ng gabay na ito, RapidAPI man o direct portal, at buwanang volume ang pagkakaiba ng mga plan. Pinapayagan ng bawat RapidAPI plan ang 5 request kada segundo at kasama sa bawat direct key ang 10. Pinapayagan ng libreng plan ng RapidAPI ang 1,000 request kada buwan.

Mga pinagmulan

More guides

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

Kumuha ng key at kunin ang unang artist

Parehong endpoint sa tatlo, magkakaiba ang presyo. 1,000 request kada buwan ang libreng tier ng RapidAPI — sapat para subaybayan ang isang roster araw-araw.

RapidAPI Apify Direct Portal

Hindi pa handang bumili? Kumuha ng libreng trial key: 500 request sa loob ng 7 araw, walang card.