راهنما
API شنوندگان ماهانه Spotify: شنوندگان، دنبال‌کنندگان، رتبه جهانی و شهرهای برتر هر هنرمند
عددی که در برنامه Spotify زیر نام هر هنرمند است — شنوندگان ماهانه — در Web API نیست. شیء رسمی هنرمند حداکثر تعداد دنبال‌کنندگان و امتیاز popularity از ۰ تا ۱۰۰ را دارد، و درباره مخاطب چیز دیگری ندارد؛ Spotify هر دو را منسوخ علامت زده و برای برنامههای حالت توسعه که از ۱۱ فوریه ۲۰۲۶ ساخته شدهاند حذفشان کرده است. یک فراخوانی اینجا شنوندگان، دنبال‌کنندگان، رتبه جهانی و پنج شهری را برمیگرداند که هنرمند بیشتر از همه در آن‌ها پخش میشود.
از Eduardo Airaudo، نگهدارنده API · به‌روزرسانی ۳۰ مهر ۱۴۰۵
آنچه شیء رسمی هنرمند ندارد
GET /v1/artists/{id} در Spotify Web API followers.total، یک عدد popularity، ژانرها، تصاویر و یک نام را برمیگرداند — سه مورد اول منسوخ علامت خوردهاند، و followers و popularity برای برنامههای حالت توسعه که از ۱۱ فوریه ۲۰۲۶ ساخته شدهاند حذف شدهاند. شنوندگان ماهانه — عددی که خود Spotify در صفحه هنرمند می‌گذارد و لیبل‌ها، مدیران برنامه و پیشنهاددهندگان پلی‌لیست واقعاً دنبالش می‌کنند — هیچ‌جای مرجع نیست و هیچ scopeای آن را اضافه نمی‌کند.
popularity امتیازی نسبی و مبهم است که Spotify از پخش‌های اخیر دوباره حساب میکند؛ نمی‌شود آن را به شنونده تبدیل کرد، میان ماه‌ها مقایسه کرد، یا برای یک مشتری توضیح داد. شنوندگان ماهانه یک تعداد مطلق است که با انتشار یک اثر، قرار گرفتن در یک سینک یا اضافه شدن به یک پلی‌لیست جابه‌جا میشود، و برای همین است که مردم همین عدد را می‌خواهند.
/artist_overview اینجا صفحه هنرمند را همان‌طور که برنامه رندر میکند برمیگرداند، با بلوک مخاطب. همان فراخوانی آثار، هنرمندان مرتبط و موارد سنجاق‌شده را هم دارد، پس عددهای مخاطب همراه با زمینه لازم برای خواندنشان می‌آیند.
چه چیزی برمی‌گردد
از روی پاسخ ضبط‌شده /artist_overview برای Arijit Singh (4YRxDV8wJFPHPTeXepOstw) خوانده شده، دریافت‌شده در 2026-10-22. ضبط کامل در صفحه خود endpoint است.
- stats.monthlyListeners
- عدد مخاطب در صفحه هنرمند: شنوندگان متمایز در ۲۸ روز گذشته، به‌صورت عدد صحیح. ۵۳٬۵۰۰٬۲۸۰ در ضبط.
- stats.followers
- تعداد دنبال‌کنندگان. Spotify آن را از شیء هنرمند خودش برای برنامههای حالت توسعه که از ۱۱ فوریه ۲۰۲۶ ساخته شدهاند حذف کرد؛ برنامههای 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 و بلوک هنرمندان مرتبط، در همان پاسخ — یک فراخوانی کل صفحه هنرمند را پوشش میدهد.
۵۳٬۵۰۰٬۲۸۰
stats.monthlyListeners
۱۹۵٬۷۶۶٬۰۷۴
stats.followers
#۵۶
stats.worldRank
سه عدد از یک ضبط، 2026-10-22. برای ملموس کردن شکل پاسخ نشان داده شدهاند، نه به‌عنوان رقم‌های فعلی — برای رقم‌های امروز در صفحه endpoint «اجرا» را بزنید.
یک هنرمند، ۱۰ هنرمند، یا یک رتبه‌بندی
- Artist overviewGET /artist_overview
- Artist overview (batch)GET /artist_overview_batch
- Most-listened artists (monthly listeners)GET /top_20_by_monthly_listeners
- Most-followed artistsGET /top_20_by_followers
/artist_overview_batch تا ۱۰ شناسه جداشده با ویرگول می‌گیرد و برای هر هنرمند همان شیء را برمیگرداند، پس ۱۰ هنرمند به‌جای ۱۰ درخواست، یک درخواست هزینه دارند.
به تعبیر اسپک، /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 (بر حسب میلیون) دارد — ردیف اول Bruno Mars را با ۱۲۸٫۶ نشان میدهد.
دریافت عددهای مخاطب یک هنرمند
| curl -X GET \ |
| "https://spotify-proxy.checkleaked.cc/spotify-data/artist_overview?id=4YRxDV8wJFPHPTeXepOstw" \ |
| -H "x-rapidapi-key: $SPOTIFY_API_KEY" |
شناسه همان رشته ۲۲ نویسه‌ای بعد از /artist/ در هر URL اسپاتیفای است. به‌جای شناسه فقط نام دارید؟ /search?q=&type=artists شناسه را برمیگرداند.
دنبال کردن این عدد در طول زمان
Spotify فقط یک مقدار فعلی منتشر میکند، نه تاریخچه. ساختن سری زمانی با شماست: /artist_overview را طبق زمانبندی فراخوانی کنید، stats.monthlyListeners را با یک مهر زمانی ذخیره کنید، و اختلاف ردیف‌ها را حساب کنید. یک کار روزانه برای فهرستی از ۲۵ هنرمند، روزی ۳ درخواست دستهای است — ۹۰ درخواست در ماه، در محدوده ۱٬۰۰۰ پلن رایگان.
اگر می‌خواهید API تاریخچه را نگه دارد، /tracking/track?spotifyType=artist&spotifyId= هنرمند را ثبت میکند؛ ردیف‌های monthly_listeners_change و followers_change آن در /tracking/logs جمع می‌شوند که شما آن را پول می‌کنید. وب‌هوک‌ها فقط تغییرات پلی‌لیست را پوشش می‌دهند. هر دو در مرجع زیر 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، ژانرها، تصاویر و یک نام. سه مورد اول منسوخ علامت خوردهاند، و followers و popularity برای برنامههای حالت توسعه که از ۱۱ فوریه ۲۰۲۶ ساخته شدهاند حذف شدند. شنوندگان ماهانه در کلاینتهای خود Spotify نشان داده میشود اما بخشی از API مستند نیست و هیچ scopeی از OAuth آن را در دسترس نمیگذارد.
این عدد چقدر بهروز است؟
مرور کلی هنرمند حدود یک ساعت کش میشود، پس پاسخ ممکن است تا همینقدر از رقم برنامه Spotify عقب باشد. برای اجبار به دریافت تازه cache=false را اضافه کنید؛ هدر X-Cache میگوید هر پاسخ چطور ارائه شده است. دکمههای «اجرا» در این سایت از کش خود دمو هم میگذرند، پس رقمی که آنجا میبینید ممکن است قدیمیتر باشد.
میتوانم شنوندگان ماهانه چند هنرمند را یک‌جا بگیرم؟
بله. GET /artist_overview_batch تا ۱۰ شناسه هنرمند جداشده با ویرگول می‌گیرد و برای هر کدام همان شیء مرور کلی را برمیگرداند، پس ۱۰ هنرمند یک درخواست هزینه دارند. GET /artists?ids= هم فهرست می‌گیرد، اما شیء هنرمند خود Spotify را برمیگرداند: بدون شنوندگان ماهانه، و برای بسیاری از هنرمندان بدون تعداد دنبال‌کنندگان.
آیا worldRank یک جایگاه جهانی است؟
این همان رتبهای است که خود Spotify در صفحه هنرمند نشان میدهد («#۵۶ in the world» در ضبط استفادهشده اینجا). هنرمندان بیرون از مجموعه رتبهبندیشده فیلد worldRank ندارند، پس آن را اختیاری در نظر بگیرید.
شهرهای برتر چیست؟
stats.topCities.items پنج شهری را فهرست میکند که بیشترین شنوندگان هنرمند را دارند، هر کدام با city، region، country و numberOfListeners. همان بلوکی است که صفحه هنرمند زیر «درباره» نشان میدهد.
میتوانم تاریخچه شنوندگان ماهانه یک هنرمند را بگیرم؟
از Spotify نه، که فقط مقدار فعلی را منتشر میکند. عدد را طبق زمانبندی ذخیره کنید تا از همان روز تاریخچه داشته باشید؛ روزی ۳ فراخوانی دستهای برای ۲۵ هنرمند ماهی ۹۰ درخواست هزینه دارد.
کدام پلن را لازم دارم؟
هر پلنی. endpointهایی که این راهنما به کار میبرد روی همه پلنها هستند، هم RapidAPI و هم پورتال مستقیم، و پلنها در حجم ماهانه فرق دارند. هر پلن RapidAPI ۵ درخواست در ثانیه مجاز میکند و هر کلید مستقیم ۱۰ را شامل میشود. پلن رایگان RapidAPI ماهانه ۱٬۰۰۰ درخواست مجاز میکند.
منابع
- Get Artist — مرجع Spotify Web API — شیء رسمی هنرمند: followers، popularity و ژانرها منسوخ علامت خوردهاند؛ فیلد شنوندگان ماهانه وجود ندارد.
- تغییرات فوریه ۲۰۲۶ — مرجع Spotify for Developers — followers و popularity هنرمند برای برنامههای حالت توسعه که از ۱۱ فوریه ۲۰۲۶ ساخته شدهاند حذف شدند.
- GET /artist_overview در این سایت — پاسخ ضبط‌شده‌ای که این صفحه از آن می‌خواند، کامل و با تاریخ دریافتش.
- GET /top_20_by_monthly_listeners در این سایت — رتبه‌بندی پلتفرم، با ضبط خودش.
More guides
- Spotify Web API alternativeEndpoint-by-endpoint mapping from the official API, including everything Spotify removed on 27 November 2024.
- Spotify API without OAuthOne header instead of the client-credentials flow — and the things a key genuinely cannot do.
- Spotify lyrics APIWhy the Web API has no lyrics endpoint, and how to get line-synced lyrics as JSON, LRC or SRT.
- Spotify charts APIDaily Top 200 and viral charts as JSON: rank movement, stream counts, credits, and how to backfill.
- Spotify play count APILifetime streams for any track, by Spotify id or ISRC, one or a batch per call — and why a 0 means under 1,000.
- Spotify audio features API after the 2024 deprecationTempo, energy, danceability, recommendations and related artists after Spotify removed them for new apps.
- Spotify API rate limitsThe official 30-second rolling window, what each plan here allows per second and per month, and how to stay under it.
- Spotify scraper on ApifyPlay counts, charts, lyrics and credits as a scheduled run with no API key — and when an API key is the better tool.
- Spotify MCP serverPlay counts, monthly listeners and charts inside Claude, Cursor or VS Code: an open-source MCP server that runs with your own key.
What changed in the API and on these pages, and when: What's new.
یک کلید بگیرید و اولین هنرمندتان را بکشید
همان endpointها در هر سه کانال، با قیمت‌های متفاوت. پلن رایگان RapidAPI ماهانه ۱٬۰۰۰ درخواست است — برای دنبال کردن روزانه فهرستی از هنرمندان کافی است.
آماده خرید نیستید؟ دریافت کلید آزمایشی رایگان: ۵۰۰ درخواست در ۷ روز، بدون کارت.