मार्गदर्शिका

Spotify मासिक श्रोते API: प्रत्येक कलाकाराचे श्रोते, फॉलोअर्स, जागतिक रँक आणि टॉप शहरे

Spotify ॲपमध्ये प्रत्येक कलाकाराच्या नावाखाली दिसणारा आकडा — मासिक श्रोते — Web API मध्ये नाही. अधिकृत artist ऑब्जेक्टमध्ये जास्तीत जास्त फॉलोअर्सची संख्या आणि 0–100 चा popularity स्कोअर असतो, प्रेक्षकांबद्दल दुसरे काहीही नसते, आणि Spotify ने दोन्ही deprecated चिन्हांकित केले आहेत आणि 11 फेब्रुवारी 2026 पासून तयार केलेल्या डेव्हलपमेंट-मोड ॲप्ससाठी काढून टाकले आहेत. येथील एक कॉल श्रोते, फॉलोअर्स, एक जागतिक रँक आणि कलाकार सर्वाधिक ऐकला जाणारी पाच शहरे परत करतो.

Eduardo Airaudo, API चे मेंटेनर · अपडेट: २२ ऑक्टोबर, २०२६

अधिकृत artist ऑब्जेक्ट काय वगळतो

Spotify Web API वरील GET /v1/artists/{id} followers.total, popularity पूर्णांक, genres, images आणि नाव परत करतो — पहिली तीन deprecated चिन्हांकित, आणि followers व popularity 11 फेब्रुवारी 2026 पासून तयार केलेल्या डेव्हलपमेंट-मोड ॲप्ससाठी काढून टाकलेले. मासिक श्रोते — Spotify स्वतः कलाकाराच्या पानावर दाखवतो तो आणि लेबल्स, मॅनेजर्स व प्लेलिस्ट पिचर्स प्रत्यक्षात ट्रॅक करतात तो आकडा — संदर्भात कुठेही दिसत नाही, आणि कोणताही scope तो जोडत नाही.

Popularity हा सापेक्ष, अपारदर्शक स्कोअर आहे जो Spotify अलीकडच्या प्लेवरून पुन्हा काढते; त्याचे श्रोत्यांमध्ये रूपांतर करता येत नाही, महिन्यांमध्ये तुलना करता येत नाही, किंवा क्लायंटला समजावून सांगता येत नाही. मासिक श्रोते हा निरपेक्ष काउंट आहे जो रिलीज, सिंक प्लेसमेंट किंवा प्लेलिस्टमध्ये समावेश झाल्यावर बदलतो, म्हणूनच लोकांना तोच आकडा हवा असतो.

येथील /artist_overview कलाकाराचे पान ॲप जसे रेंडर करते तसे परत करतो, प्रेक्षक ब्लॉकसह. त्याच कॉलमध्ये डिस्कोग्राफी, संबंधित कलाकार आणि पिन केलेले आयटम्स येतात, त्यामुळे प्रेक्षकांचे आकडे ते समजण्यासाठी लागणाऱ्या संदर्भासह मिळतात.

काय परत येते

Arijit Singh (4YRxDV8wJFPHPTeXepOstw) साठी रेकॉर्ड केलेल्या /artist_overview response वरून वाचले, 2026-10-22 रोजी घेतलेले. पूर्ण रेकॉर्डिंग endpoint च्या स्वतःच्या पानावर आहे.

