گائیڈ

Spotify پلے کاؤنٹ API: id یا ISRC سے کسی بھی ٹریک کے کل اسٹریمز

Spotify کی Web API کبھی نہیں بتاتی کہ کوئی ٹریک کتنی بار چلایا گیا۔ سب سے قریب popularity ہے، 0–100 کا اسکور جسے اس کا اپنا ریفرنس بیشتر کل پلے پر مبنی بتاتا ہے اور deprecated نشان زد کرتا ہے۔ یہ endpoints خود گنتی لوٹاتے ہیں: ایک ٹریک Spotify id یا ISRC سے، یا ایک ہی کال میں ⁨50⁩ ٹریکس تک۔

⁨Eduardo Airaudo⁩ کی طرف سے، API کے مینٹینر · اپ ڈیٹ: ⁨22 اکتوبر، 2026⁩

سرکاری ٹریک آبجیکٹ میں کیا نہیں ہے

Spotify Web API پر ⁨GET /v1/tracks/{id}⁩ البم، فنکار، ⁨duration_ms⁩، ⁨explicit⁩، ⁨external_ids⁩، نام، ⁨popularity⁩ اور چند اور فیلڈز لوٹاتا ہے۔ ان میں سے کوئی بھی پلے نہیں گنتا۔ popularity سب سے قریب ہے: Spotify کا ریفرنس اسے 0 سے 100 کی قدر بتاتا ہے، جو زیادہ تر اس سے نکلتی ہے کہ ٹریک کتنی بار چلایا گیا اور وہ پلے کتنے حالیہ ہیں، اور اسے deprecated نشان زد کرتا ہے۔ Spotify کی فروری 2026 کی تبدیلیوں نے اسے 11 فروری 2026 سے بنائی گئی ڈیولپمنٹ موڈ ایپس کے لیے ہٹا دیا۔

اسکور وہ کام نہیں کر سکتا جو گنتی کرتی ہے۔ یہ اضافی (relative) ہے، اس لیے کسی البم یا کیٹلاگ پر جمع نہیں ہوتا، اور حالیہ پلے کو ترجیح دیتا ہے — وہی ریفرنس کہتا ہے کہ اب بہت چلنے والے گانے ماضی میں بہت چلنے والے گانوں سے زیادہ اسکور پاتے ہیں — اس لیے یہ نہیں بتا سکتا کہ ٹریک اب تک کتنی بار چلایا گیا۔

اسپیک کے الفاظ میں، اس API کا Partner گروپ “⁨Spotify's internal (pathfinder) data, including play counts⁩” ہے۔ ⁨/partner/track/count⁩ ایک ٹریک کی کل گنتی لوٹاتا ہے، ⁨/partner/tracks/count⁩ ⁨50⁩ ٹریکس تک کی ایک ساتھ، اور ⁨/partner/track⁩ اسے مکمل ٹریک ریکارڈ کے اندر لاتا ہے۔

کیا واپس آتا ہے

فیلڈ بہ فیلڈ، جیسا اسپیک کے رسپانس اسکیمے طے کرتے ہیں۔ ایک ٹریک کی کال گنتی کو ⁨streams⁩ کہتی ہے؛ بیچ اسے ⁨playcount⁩ کہتا ہے۔

ایک ٹریک

GET /partner/track/count

streams
کل پلے کاؤنٹ، بطور عدد صحیح (int64)۔ اسپیک میں nullable ہے، اور 1,000 پلے سے کم کے ٹریک کے لیے 0۔
spotify_track_id
ٹریک کی Spotify id۔
isrc
ٹریک کا ISRC۔ اسپیک میں nullable۔
result
⁨success⁩ یا ⁨error⁩، ساتھ ایک مختصر ⁨message⁩۔

بیچ

GET /partner/tracks/count

