मार्गदर्शिका
Spotify प्ले काउंट API: id किंवा ISRC द्वारे कोणत्याही ट्रॅकचे एकूण स्ट्रीम्स
Spotify चे Web API एखादा ट्रॅक किती वेळा प्ले झाला हे कधीच सांगत नाही. सर्वात जवळ जाते ते popularity, 0–100 चा स्कोअर, ज्याचे वर्णन त्याचा स्वतःचा संदर्भ बहुतांशी एकूण प्लेवर आधारित असे करतो, आणि जो deprecated म्हणून चिन्हांकित आहे. हे endpoints काउंट स्वतः परत करतात: Spotify id किंवा ISRC द्वारे एक ट्रॅक, किंवा एका कॉलमध्ये ५० पर्यंत ट्रॅक्स.
Eduardo Airaudo, API चे मेंटेनर · अपडेट: २२ ऑक्टोबर, २०२६
अधिकृत ट्रॅक ऑब्जेक्ट काय वगळतो
Spotify Web API वरील GET /v1/tracks/{id} अल्बम, कलाकार, duration_ms, explicit, external_ids, नाव, popularity आणि आणखी काही फील्ड्स परत करतो. त्यापैकी कोणतेही प्ले मोजत नाही. Popularity सर्वात जवळची आहे: Spotify चा संदर्भ तिला 0 ते 100 मधील व्हॅल्यू म्हणतो, जी मुख्यतः ट्रॅक किती वेळा प्ले झाला आणि ते प्ले किती अलीकडचे आहेत यावरून काढली जाते, आणि तिला deprecated चिन्हांकित करतो. Spotify च्या फेब्रुवारी 2026 च्या बदलांनी 11 फेब्रुवारी 2026 पासून तयार केलेल्या डेव्हलपमेंट-मोड ॲप्ससाठी ती काढून टाकली.
काउंट जे करतो ते स्कोअर करू शकत नाही. तो सापेक्ष असतो, म्हणून अल्बम किंवा कॅटलॉगमध्ये त्याची बेरीज होत नाही, आणि तो अलीकडच्या प्लेला प्राधान्य देतो — तोच संदर्भ म्हणतो की आता खूप प्ले होणारी गाणी भूतकाळात खूप प्ले झालेल्या गाण्यांपेक्षा जास्त स्कोअर करतात — म्हणून ट्रॅक आजवर एकूण किती वेळा प्ले झाला हे तो सांगू शकत नाही.
स्पेकच्या शब्दांत, या API चा Partner गट “Spotify's internal (pathfinder) data, including play counts” आहे. /partner/track/count एका ट्रॅकचे एकूण काउंट देतो, /partner/tracks/count ५० पर्यंत ट्रॅक्सचे एकाच वेळी, आणि /partner/track ते पूर्ण ट्रॅक रेकॉर्डमध्ये देतो.
काय परत येते
फील्डनुसार, स्पेकच्या response schemas नुसार. एका ट्रॅकचा कॉल काउंटला 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 साठी एक नोंद, request च्या क्रमाने.
- 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 चा status
okनाही.
0 म्हणजे 1,000 पेक्षा कमी, कधीच प्ले न झालेले नाही. स्पेक म्हणतो की 1,000 पेक्षा कमी प्ले असलेल्या ट्रॅक्ससाठी Spotify 0 नोंदवते, म्हणून 0 हे काउंट म्हणून नाही तर “1,000 पेक्षा कमी” म्हणून साठवा.
रेकॉर्ड केलेला नमुना · 2026-10-22 रोजी घेतलेला
GET /partner/track/count
| { |
| "result": "success", |
| "message": "Data Retrieved.", |
| "spotify_track_id": "7qiZfU4dY1lWllzX7mPBI3", |
| "streams": 5152826895 |
| } |
६ ओळी — संपूर्ण रेकॉर्ड केलेला body.
रेकॉर्ड केलेला नमुना · 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": [] |
| } |
१८ ओळी — संपूर्ण रेकॉर्ड केलेला body.
एक ट्रॅक, किंवा प्रति कॉल ५०
- GET /partner/track/countTrack play count
Lifetime play count of one track, by Spotify id (
spotify_track_id, or its aliasid) or byisrc. 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
statusok,not_foundorerror; ids without a play count are also listed inmissing. 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. Addslim=1to 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 स्वल्पविरामाने विभक्त ५० पर्यंत id घेतो आणि आपण पाठवलेल्या क्रमानेच उत्तर देतो, म्हणून ५० ट्रॅक्ससाठी ५० requests ऐवजी एकच request लागते.
प्ले काउंट मिळवा
एक ट्रॅक, 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 म्हणजे कोणत्याही Spotify URL मध्ये /track/ नंतरची 22 अक्षरांची स्ट्रिंग. ट्रॅक त्याच्या ISRC ने शोधण्यासाठी id= च्या जागी isrc= पाठवा.
एका कॉलमध्ये ५० पर्यंत ट्रॅक्स
| 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 actors ते डेटासेट म्हणून देतात. रनसाठी Apify खाते लागते, API key नाही: आपण लिंक्स पेस्ट करता आणि JSON किंवा CSV डाउनलोड करता.
- Spotify Play Count Scraper (नवीन टॅबमध्ये उघडते)eduair94/spotify-play-count-scraper
ट्रॅक, अल्बम, कलाकार किंवा प्लेलिस्टच्या लिंक्स, URIs किंवा id पेस्ट करा; तो प्रत्येक ट्रॅकसाठी एक रो त्याच्या प्ले काउंटसह देतो — कलाकाराचे टॉप ट्रॅक्स किंवा संपूर्ण डिस्कोग्राफी, अल्बम किंवा प्लेलिस्टवरील प्रत्येक ट्रॅक — आणि मागितल्यास कलाकाराच्या मासिक श्रोत्यांसह एक रो.
- Spotify Scraper (नवीन टॅबमध्ये उघडते)eduair94/spotify-scraper
सर्वसाधारण actor: ६१ कॅटेगरीज, त्यापैकी ५ प्ले काउंटच्या (
track_play_count,album_play_counts,artist_play_counts,artist_discography_play_counts,playlist_play_counts), आणिisrc, जो ट्रॅक त्याच्या ISRC ने त्याच्या प्ले काउंटसह शोधतो.
दोन्ही प्रति निकाल बिल करतात, रोजी दिलेल्या किमतींनुसार: Apify च्या मोफत प्लॅनवर प्रति रो $0.001, Gold पासून पुढे $0.0006 पर्यंत कमी. रन key पेक्षा कधी चांगला ठरतो आणि कधी नाही हे scraper मार्गदर्शिकेत वर आहे.
आधीच ठेवलेला इतिहास: 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 server चे get_track_play_count टूल या API मधून एकूण प्ले काउंट परत करते. MCP server सेट करा.
प्रश्न
Spotify Web API प्ले काउंट परत करते का?
नाही. Web API संदर्भातील ट्रॅक ऑब्जेक्टमध्ये प्ले काउंट फील्ड नाही. त्याचे सर्वात जवळचे फील्ड, popularity, हा 0–100 चा स्कोअर आहे जो Spotify मुख्यतः एकूण प्ले आणि ते किती अलीकडचे आहेत यावरून काढते; संदर्भ त्याला deprecated चिन्हांकित करतो, आणि Spotify च्या फेब्रुवारी 2026 च्या बदलांनी 11 फेब्रुवारी 2026 पासून तयार केलेल्या डेव्हलपमेंट-मोड ॲप्ससाठी तो काढून टाकला.
ट्रॅकला 0 प्ले का दिसतात?
कारण त्याचे प्ले 1,000 पेक्षा कमी आहेत. स्पेक म्हणतो की 1,000 पेक्षा कमी प्ले असलेल्या ट्रॅक्ससाठी Spotify 0 नोंदवते, म्हणून 0 म्हणजे 1,000 पेक्षा कमी, कधीच प्ले न झालेले नाही.
अनेक ट्रॅक्ससाठी एकदम प्ले काउंट मिळवता येतात का?
हो. GET /partner/tracks/count स्वल्पविरामाने विभक्त ५० पर्यंत ट्रॅक id घेतो आणि request च्या क्रमाने उत्तर देतो, प्रत्येक नोंदीचा status ok, not_found किंवा error; प्ले काउंट नसलेले id missing मध्येही दिले जातात. ५० ट्रॅक्ससाठी ५० requests ऐवजी एकच request लागते.
ट्रॅक ISRC द्वारे शोधता येतो का?
हो. GET /partner/track/count Spotify id च्या जागी isrc घेतो, त्यामुळे ISRC वर आधारित कॅटलॉगला आधी id लुकअप करावा लागत नाही.
आकडा किती ताजा आहे?
प्ले काउंट एक तासासाठी कॅश केले जातात, त्यामुळे काउंट साधारणपणे जास्तीत जास्त तितकाच जुना असतो. X-Cache व्हॅल्यू STALE किंवा FALLBACK ने सुरू होत असेल, तर लाइव्ह फेच संथ होता किंवा अयशस्वी झाला म्हणून जुनी कॉपी दिली गेली; X-Cache-Stale-Age तिचे वय सेकंदांत देतो. नवीन कॉपी मिळवण्यासाठी cache=false जोडा. या साइटवरील चालवा बटणेही डेमोच्या स्वतःच्या कॅशमधून जातात, त्यामुळे तिथला आकडा जास्त जुना असू शकतो.
कोड न लिहिता प्ले काउंट मिळवता येतात का?
हो, Apify वर: रनसाठी Apify खाते लागते, API key नाही. Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) ट्रॅक, अल्बम, कलाकार किंवा प्लेलिस्टच्या लिंक्स घेतो आणि प्रत्येक ट्रॅकसाठी एक रो त्याच्या प्ले काउंटसह देतो; Spotify Scraper (eduair94/spotify-scraper) च्या ६१ पैकी ५ कॅटेगरीज प्ले काउंटच्या आहेत. दोन्ही प्रति निकाल बिल करतात.
मला कोणता प्लॅन लागेल?
कोणताही. दोन्ही प्ले काउंट endpoints प्रत्येक प्लॅनवर आहेत, RapidAPI आणि डायरेक्ट पोर्टल दोन्हीवर, आणि प्लॅन्समध्ये फरक मासिक व्हॉल्यूमचा आहे. प्रत्येक RapidAPI प्लॅन प्रति सेकंद ५ requests ला परवानगी देतो आणि प्रत्येक डायरेक्ट key मध्ये १० समाविष्ट आहेत. RapidAPI चा मोफत प्लॅन दरमहा १,००० requests ला परवानगी देतो.
स्रोत
- Get Track — Spotify Web API संदर्भ — अधिकृत ट्रॅक ऑब्जेक्ट: प्ले काउंट नाही, आणि popularity deprecated म्हणून चिन्हांकित.
- फेब्रुवारी 2026 चे बदल — Spotify for Developers संदर्भ — काढून टाकलेल्या फील्ड्समध्ये ट्रॅक popularity.
- फेब्रुवारी 2026 मायग्रेशन मार्गदर्शिका — Spotify for Developers — काढण्याचा परिणाम कोणावर होतो: डेव्हलपमेंट-मोड ॲप्स, 11 फेब्रुवारी 2026 पासूनची नवीन; extended-quota ॲप्सवर परिणाम होत नाही.
- या साइटवर GET /partner/track/count — त्याचे पॅरामीटर्स, त्याचे एरर स्टेटस आणि चालवा बटण.
- या साइटवर GET /partner/tracks/count — बॅच कॉल, त्याच गोष्टींसह.
- Apify वर Spotify Play Count Scraper — कोडशिवायचा मार्ग: त्याचा इनपुट आणि प्रति रो किंमत, सध्या प्रकाशित केल्याप्रमाणे.
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 monthly listeners APIMonthly listeners, follower counts, world rank and top cities per artist — numbers the Web API never returned.
- 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.
key मिळवा आणि आपले पहिले प्ले काउंट काढा
दोन्ही प्ले काउंट endpoints प्रत्येक प्लॅनवर आहेत, RapidAPI आणि डायरेक्ट पोर्टल दोन्हीवर; Apify वर वरील दोन actors तेच काउंट डेटासेट रो म्हणून देतात, प्रति निकाल बिल होतात. RapidAPI चा मोफत टियर दरमहा १,००० requests आहे: प्रति कॉल ५० पर्यंत ट्रॅक्स असल्याने, ५०,००० पर्यंत प्ले काउंट.
खरेदीसाठी तयार नाही? मोफत ट्रायल key मिळवा: ७ दिवसांत ५०० requests, कार्डशिवाय.