stats.monthlyListeners
कलाकाराच्या पानावरील प्रेक्षक आकडा: मागील 28 दिवसांतील वेगवेगळे श्रोते, पूर्णांक म्हणून. रेकॉर्डिंगमध्ये ५,३५,००,२८०.
stats.followers
फॉलोअर्सची संख्या. Spotify ने 11 फेब्रुवारी 2026 पासून तयार केलेल्या डेव्हलपमेंट-मोड ॲप्ससाठी ती स्वतःच्या artist ऑब्जेक्टमधून काढून टाकली; extended-quota ॲप्सना ती अजूनही मिळते. रेकॉर्डिंगमध्ये १९,५७,६६,०७४.
stats.worldRank
श्रोत्यांनुसार Spotify च्या जागतिक रँकिंगमध्ये कलाकाराचे स्थान — रेकॉर्डिंगमध्ये ५६. रँक केलेल्या गटाबाहेरील कलाकारांसाठी नसते.
stats.topCities.items[]
city, region, country आणि numberOfListeners च्या पाच रो. रेकॉर्डिंगची सुरुवात ४१,७४,१७१ श्रोत्यांसह Pune, IN ने होते, मग Delhi, New Delhi, Mumbai आणि Bengaluru.
profile.name
प्रदर्शित नाव. रेकॉर्डिंगमध्ये चरित्र, externalLinks यादी (या कलाकारासाठी रिकामी), पिन केलेला आयटम आणि profile अंतर्गत कलाकाराच्या स्वतःच्या प्लेलिस्ट्स देखील आहेत, आणि verified फ्लॅग नाही.
discography, relatedContent
नवीनतम रिलीज, अल्बम्स, सिंगल्स, appears-on आणि संबंधित कलाकारांचा ब्लॉक, त्याच response मध्ये — एक कॉल कलाकाराचे संपूर्ण पान कव्हर करतो.

५,३५,००,२८०

stats.monthlyListeners

१९,५७,६६,०७४

stats.followers

#५६

stats.worldRank

एका रेकॉर्डिंगमधील तीन आकडे, 2026-10-22. ते स्वरूप स्पष्ट करण्यासाठी दाखवले आहेत, सध्याचे आकडे म्हणून नाही — आजच्या आकड्यांसाठी endpoint पानावर चालवा दाबा.

एक कलाकार, १० कलाकार, किंवा रँकिंग

/artist_overview_batch स्वल्पविरामाने विभक्त १० पर्यंत id घेतो आणि प्रत्येक कलाकारासाठी तोच ऑब्जेक्ट परत करतो, म्हणून १० कलाकारांसाठी १० requests ऐवजी एकच request लागते.

स्पेकच्या शब्दांत, /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 रोजी घेतलेल्या रेकॉर्ड केलेल्या श्रोत्यांच्या response मध्ये rank, artist आणि दशलक्षांमध्ये मांडलेले monthlyListeners यांच्या ५० रो आहेत — पहिली रो Bruno Mars ला १२८.६ वर दाखवते.

कलाकाराचे प्रेक्षक आकडे मिळवा

id म्हणजे कोणत्याही Spotify URL मध्ये /artist/ नंतरची 22 अक्षरांची स्ट्रिंग. त्याऐवजी नाव आहे का? /search?q=&type=artists id परत करतो.

आकडा कालांतराने ट्रॅक करणे

Spotify फक्त एकच सध्याची व्हॅल्यू प्रकाशित करते, इतिहास नाही. टाइम सीरीज आपल्याला स्वतः बनवावी लागते: /artist_overview ठराविक वेळापत्रकानुसार कॉल करा, stats.monthlyListeners टाइमस्टॅम्पसह साठवा, आणि रो मधील फरक काढा. २५ कलाकारांच्या यादीसाठी रोजचा जॉब म्हणजे दिवसाला ३ बॅच requests — दरमहा ९० requests, मोफत टियरच्या १,००० मध्ये.

API ने इतिहास ठेवावा यासाठी /tracking/track?spotifyType=artist&spotifyId= कलाकाराची नोंदणी करतो; त्याच्या monthly_listeners_change आणि followers_change रो /tracking/logs मध्ये जमा होतात, जो आपण पोल करता. वेबहुक्स फक्त प्लेलिस्ट बदल कव्हर करतात. दोन्ही संदर्भात Tracking अंतर्गत आहेत; ते ऑपरेशनल endpoints आहेत, म्हणून या साइटवरील डेमो ते चालवत नाही.