tracks[]
ہر درخواست کردہ id کی ایک انٹری، درخواست کی ترتیب میں۔
tracks[].playcount
کل پلے (int64، nullable)؛ 1,000 سے کم والے ٹریک کے لیے 0۔
tracks[].status
⁨ok⁩، ⁨not_found⁩ یا ⁨error⁩، اور جب ⁨error⁩ ہو تو ساتھ ⁨error⁩ متن۔
tracks[].name
ٹریک کا نام؛ نہ ملنے پر ⁨null⁩۔
tracks[].artists[]
ہر فنکار کی ⁨id⁩ اور ⁨name⁩۔
tracks[].releaseDate
ٹریک کے البم کی ریلیز کی تاریخ: YYYY-MM-DD، یا کم درستگی والی شکل۔
missing[]
درخواست کردہ وہ ids جن کا status ⁨ok⁩ نہیں ہے۔

0 کا مطلب ہے 1,000 سے کم، کبھی نہیں چلا نہیں۔ اسپیک کہتی ہے کہ Spotify 1,000 سے کم پلے والے ٹریکس کے لیے 0 رپورٹ کرتا ہے، اس لیے 0 کو گنتی کے طور پر نہیں بلکہ “1,000 سے کم” کے طور پر اسٹور کریں۔

ریکارڈ شدہ نمونہ · ⁨2026-10-22⁩ کو حاصل کیا گیا

GET /partner/track/count

⁨6⁩ لائنیں — پوری ریکارڈ شدہ باڈی۔

ریکارڈ شدہ نمونہ · ⁨2026-10-22⁩ کو حاصل کیا گیا

GET /partner/tracks/count

⁨18⁩ لائنیں — پوری ریکارڈ شدہ باڈی۔

