دليل

API المستمعين الشهريين على Spotify: المستمعون والمتابعون والترتيب العالمي وأبرز المدن لكل فنان

الرقم الذي يظهر تحت اسم كل فنان في تطبيق Spotify — المستمعون الشهريون — ليس في Web API. يحمل كائن الفنان الرسمي على الأكثر عدد المتابعين ودرجة شعبية من 0 إلى 100، ولا شيء آخر عن الجمهور، ويصنّف Spotify كليهما قيد الإيقاف وقد أزالهما من التطبيقات في وضع التطوير المنشأة اعتبارًا من 11 فبراير 2026. استدعاء واحد هنا يعيد المستمعين والمتابعين والترتيب العالمي والمدن الخمس التي يُشغَّل فيها الفنان أكثر من غيرها.

بقلم ⁨Eduardo Airaudo⁩، مشرف API · حُدّث في ⁨22 أكتوبر 2026⁩

ما الذي يتركه كائن الفنان الرسمي

تعيد ⁨GET /v1/artists/{id}⁩ في Spotify Web API الحقل ⁨followers.total⁩ وعددًا صحيحًا ⁨popularity⁩ والأنواع الموسيقية والصور والاسم — والثلاثة الأولى مصنّفة قيد الإيقاف، وقد أُزيل المتابعون والشعبية من التطبيقات في وضع التطوير المنشأة اعتبارًا من 11 فبراير 2026. أما المستمعون الشهريون — الرقم الذي يضعه Spotify نفسه في صفحة الفنان والذي يتتبعه فعلًا أصحاب شركات الإنتاج الموسيقي والمديرون والعاملون على ترشيح الأغاني لقوائم التشغيل — فلا يظهر في أي موضع من المرجع، ولا يضيفه أي نطاق صلاحيات.

الشعبية درجة نسبية غامضة يعيد Spotify حسابها من التشغيلات الحديثة؛ ولا يمكن تحويلها إلى مستمعين، ولا مقارنتها بين شهرين، ولا شرحها لعميل. أما المستمعون الشهريون فعدد مطلق يتحرك مع إصدار أو إدراج في مشهد أو إضافة إلى قائمة تشغيل، ولذلك هو الرقم الذي يريده الناس.

تعيد ⁨/artist_overview⁩ هنا صفحة الفنان كما يعرضها التطبيق، بما فيها كتلة الجمهور. ويحمل الاستدعاء نفسه الأعمال الكاملة والفنانين ذوي الصلة والعناصر المثبّتة، فتأتي أرقام الجمهور مع السياق اللازم لقراءتها.

ما الذي يعود

قُرئت من استجابة ⁨/artist_overview⁩ المسجّلة للفنان ⁨Arijit Singh⁩ (⁨4YRxDV8wJFPHPTeXepOstw⁩)، التُقطت في ⁨2026-10-22⁩. التسجيل الكامل في صفحة نقطة النهاية نفسها.

stats.monthlyListeners
رقم الجمهور في صفحة الفنان: المستمعون المميّزون خلال آخر 28 يومًا، كعدد صحيح. ⁨53,500,280⁩ في التسجيل.
stats.followers
عدد المتابعين. أزاله Spotify من كائن الفنان لديه للتطبيقات في وضع التطوير المنشأة اعتبارًا من 11 فبراير 2026؛ وما زالت التطبيقات ذات الحصة الموسّعة تحصل عليه. ⁨195,766,074⁩ في التسجيل.
stats.worldRank
موضع الفنان في ترتيب Spotify العالمي بحسب المستمعين — ⁨56⁩ في التسجيل. يغيب عن الفنانين خارج المجموعة المرتّبة.
stats.topCities.items[]
خمسة صفوف من ⁨city⁩ و⁨region⁩ و⁨country⁩ و⁨numberOfListeners⁩. يفتتح التسجيل بـ⁨Pune, IN⁩ عند ⁨4,174,171⁩ مستمع، ثم ⁨Delhi وNew Delhi وMumbai وBengaluru⁩.
profile.name
الاسم المعروض. ويحمل التسجيل أيضًا السيرة الذاتية، وقائمة ⁨externalLinks⁩ (فارغة لهذا الفنان)، والعنصر المثبّت وقوائم تشغيل الفنان نفسه تحت ⁨profile⁩، ولا يحمل علامة توثيق.
discography, relatedContent
أحدث إصدار، والألبومات، والأغاني المنفردة، وما يظهر فيه الفنان، وكتلة الفنانين ذوي الصلة، في الاستجابة نفسها — استدعاء واحد يغطي صفحة الفنان كلها.

53,500,280

stats.monthlyListeners

195,766,074

stats.followers

#56

stats.worldRank

ثلاثة أرقام من تسجيل واحد، ⁨2026-10-22⁩. تُعرض لتوضيح الشكل، لا بوصفها أرقامًا حالية — اضغط تشغيل في صفحة نقطة النهاية للحصول على رقم اليوم.

فنان واحد، أو ⁨10⁩ فنان، أو ترتيب

تأخذ ⁨/artist_overview_batch⁩ ما يصل إلى ⁨10⁩ معرّف مفصولة بفواصل وتعيد الكائن نفسه لكل فنان، فيكلّف ⁨10⁩ فنان طلبًا واحدًا لا ⁨10⁩ طلب.

