வழிகாட்டி

Spotify மாதாந்திர கேட்பவர்கள் API: ஒரு கலைஞருக்கான கேட்பவர்கள், பின்தொடர்பவர்கள், உலக தரவரிசை, முன்னணி நகரங்கள்

Spotify செயலியில் ஒவ்வொரு கலைஞரின் பெயருக்குக் கீழும் உள்ள எண் — மாதாந்திர கேட்பவர்கள் — Web API-இல் இல்லை. அதிகாரப்பூர்வ கலைஞர் பொருளில் அதிகபட்சம் பின்தொடர்பவர் எண்ணிக்கையும் 0–100 popularity மதிப்பெண்ணும் மட்டுமே உள்ளன; பார்வையாளர்களைப் பற்றி வேறு எதுவும் இல்லை. அந்த இரண்டையும் Spotify நிறுத்தப்பட்டது எனக் குறித்து, 11 பிப்ரவரி 2026 முதல் உருவாக்கப்பட்ட development-mode செயலிகளுக்கு நீக்கியது. இங்கே ஒரே அழைப்பு கேட்பவர்கள், பின்தொடர்பவர்கள், உலக தரவரிசை, கலைஞர் மிக அதிகமாக இயக்கப்படும் ஐந்து நகரங்களைத் தருகிறது.

Eduardo Airaudo எழுதியது, API-யின் பராமரிப்பாளர் · புதுப்பிக்கப்பட்டது 22 அக்டோபர், 2026

அதிகாரப்பூர்வ கலைஞர் பொருள் எதை விட்டுவிடுகிறது

Spotify Web API-இல் GET /v1/artists/{id} followers.total, முழு எண்ணான popularity, வகைகள் (genres), படங்கள், பெயர் ஆகியவற்றைத் தருகிறது — முதல் மூன்றும் நிறுத்தப்பட்டவை எனக் குறிக்கப்பட்டவை, பின்தொடர்பவர்களும் popularity-யும் 11 பிப்ரவரி 2026 முதல் உருவாக்கப்பட்ட development-mode செயலிகளுக்கு நீக்கப்பட்டன. மாதாந்திர கேட்பவர்கள் — Spotify தானே கலைஞர் பக்கத்தில் காட்டும் எண், லேபிள்களும் மேலாளர்களும் பிளேலிஸ்ட் பிட்சர்களும் உண்மையில் கண்காணிக்கும் எண் — குறிப்பில் எங்கும் இல்லை, எந்த scope-உம் அதைச் சேர்ப்பதில்லை.

Popularity என்பது சமீபத்திய ப்ளேக்களிலிருந்து Spotify மீண்டும் கணக்கிடும் ஒப்பீட்டு, ஒளிவுமறைவான மதிப்பெண்; அதைக் கேட்பவர்களாக மாற்ற முடியாது, மாதங்களுக்கு இடையே ஒப்பிட முடியாது, வாடிக்கையாளருக்கு விளக்க முடியாது. மாதாந்திர கேட்பவர்கள் ஒரு வெளியீடு, ஒரு sync இடம் அல்லது ஒரு பிளேலிஸ்ட் சேர்க்கையுடன் நகரும் முழுமையான எண்ணிக்கை; அதனால்தான் மக்கள் விரும்பும் எண் அதுவே.

இங்குள்ள /artist_overview கலைஞர் பக்கத்தை செயலி காட்டுவது போலவே, பார்வையாளர் பகுதியுடன் சேர்த்துத் தருகிறது. அதே அழைப்பு டிஸ்கோகிராஃபி, தொடர்புடைய கலைஞர்கள், பின் செய்த உருப்படிகளையும் கொண்டுள்ளது; எனவே பார்வையாளர் எண்களைப் புரிந்துகொள்ளத் தேவையான சூழலுடன் அவை வருகின்றன.

என்ன திரும்பி வருகிறது

2026-10-22 அன்று பதிவு செய்த, Arijit Singh (4YRxDV8wJFPHPTeXepOstw) கலைஞருக்கான /artist_overview பதிலிலிருந்து படிக்கப்பட்டது. முழுப் பதிவு endpoint-இன் சொந்தப் பக்கத்தில் உள்ளது.