कोडशिवाय: 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 संदर्भातील artist ऑब्जेक्टमध्ये followers.total, popularity, genres, images आणि नाव आहे. पहिली तीन deprecated चिन्हांकित आहेत, आणि followers व popularity 11 फेब्रुवारी 2026 पासून तयार केलेल्या डेव्हलपमेंट-मोड ॲप्ससाठी काढून टाकले गेले. मासिक श्रोते Spotify च्या स्वतःच्या क्लायंट्समध्ये दिसतात पण ते दस्तऐवजीकृत API चा भाग नाहीत आणि कोणताही OAuth scope ते उपलब्ध करत नाही.

आकडा किती ताजा आहे?

Artist overviews सुमारे एक तास कॅश केले जातात, त्यामुळे response Spotify ॲपमधील आकड्यापेक्षा तितका वेळ मागे असू शकतो. नवीन फेच सक्तीने करण्यासाठी cache=false जोडा; प्रत्येक response कसा दिला गेला हे X-Cache header सांगतो. या साइटवरील चालवा बटणेही डेमोच्या स्वतःच्या कॅशमधून जातात, त्यामुळे तिथला आकडा जास्त जुना असू शकतो.

अनेक कलाकारांचे मासिक श्रोते एकदम मिळवता येतात का?

हो. GET /artist_overview_batch स्वल्पविरामाने विभक्त १० पर्यंत कलाकार id घेतो आणि प्रत्येकासाठी तोच overview ऑब्जेक्ट परत करतो, म्हणून १० कलाकारांसाठी एकच request लागते. GET /artists?ids= देखील यादी घेतो, पण Spotify चा स्वतःचा artist ऑब्जेक्ट परत करतो: मासिक श्रोते नाहीत, आणि अनेक कलाकारांसाठी फॉलोअर्सची संख्याही नाही.

worldRank ही जागतिक स्थिती आहे का?

ही तीच रँक आहे जी Spotify स्वतः कलाकाराच्या पानावर दाखवते (येथे वापरलेल्या रेकॉर्डिंगमध्ये “जगात #५६”). रँक केलेल्या गटाबाहेरील कलाकारांना worldRank फील्ड नसते, म्हणून ते ऐच्छिक मानावे.

टॉप शहरे म्हणजे काय?

stats.topCities.items कलाकारासाठी सर्वाधिक श्रोते असलेली पाच शहरे देते, प्रत्येकासह city, region, country आणि numberOfListeners. कलाकाराचे पान About अंतर्गत दाखवते तोच हा ब्लॉक आहे.

कलाकाराच्या मासिक श्रोत्यांचा इतिहास मिळवता येतो का?

Spotify कडून नाही, कारण ते फक्त सध्याची व्हॅल्यू प्रकाशित करते. आकडा ठराविक वेळापत्रकानुसार साठवला की त्या दिवसापासूनचा इतिहास आपल्याकडे असतो; २५ कलाकारांसाठी दिवसाला ३ बॅच कॉल्स दरमहा ९० requests खर्च करतात.

मला कोणता प्लॅन लागेल?

कोणताही. या मार्गदर्शिकेत वापरलेले endpoints प्रत्येक प्लॅनवर आहेत, RapidAPI आणि डायरेक्ट पोर्टल दोन्हीवर, आणि प्लॅन्समध्ये फरक मासिक व्हॉल्यूमचा आहे. प्रत्येक RapidAPI प्लॅन प्रति सेकंद ५ requests ला परवानगी देतो आणि प्रत्येक डायरेक्ट key मध्ये १० समाविष्ट आहेत. RapidAPI चा मोफत प्लॅन दरमहा १,००० requests ला परवानगी देतो.

स्रोत

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

key मिळवा आणि आपला पहिला कलाकार काढा

तिन्हीवर तेच endpoints, वेगवेगळ्या किमतीत. RapidAPI चा मोफत टियर दरमहा १,००० requests आहे — यादी रोज ट्रॅक करण्यासाठी पुरेसा.

खरेदीसाठी तयार नाही? मोफत ट्रायल key मिळवा: ७ दिवसांत ५०० requests, कार्डशिवाय.