بحسب عبارة المواصفات، ⁨/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⁩، على ⁨50⁩ صفًا من ⁨rank⁩ و⁨artist⁩ و⁨monthlyListeners⁩ معبَّرًا عنها بالملايين — يعرض الصف الأول ⁨Bruno Mars⁩ عند ⁨128.6⁩.

اجلب أرقام جمهور فنان

المعرّف هو السلسلة المكوّنة من 22 حرفًا بعد ⁨/artist/⁩ في أي رابط Spotify. هل لديك اسم بدلًا منه؟ تعيد ⁨/search?q=&type=artists⁩ المعرّف.

تتبّع الرقم عبر الزمن

ينشر Spotify قيمة حالية واحدة، لا سجلًا تاريخيًا. وبناء السلسلة الزمنية مسؤوليتك: استدعِ ⁨/artist_overview⁩ وفق جدول، وخزّن ⁨stats.monthlyListeners⁩ مع ختم زمني، واحسب الفروق بين الصفوف. مهمة يومية لقائمة من ⁨25⁩ فنان هي ⁨3⁩ طلبات دفعة في اليوم — ⁨90⁩ طلب شهريًا، ضمن ⁨1,000⁩ في الطبقة المجانية.

ولكي يحتفظ API بالسجل، يسجّل ⁨/tracking/track?spotifyType=artist&spotifyId=⁩ الفنان؛ وتتجمع صفوف ⁨monthly_listeners_change⁩ و⁨followers_change⁩ في ⁨/tracking/logs⁩، وأنت تستعلم عنها دوريًا. وتغطي webhooks تغييرات قوائم التشغيل فقط. وكلاهما في المرجع تحت ⁨Tracking⁩؛ وهما نقطتان تشغيليتان، فلا يشغّلهما العرض التجريبي في هذا الموقع.

بلا كود: 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⁩ والشعبية والأنواع الموسيقية والصور والاسم. والثلاثة الأولى مصنّفة قيد الإيقاف، وأُزيل المتابعون والشعبية من التطبيقات في وضع التطوير المنشأة اعتبارًا من 11 فبراير 2026. ويظهر المستمعون الشهريون في تطبيقات Spotify نفسها لكنه ليس جزءًا من API الموثّق، ولا يكشفه أي نطاق OAuth.

ما مدى حداثة الرقم؟

تُخزَّن النظرات العامة على الفنانين مؤقتًا نحو ساعة، فقد تتأخر الاستجابة عن الرقم في تطبيق Spotify بهذه المدة على الأكثر. أضف ⁨cache=false⁩ لفرض جلب جديد؛ وتبيّن الترويسة ⁨X-Cache⁩ كيف قُدّمت كل استجابة. وتمر أزرار التشغيل في هذا الموقع بذاكرة العرض التجريبي المؤقتة أيضًا، فقد يكون الرقم هناك أقدم.

هل يمكنني الحصول على المستمعين الشهريين لفنانين كثيرين دفعة واحدة؟

نعم. تأخذ ⁨GET /artist_overview_batch⁩ ما يصل إلى ⁨10⁩ معرّف فنان مفصولة بفواصل وتعيد كائن النظرة العامة نفسه لكل منهم، فيكلّف ⁨10⁩ فنان طلبًا واحدًا. وتأخذ ⁨GET /artists?ids=⁩ قائمة أيضًا، لكنها تعيد كائن الفنان الخاص بـ Spotify: بلا مستمعين شهريين، وبلا عدد متابعين في حالة فنانين كثيرين.

هل ⁨worldRank⁩ موضع عالمي؟

هو الترتيب الذي يعرضه Spotify نفسه في صفحة الفنان («#⁨56⁩ in the world» في التسجيل المستخدم هنا). والفنانون خارج المجموعة المرتّبة لا يحملون الحقل ⁨worldRank⁩، فعامله على أنه اختياري.

ما أبرز المدن؟

يسرد ⁨stats.topCities.items⁩ المدن الخمس الأكثر استماعًا للفنان، لكل منها ⁨city⁩ و⁨region⁩ و⁨country⁩ و⁨numberOfListeners⁩. وهي الكتلة نفسها التي تعرضها صفحة الفنان تحت «نبذة».

هل يمكنني الحصول على سجل المستمعين الشهريين لفنان؟

ليس من Spotify، الذي ينشر القيمة الحالية فقط. خزّن الرقم وفق جدول فيكون لديك السجل منذ ذلك اليوم؛ و⁨3⁩ طلبات دفعة في اليوم لـ⁨25⁩ فنان تكلّف ⁨90⁩ طلب شهريًا.

أي خطة أحتاج؟

أي خطة. نقاط النهاية التي يستخدمها هذا الدليل موجودة في كل خطة، في RapidAPI والبوابة المباشرة على السواء، وتختلف الخطط بالحجم الشهري. تتيح كل خطة RapidAPI ⁨5⁩ طلبات في الثانية، ويشمل كل مفتاح مباشر ⁨10⁩. وتتيح خطة RapidAPI المجانية ⁨1,000⁩ طلب شهريًا.

المصادر

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

احصل على مفتاح واسحب أول فنان

نقاط النهاية نفسها على المنصات الثلاث، بأسعار مختلفة. والطبقة المجانية في RapidAPI هي ⁨1,000⁩ طلب شهريًا — تكفي لتتبّع قائمة فنانين يوميًا.

لم تقرر الشراء بعد؟ ⁨احصل على مفتاح تجريبي مجاني⁩: ⁨500⁩ طلب خلال ⁨7⁩ أيام، بلا بطاقة.