stats.monthlyListeners
கலைஞர் பக்கத்தில் உள்ள பார்வையாளர் எண்: கடந்த 28 நாட்களில் தனித்த கேட்பவர்கள், முழு எண்ணாக. பதிவில் 5,35,00,280.
stats.followers
பின்தொடர்பவர் எண்ணிக்கை. 11 பிப்ரவரி 2026 முதல் உருவாக்கப்பட்ட development-mode செயலிகளுக்கு Spotify தன் சொந்த கலைஞர் பொருளிலிருந்து இதை நீக்கியது; extended-quota செயலிகளுக்கு இன்னும் கிடைக்கிறது. பதிவில் 19,57,66,074.
stats.worldRank
கேட்பவர்களின்படி Spotify-இன் உலகளாவிய தரவரிசையில் கலைஞரின் இடம் — பதிவில் 56. தரவரிசைப்படுத்தப்பட்ட தொகுப்புக்கு வெளியே உள்ள கலைஞர்களுக்கு இல்லை.
stats.topCities.items[]
city, region, country, numberOfListeners கொண்ட ஐந்து வரிசைகள். பதிவு Pune, IN (கேட்பவர்கள் 41,74,171) உடன் தொடங்குகிறது, பிறகு Delhi, New Delhi, Mumbai மற்றும் Bengaluru.
profile.name
காட்சிப் பெயர். பதிவில் சுயசரிதை, ஒரு externalLinks பட்டியல் (இந்தக் கலைஞருக்குக் காலி), பின் செய்த உருப்படி, profile கீழ் கலைஞரின் சொந்த பிளேலிஸ்ட்கள் ஆகியவையும் உள்ளன; சரிபார்க்கப்பட்ட கொடி இல்லை.
discography, relatedContent
சமீபத்திய வெளியீடு, ஆல்பங்கள், சிங்கிள்கள், appears-on, தொடர்புடைய கலைஞர்கள் பகுதி, அதே பதிலில் — ஒரே அழைப்பு முழுக் கலைஞர் பக்கத்தையும் உள்ளடக்குகிறது.

5,35,00,280

stats.monthlyListeners

19,57,66,074

stats.followers

#56

stats.worldRank

ஒரு பதிவிலிருந்து மூன்று எண்கள், 2026-10-22. வடிவத்தைப் புரிய வைக்கவே இவை காட்டப்படுகின்றன, தற்போதைய எண்களாக அல்ல — இன்றைய எண்களுக்கு endpoint பக்கத்தில் இயக்கு என்பதை அழுத்துங்கள்.

ஒரு கலைஞர், 10 கலைஞர்கள், அல்லது ஒரு தரவரிசை

/artist_overview_batch கமாவால் பிரிக்கப்பட்ட 10 ID-கள் வரை எடுத்து, ஒவ்வொரு கலைஞருக்கும் அதே பொருளைத் தருகிறது; எனவே 10 கலைஞர்களுக்கு 10 கோரிக்கைகள் அல்ல, ஒரே கோரிக்கை செலவாகும்.

spec-இன் சொற்களில், /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 அன்று பதிவு செய்த கேட்பவர்கள் பதிலில் rank, artist, மில்லியன்களில் வெளிப்படுத்திய monthlyListeners கொண்ட 50 வரிசைகள் உள்ளன — முதல் வரிசை Bruno Mars கலைஞரை 128.6 எனக் காட்டுகிறது.

ஒரு கலைஞரின் பார்வையாளர் எண்களைப் பெறுங்கள்

ID என்பது எந்த Spotify URL-இலும் /artist/ என்பதற்குப் பின் வரும் 22 எழுத்துச் சரம். ID-க்குப் பதிலாகப் பெயர் இருக்கிறதா? /search?q=&type=artists ID-ஐத் தரும்.

காலப்போக்கில் எண்ணைக் கண்காணித்தல்

Spotify ஒரு தற்போதைய மதிப்பை மட்டுமே வெளியிடுகிறது, வரலாற்றை அல்ல. காலத் தொடரை நீங்களே உருவாக்க வேண்டும்: /artist_overview அழைப்பை அட்டவணைப்படி இயக்குங்கள், stats.monthlyListeners மதிப்பை நேர முத்திரையுடன் சேமியுங்கள், வரிசைகளின் வேறுபாட்டைக் கணக்கிடுங்கள். 25 கலைஞர்கள் கொண்ட பட்டியலுக்கு தினசரி வேலை நாளுக்கு 3 தொகுதிக் கோரிக்கைகள் — மாதம் 90 கோரிக்கைகள், இலவச நிலையின் 1,000 வரம்புக்குள்.

வரலாற்றை API-யே வைத்திருக்க வேண்டுமானால், /tracking/track?spotifyType=artist&spotifyId= கலைஞரைப் பதிவு செய்கிறது; அதன் monthly_listeners_change, followers_change வரிசைகள் /tracking/logs என்பதில் சேரும், அதை நீங்கள் poll செய்யலாம். Webhook-கள் பிளேலிஸ்ட் மாற்றங்களை மட்டுமே உள்ளடக்குகின்றன. இரண்டும் குறிப்பில் Tracking கீழ் உள்ளன; அவை செயல்பாட்டு endpoint-கள், எனவே இந்தத் தளத்தின் டெமோ அவற்றை இயக்காது.

குறியீடு இல்லாமல்: 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, popularity, வகைகள், படங்கள், பெயர் ஆகியவற்றைப் பட்டியலிடுகிறது. முதல் மூன்றும் நிறுத்தப்பட்டவை எனக் குறிக்கப்பட்டவை, பின்தொடர்பவர்களும் popularity-யும் 11 பிப்ரவரி 2026 முதல் உருவாக்கப்பட்ட development-mode செயலிகளுக்கு நீக்கப்பட்டன. மாதாந்திர கேட்பவர்கள் Spotify-இன் சொந்த கிளையன்ட்களில் காட்டப்படுகிறது, ஆனால் ஆவணப்படுத்தப்பட்ட API-யின் பகுதி அல்ல, எந்த OAuth scope-உம் அதை வெளிப்படுத்துவதில்லை.