ایک ٹریک، یا ہر کال میں ⁨50⁩

  • GET /partner/track/countTrack play count

    Lifetime play count of one track, by Spotify id (spotify_track_id, or its alias id) or by isrc. Spotify reports 0 for tracks with fewer than 1,000 plays. Play counts are cached for 1 hour; for many tracks use /partner/tracks/count.

    پیرامیٹرزspotify_track_id, id, isrc, cache

  • GET /partner/tracks/countTrack play counts (batch)

    Lifetime play counts for up to 50 tracks in one call. Entries come back in request order with status ok, not_found or error; ids without a play count are also listed in missing. Each id is cached for 1 hour.

    پیرامیٹرزids, cache

  • GET /partner/trackPartner track data

    Track with its play count (data.trackUnion.playcount), album, artists and content ratings. Add slim=1 to keep only {id, uri, profile.name, visuals.avatarImage} of each artist (the full payload embeds the first artist's discography and is ~100 KB).

    پیرامیٹرزid, slim, cache

⁨/partner/tracks/count⁩ ⁨50⁩ تک کاما سے الگ ids لیتا ہے اور انہیں اسی ترتیب میں جواب دیتا ہے جس میں آپ نے بھیجی، اس لیے ⁨50⁩ ٹریکس کی ایک ہی درخواست لگتی ہے، ⁨50⁩ کی نہیں۔

پلے کاؤنٹس حاصل کریں

ایک ٹریک، Spotify id سے

id وہ 22 حرفی اسٹرنگ ہے جو کسی بھی Spotify URL میں ⁨/track/⁩ کے بعد آتی ہے۔ ٹریک کو اس کے ISRC سے تلاش کرنے کے لیے ⁨id=⁩ کی جگہ ⁨isrc=⁩ بھیجیں۔

ایک کال میں ⁨50⁩ ٹریکس تک

گنتی سے پہلے ہر انٹری کا ⁨status⁩ پڑھیں۔ انٹریز ids کی ترتیب میں واپس آتی ہیں؛ جس کا پلے کاؤنٹ نہ ہو اس کی جگہ ⁨not_found⁩ یا ⁨error⁩ لکھا ہوتا ہے، اور اسے ⁨missing⁩ میں دوبارہ بھی درج کیا جاتا ہے۔

کوڈ کے بغیر پلے کاؤنٹس

اگر گنتیاں آپ کے اپنے کوڈ کے بجائے اسپریڈ شیٹ کے لیے ہیں تو اسی مینٹینر کے دو Apify Actors انہیں ڈیٹا سیٹ کی شکل میں لوٹاتے ہیں۔ رن کے لیے Apify اکاؤنٹ چاہیے، API کلید نہیں: آپ لنکس پیسٹ کرتے ہیں اور JSON یا CSV ڈاؤن لوڈ کرتے ہیں۔

  • Spotify Play Count Scraper (نئے ٹیب میں کھلتا ہے)eduair94/spotify-play-count-scraper

    ٹریک، البم، فنکار یا پلے لسٹ کے لنکس، URIs یا ids پیسٹ کریں؛ یہ ہر ٹریک کی ایک قطار اس کے پلے کاؤنٹ کے ساتھ لوٹاتا ہے — فنکار کے ٹاپ ٹریکس یا پوری ڈسکوگرافی، البم یا پلے لسٹ کا ہر ٹریک — اور، مانگنے پر، فنکار کے ماہانہ سامعین کی ایک قطار۔

  • Spotify Scraper (نئے ٹیب میں کھلتا ہے)eduair94/spotify-scraper

    عمومی Actor: ⁨61⁩ کیٹیگریز، جن میں سے ⁨5⁩ پلے کاؤنٹس کی ہیں (⁨track_play_count, album_play_counts, artist_play_counts, artist_discography_play_counts, playlist_play_counts⁩)، اور ⁨isrc⁩، جو ٹریک کو اس کے ISRC سے پلے کاؤنٹ کے ساتھ ڈھونڈتی ہے۔

دونوں فی نتیجہ بل کرتے ہیں، ان قیمتوں پر جو ⁨⁩ کو درج تھیں: Apify کے مفت پلان پر ⁨$0.001⁩ فی قطار، Gold اور اس سے اوپر ⁨$0.0006⁩ تک۔ رن کب کلید سے بہتر ہے اور کب نہیں، یہ ⁨اسکریپر گائیڈ⁩ پر ہے۔

پہلے سے محفوظ تاریخچہ: spotify-most-streamed-songs (opens in a new tab) on GitHub has daily play counts and daily streams for 1,000 of the most-streamed songs, as CSV and JSON history.

AI اسسٹنٹ (MCP) سے استعمال کریں: Claude، Cursor یا VS Code سے کسی ٹریک کے اسٹریمز پوچھیں، اور Spotify MCP سرور کا ⁨get_track_play_count⁩ ٹول اس API سے کل پلے کاؤنٹس لوٹاتا ہے۔ ⁨MCP سرور سیٹ اپ کریں⁩۔

سوالات

کیا Spotify Web API پلے کاؤنٹس لوٹاتی ہے؟

نہیں۔ Web API ریفرنس کے ٹریک آبجیکٹ میں پلے کاؤنٹ کا کوئی فیلڈ نہیں ہے۔ اس کا قریب ترین فیلڈ popularity ہے، 0–100 کا اسکور جو Spotify زیادہ تر کل پلے اور ان کے حالیہ ہونے سے نکالتا ہے؛ ریفرنس اسے deprecated نشان زد کرتا ہے، اور Spotify کی فروری 2026 کی تبدیلیوں نے اسے 11 فروری 2026 سے بنائی گئی ڈیولپمنٹ موڈ ایپس کے لیے ہٹا دیا۔

کسی ٹریک پر 0 پلے کیوں دکھائی دیتے ہیں؟

کیونکہ اس کے 1,000 سے کم ہیں۔ اسپیک کہتی ہے کہ Spotify 1,000 سے کم پلے والے ٹریکس کے لیے 0 رپورٹ کرتا ہے، اس لیے 0 کا مطلب 1,000 سے کم ہے، کبھی نہیں چلا نہیں۔

کیا میں کئی ٹریکس کے پلے کاؤنٹس ایک ساتھ لے سکتا ہوں؟

جی ہاں۔ ⁨GET /partner/tracks/count⁩ ⁨50⁩ تک کاما سے الگ ٹریک ids لیتا ہے اور درخواست کی ترتیب میں جواب دیتا ہے، ہر انٹری کا status ⁨ok⁩، ⁨not_found⁩ یا ⁨error⁩ ہوتا ہے؛ جن ids کا پلے کاؤنٹ نہ ہو وہ ⁨missing⁩ میں بھی درج ہوتی ہیں۔ ⁨50⁩ ٹریکس کی ایک ہی درخواست لگتی ہے، ⁨50⁩ کی نہیں۔

کیا میں ٹریک کو ISRC سے تلاش کر سکتا ہوں؟

جی ہاں۔ ⁨GET /partner/track/count⁩ Spotify id کی جگہ ⁨isrc⁩ لیتا ہے، اس لیے ISRC سے چلنے والے کیٹلاگ کو پہلے id تلاش کرنے کی ضرورت نہیں۔

یہ عدد کتنا تازہ ہے؟

پلے کاؤنٹس ایک گھنٹہ کیش رہتے ہیں، اس لیے گنتی عموماً زیادہ سے زیادہ اتنی پرانی ہوتی ہے۔ ⁨X-Cache⁩ کی قدر اگر ⁨STALE⁩ یا ⁨FALLBACK⁩ سے شروع ہو تو اس کا مطلب ہے کہ لائیو فیچ سست رہا یا ناکام ہوا اس لیے پرانی کاپی دی گئی؛ ⁨X-Cache-Stale-Age⁩ اس کی عمر سیکنڈز میں بتاتا ہے۔ تازہ کاپی منگوانے کے لیے ⁨cache=false⁩ شامل کریں۔ اس سائٹ کے چلائیں بٹن ڈیمو کے اپنے کیش سے بھی گزرتے ہیں، اس لیے وہاں کا عدد زیادہ پرانا ہو سکتا ہے۔

کیا میں کوڈ لکھے بغیر پلے کاؤنٹس لے سکتا ہوں؟

جی ہاں، Apify پر: رن کے لیے Apify اکاؤنٹ چاہیے، API کلید نہیں۔ ⁨Spotify Play Count Scraper⁩ (⁨eduair94/spotify-play-count-scraper⁩) ٹریک، البم، فنکار یا پلے لسٹ کے لنکس لیتا ہے اور ہر ٹریک کی ایک قطار اس کے پلے کاؤنٹ کے ساتھ لوٹاتا ہے؛ ⁨Spotify Scraper⁩ (⁨eduair94/spotify-scraper⁩) کی ⁨61⁩ کیٹیگریز میں سے ⁨5⁩ پلے کاؤنٹ کی ہیں۔ دونوں فی نتیجہ بل کرتے ہیں۔

مجھے کون سا پلان چاہیے؟

کوئی بھی۔ دونوں پلے کاؤنٹ endpoints ہر پلان پر ہیں، RapidAPI اور ڈائریکٹ پورٹل دونوں پر، اور پلانز ماہانہ حجم میں مختلف ہیں۔ RapidAPI کا ہر پلان فی سیکنڈ ⁨5⁩ درخواستیں دیتا ہے اور ہر ڈائریکٹ کلید میں ⁨10⁩ شامل ہیں۔ RapidAPI کا مفت پلان ہر ماہ ⁨1,000⁩ درخواستیں دیتا ہے۔

ماخذ

More guides

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

کلید لیں اور اپنا پہلا پلے کاؤنٹ نکالیں

دونوں پلے کاؤنٹ endpoints ہر پلان پر ہیں، RapidAPI اور ڈائریکٹ پورٹل دونوں پر؛ Apify پر اوپر کے دونوں Actors وہی گنتیاں ڈیٹا سیٹ کی قطاروں کی شکل میں لوٹاتے ہیں، فی نتیجہ بل کے ساتھ۔ RapidAPI کا مفت پلان ہر ماہ ⁨1,000⁩ درخواستیں ہے: ہر کال میں ⁨50⁩ ٹریکس تک کے حساب سے، ⁨50,000⁩ پلے کاؤنٹس تک۔

RapidAPI Apify ڈائریکٹ پورٹل

ابھی خریدنے کے لیے تیار نہیں؟ ⁨مفت آزمائشی کلید حاصل کریں⁩: ⁨7⁩ دن میں ⁨500⁩ درخواستیں، کارڈ کے بغیر۔