गाइड

Spotify प्ले काउंट API: id या ISRC से किसी भी ट्रैक की कुल स्ट्रीम

Spotify का Web API कभी नहीं बताता कि कोई ट्रैक कितनी बार चला है। सबसे नज़दीक popularity है, 0–100 का एक स्कोर जिसे उसका अपना रेफ़रेंस ज़्यादातर कुल प्ले पर आधारित बताता है और डिप्रिकेटेड चिह्नित करता है। ये एंडपॉइंट खुद गिनती लौटाते हैं: 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 के बीच की वैल्यू बताता है, जो ज़्यादातर इस पर निर्भर है कि ट्रैक कितनी बार चला और कितने हाल में, और इसे डिप्रिकेटेड चिह्नित करता है। Spotify के फ़रवरी 2026 के बदलावों ने 11 फ़रवरी 2026 से बने डेवलपमेंट-मोड ऐप के लिए इसे हटा दिया।

स्कोर वह काम नहीं कर सकता जो गिनती करती है। वह सापेक्ष होता है, इसलिए किसी एल्बम या पूरे कैटलॉग में जोड़ा नहीं जा सकता, और वह हाल के प्ले को तरजीह देता है — उसी रेफ़रेंस के अनुसार जो गाने अभी बहुत चल रहे हैं, उनका स्कोर उन गानों से ज़्यादा होता है जो पहले बहुत चले थे — इसलिए वह यह नहीं बता सकता कि कोई ट्रैक अब तक कितनी बार चला है।

स्पेक के शब्दों में, इस 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[]: माँगी गई वे id जिनका स्टेटस ok नहीं है।

0 का मतलब 1,000 से कम है, कभी नहीं चला नहीं। स्पेक के अनुसार Spotify 1,000 से कम प्ले वाले ट्रैक के लिए 0 रिपोर्ट करता है, इसलिए 0 को गिनती की तरह नहीं, “1,000 से कम” की तरह स्टोर करें।

रिकॉर्डेड सैंपल · 2026-10-22 को लिया गया

GET /partner/track/count

{

"result": "success",

"message": "Data Retrieved.",

"spotify_track_id": "7qiZfU4dY1lWllzX7mPBI3",

"streams": 5152826895

}

6 पंक्तियाँ — पूरी रिकॉर्ड की गई बॉडी।

रिकॉर्डेड सैंपल · 2026-10-22 को लिया गया

GET /partner/tracks/count