அந்த எண் எவ்வளவு சமீபத்தியது?

கலைஞர் மேலோட்டங்கள் சுமார் ஒரு மணி நேரம் கேச் செய்யப்படுகின்றன, அதனால் ஒரு பதில் Spotify செயலியில் உள்ள எண்ணை விட அவ்வளவு நேரம் வரை பின்தங்கலாம். புதிதாகப் பெற cache=false சேருங்கள்; ஒவ்வொரு பதிலும் எப்படி வழங்கப்பட்டது என்பதை X-Cache header சொல்லும். இந்தத் தளத்தின் இயக்கு பொத்தான்களும் டெமோவின் சொந்தக் கேச் வழியாகவே செல்கின்றன, அதனால் அங்குள்ள எண் இன்னும் பழையதாக இருக்கலாம்.

பல கலைஞர்களின் மாதாந்திர கேட்பவர்களை ஒரே நேரத்தில் பெற முடியுமா?

ஆம். GET /artist_overview_batch கமாவால் பிரிக்கப்பட்ட 10 கலைஞர் ID-கள் வரை எடுத்து ஒவ்வொருவருக்கும் அதே மேலோட்டப் பொருளைத் தருகிறது, எனவே 10 கலைஞர்களுக்கு ஒரே கோரிக்கை செலவாகும். GET /artists?ids= உம் பட்டியலை எடுக்கும், ஆனால் Spotify-இன் சொந்த கலைஞர் பொருளைத் தரும்: மாதாந்திர கேட்பவர்கள் இல்லை, பல கலைஞர்களுக்குப் பின்தொடர்பவர் எண்ணிக்கையும் இல்லை.

worldRank ஒரு உலகளாவிய இடமா?

இது Spotify தானே கலைஞர் பக்கத்தில் காட்டும் தரவரிசை (இங்கே பயன்படுத்தப்பட்ட பதிவில் “#56 in the world”). தரவரிசைப்படுத்தப்பட்ட தொகுப்புக்கு வெளியே உள்ள கலைஞர்களுக்கு worldRank புலம் இல்லை, எனவே அதை விருப்பப் புலமாகக் கையாளுங்கள்.

முன்னணி நகரங்கள் என்றால் என்ன?

stats.topCities.items கலைஞருக்கு அதிகக் கேட்பவர்கள் உள்ள ஐந்து நகரங்களைப் பட்டியலிடுகிறது; ஒவ்வொன்றிலும் city, region, country, numberOfListeners உள்ளன. கலைஞர் பக்கத்தில் “பற்றி” என்பதன் கீழ் காட்டப்படும் அதே பகுதி இது.

ஒரு கலைஞரின் மாதாந்திர கேட்பவர்களின் வரலாற்றைப் பெற முடியுமா?

Spotify-யிடமிருந்து முடியாது, அது தற்போதைய மதிப்பை மட்டுமே வெளியிடுகிறது. எண்ணை அட்டவணைப்படி சேமித்தால், அந்த நாள் முதல் வரலாறு உங்களிடம் இருக்கும்; 25 கலைஞர்களுக்கு நாளுக்கு 3 தொகுதி அழைப்புகளுக்கு மாதம் 90 கோரிக்கைகள் செலவாகும்.

எனக்கு எந்தத் திட்டம் தேவை?

எதுவும். இந்த வழிகாட்டி பயன்படுத்தும் endpoint-கள் ஒவ்வொரு திட்டத்திலும் உள்ளன, RapidAPI-யிலும் நேரடி போர்ட்டலிலும்; திட்டங்கள் மாதாந்திர அளவில் வேறுபடுகின்றன. ஒவ்வொரு RapidAPI திட்டமும் வினாடிக்கு 5 கோரிக்கைகளை அனுமதிக்கிறது; ஒவ்வொரு நேரடி விசையிலும் 10 உள்ளடங்கும். RapidAPI-இன் இலவசத் திட்டம் மாதம் 1,000 கோரிக்கைகளை அனுமதிக்கிறது.

ஆதாரங்கள்

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

ஒரு விசையைப் பெற்று உங்கள் முதல் கலைஞரை எடுங்கள்

மூன்றிலும் அதே endpoint-கள், வெவ்வேறு விலையில். RapidAPI-இன் இலவச நிலை மாதம் 1,000 கோரிக்கைகள் — ஒரு பட்டியலைத் தினமும் கண்காணிக்கப் போதுமானது.

இன்னும் வாங்கத் தயாராக இல்லையா? இலவச சோதனை விசை பெறுங்கள்: 7 நாட்களில் 500 கோரிக்கைகள், கார்டு தேவையில்லை.