{

"tracks": [

{

"id": "7qiZfU4dY1lWllzX7mPBI3",

"name": "Shape of You",

"artists": [

{

"id": "6eUKZXaKkcviH0Ku9w2n3V",

"name": "Ed Sheeran"

}

"playcount": 5152826895,

"releaseDate": "2017-03-03",

"status": "ok"

}

"missing": []

}

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 id तक लेता है और उसी क्रम में जवाब देता है जिसमें आपने भेजी थीं, इसलिए 50 ट्रैक की कीमत 50 रिक्वेस्ट नहीं, एक रिक्वेस्ट है।

प्ले काउंट पाएँ

Spotify id से एक ट्रैक

curl -X GET \

"https://spotify-proxy.checkleaked.cc/spotify-data/partner/track/count?id=0VjIjW4GlUZAMYd2vXMi3b" \

-H "x-rapidapi-key: $SPOTIFY_API_KEY"

id वह 22 अक्षरों की स्ट्रिंग है जो किसी भी Spotify URL में /track/ के बाद आती है। ISRC से ट्रैक ढूँढने के लिए id= की जगह isrc= भेजें।

एक कॉल में 50 ट्रैक तक

curl -X GET \

"https://spotify-proxy.checkleaked.cc/spotify-data/partner/tracks/count?ids=0VjIjW4GlUZAMYd2vXMi3b%2C7qiZfU4dY1lWllzX7mPBI3" \

-H "x-rapidapi-key: $SPOTIFY_API_KEY"

गिनती से पहले हर एंट्री का status पढ़ें। एंट्री id के क्रम में लौटती हैं; जिसका प्ले काउंट नहीं है, उसकी जगह not_found या error चिह्नित होता है, और वह missing में फिर से सूचीबद्ध होती है।

बिना कोड के प्ले काउंट

अगर गिनती आपके अपने कोड के लिए नहीं, स्प्रेडशीट के लिए चाहिए, तो उसी मेंटेनर के दो Apify actor उन्हें डेटासेट के रूप में लौटाते हैं। रन के लिए Apify अकाउंट चाहिए, API कुंजी नहीं: आप लिंक पेस्ट करते हैं और JSON या CSV डाउनलोड करते हैं।

Spotify Play Count Scraper (नए टैब में खुलता है)eduair94/spotify-play-count-scraper
ट्रैक, एल्बम, कलाकार या प्लेलिस्ट के लिंक, URI या id पेस्ट करें; यह हर ट्रैक की एक पंक्ति उसके प्ले काउंट के साथ लौटाता है — कलाकार के टॉप ट्रैक या पूरी डिस्कोग्राफ़ी, एल्बम या प्लेलिस्ट का हर ट्रैक — और माँगने पर कलाकार के मासिक श्रोताओं की एक पंक्ति भी।
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 से ट्रैक को उसके प्ले काउंट के साथ ढूँढता है।

दोनों प्रति नतीजा बिल करते हैं, 22 अक्तूबर 2026 को सूचीबद्ध कीमतों पर: 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 ज़्यादातर कुल प्ले और उनकी ताज़गी से निकालता है; रेफ़रेंस इसे डिप्रिकेटेड चिह्नित करता है, और Spotify के फ़रवरी 2026 के बदलावों ने 11 फ़रवरी 2026 से बने डेवलपमेंट-मोड ऐप के लिए इसे हटा दिया।

किसी ट्रैक के 0 प्ले क्यों दिखते हैं?

क्योंकि उसके 1,000 से कम प्ले हैं। स्पेक के अनुसार Spotify 1,000 से कम प्ले वाले ट्रैक के लिए 0 रिपोर्ट करता है, इसलिए 0 का मतलब 1,000 से कम है, कभी नहीं चला नहीं।

क्या एक साथ कई ट्रैक के प्ले काउंट मिल सकते हैं?

हाँ। GET /partner/tracks/count कॉमा से अलग 50 ट्रैक id तक लेता है और रिक्वेस्ट के क्रम में जवाब देता है, हर एंट्री का स्टेटस ok, not_found या error होता है; जिन id का प्ले काउंट नहीं है, वे 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 श्रेणियाँ प्ले काउंट की हैं। दोनों प्रति नतीजा बिल करते हैं।

मुझे कौन सा प्लान चाहिए?

कोई भी। दोनों प्ले काउंट एंडपॉइंट हर प्लान पर हैं, चाहे RapidAPI हो या डायरेक्ट पोर्टल, और प्लान सिर्फ़ मासिक वॉल्यूम में अलग हैं। हर RapidAPI प्लान प्रति सेकंड 5 रिक्वेस्ट देता है और हर डायरेक्ट कुंजी में 10 शामिल हैं। RapidAPI का मुफ़्त प्लान महीने में 1,000 रिक्वेस्ट देता है।

स्रोत

Get Track — Spotify Web API रेफ़रेंस — आधिकारिक ट्रैक ऑब्जेक्ट: प्ले काउंट नहीं, और popularity डिप्रिकेटेड चिह्नित।
फ़रवरी 2026 के बदलाव — Spotify for Developers रेफ़रेंस — हटाए गए फ़ील्ड में ट्रैक popularity।
फ़रवरी 2026 माइग्रेशन गाइड — Spotify for Developers — हटाने का असर किन पर है: डेवलपमेंट-मोड ऐप, 11 फ़रवरी 2026 से नए बने; एक्सटेंडेड-कोटा ऐप पर असर नहीं।
इस साइट पर GET /partner/track/count — इसके पैरामीटर, इसके एरर स्टेटस और एक चलाएँ बटन।
इस साइट पर GET /partner/tracks/count — बैच कॉल, इन्हीं सब के साथ।
Apify पर Spotify Play Count Scraper — बिना कोड का रास्ता: इसका इनपुट और प्रति पंक्ति कीमत, जैसी अभी प्रकाशित है।

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

कुंजी लें और अपना पहला प्ले काउंट निकालें

दोनों प्ले काउंट एंडपॉइंट हर प्लान पर हैं, चाहे RapidAPI हो या डायरेक्ट पोर्टल; Apify पर ऊपर के दोनों actor वही गिनती डेटासेट की पंक्तियों के रूप में लौटाते हैं, प्रति नतीजा बिल के साथ। RapidAPI का मुफ़्त टियर महीने में 1,000 रिक्वेस्ट देता है: हर कॉल में 50 ट्रैक तक के हिसाब से 50,000 प्ले काउंट तक।

RapidAPI Apify डायरेक्ट पोर्टल

अभी खरीदने के लिए तैयार नहीं? मुफ़्त ट्रायल कुंजी पाएँ: 7 दिन में 500 रिक्वेस्ट, कार्ड नहीं।