வழிகாட்டி

Spotify ப்ளே கவுண்ட் API: ID அல்லது ISRC மூலம் எந்தப் பாடலின் மொத்த ஸ்ட்ரீம்கள்

ஒரு பாடல் எத்தனை முறை இயக்கப்பட்டது என்பதை Spotify-இன் Web API ஒருபோதும் சொல்வதில்லை. அதற்கு மிக அருகில் வருவது popularity: மொத்த ப்ளேக்களை முக்கியமாகக் கொண்டது என்று அதன் சொந்தக் குறிப்பு விவரிக்கும் 0–100 மதிப்பெண்; அதையும் அது நிறுத்தப்பட்டது (deprecated) எனக் குறிக்கிறது. இந்த endpoint-கள் எண்ணிக்கையையே தருகின்றன: Spotify ID அல்லது ISRC மூலம் ஒரு பாடல், அல்லது ஒரே அழைப்பில் 50 பாடல்கள் வரை.

Eduardo Airaudo எழுதியது, API-யின் பராமரிப்பாளர் · புதுப்பிக்கப்பட்டது 22 அக்டோபர், 2026

அதிகாரப்பூர்வ பாடல் பொருள் எதை விட்டுவிடுகிறது

Spotify Web API-இல் GET /v1/tracks/{id} ஆல்பம், கலைஞர்கள், duration_ms, explicit, external_ids, பெயர், popularity மற்றும் இன்னும் சிலவற்றைத் தருகிறது. அவற்றில் எதுவும் ப்ளேக்களை எண்ணுவதில்லை. popularity தான் மிக அருகில் வருகிறது: ஒரு பாடல் எத்தனை முறை இயக்கப்பட்டது, அவை எவ்வளவு சமீபத்தியவை என்பதை முக்கியமாகக் கொண்டு கணக்கிடப்படும் 0 முதல் 100 வரையிலான மதிப்பு என்று Spotify-இன் குறிப்பு அதைத் தருகிறது, மேலும் அதை நிறுத்தப்பட்டது எனக் குறிக்கிறது. Spotify-இன் பிப்ரவரி 2026 மாற்றங்கள் 11 பிப்ரவரி 2026 முதல் உருவாக்கப்பட்ட development-mode செயலிகளுக்கு அதை நீக்கின.

ஒரு மதிப்பெண் எண்ணிக்கை செய்வதைச் செய்ய முடியாது. இது ஒப்பீட்டு மதிப்பு, அதனால் ஆல்பம் அல்லது பட்டியல் முழுவதும் கூட்டினால் பொருந்தாது; மேலும் சமீபத்திய ப்ளேக்களுக்கு முன்னுரிமை தருகிறது — அதே குறிப்பு, இப்போது அதிகம் இயக்கப்படும் பாடல்கள், கடந்த காலத்தில் அதிகம் இயக்கப்பட்ட பாடல்களை விட அதிக மதிப்பெண் பெறுகின்றன என்கிறது — எனவே ஒரு பாடல் இதுவரை எத்தனை முறை இயக்கப்பட்டது என்பதை அது சொல்ல முடியாது.

spec-இன் சொற்களில், இந்த API-யின் Partner குழு “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count ஒரு பாடலின் மொத்த எண்ணிக்கையைத் தருகிறது, /partner/tracks/count 50 பாடல்கள் வரை ஒரே நேரத்தில் தருகிறது, /partner/track அதை முழுப் பாடல் பதிவுக்குள் வைத்துத் தருகிறது.

என்ன திரும்பி வருகிறது

புலம் புலமாக, spec-இன் response schema-க்கள் வரையறுப்பது போல. ஒற்றைப் பாடல் அழைப்பு எண்ணிக்கையை streams என்றும், தொகுதி அழைப்பு playcount என்றும் பெயரிடுகிறது.

ஒரு பாடல்

GET /partner/track/count

streams
மொத்த ப்ளே கவுண்ட், முழு எண்ணாக (int64). spec-இல் null ஆகலாம், 1,000-க்கும் குறைவான ப்ளேக்கள் உள்ள பாடலுக்கு 0.
spotify_track_id
பாடலின் Spotify ID.
isrc
பாடலின் ISRC. spec-இல் null ஆகலாம்.
result
success அல்லது error, அருகில் ஒரு சிறிய message உடன்.

ஒரு தொகுதி

GET /partner/tracks/count

tracks[]
கேட்கப்பட்ட ஒவ்வொரு ID-க்கும் ஒரு உள்ளீடு, கோரிக்கையின் வரிசையில்.
tracks[].playcount
மொத்த ப்ளேக்கள் (int64, null ஆகலாம்); 1,000-க்கும் குறைவான பாடலுக்கு 0.
tracks[].status
ok, not_found அல்லது error; அது error ஆக இருக்கும்போது error உரையுடன்.
tracks[].name
பாடலின் பெயர்; அது கிடைக்காதபோது null.
tracks[].artists[]
ஒவ்வொரு கலைஞரின் id மற்றும் name.
tracks[].releaseDate
பாடலின் ஆல்பத்தின் வெளியீட்டுத் தேதி: YYYY-MM-DD, அல்லது அதைவிடக் குறைவான துல்லியம்.
missing[]
ok அல்லாத நிலை கொண்ட, கேட்கப்பட்ட ID-கள்.

0 என்பது 1,000-க்குக் குறைவு என்று பொருள், ஒருபோதும் இயக்கப்படவில்லை என்றல்ல. 1,000-க்கும் குறைவான ப்ளேக்கள் உள்ள பாடல்களுக்கு Spotify 0 எனத் தெரிவிக்கிறது என்று spec சொல்கிறது; எனவே 0-வை எண்ணிக்கையாக அல்ல, “1,000-க்குக் கீழ்” என்று சேமியுங்கள்.

பதிவு செய்த மாதிரி · எடுத்த தேதி 2026-10-22

GET /partner/track/count

6 வரிகள் — பதிவு செய்த முழு body.

பதிவு செய்த மாதிரி · எடுத்த தேதி 2026-10-22

GET /partner/tracks/count

18 வரிகள் — பதிவு செய்த முழு body.

ஒரு பாடல், அல்லது ஒரு அழைப்புக்கு 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 மூலம் ஒரு பாடல்

ID என்பது எந்த Spotify URL-இலும் /track/ என்பதற்குப் பின் வரும் 22 எழுத்துச் சரம். ISRC மூலம் பாடலைத் தேட, id= இடத்தில் isrc= என்பதை அனுப்புங்கள்.

ஒரே அழைப்பில் 50 பாடல்கள் வரை

எண்ணிக்கைக்கு முன் ஒவ்வொரு உள்ளீட்டின் 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.

இரண்டும் அன்று பட்டியலிடப்பட்ட விலைகளில், முடிவுக்குக் கட்டணம் வசூலிக்கின்றன: 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, மொத்த ப்ளேக்களையும் அவை எவ்வளவு சமீபத்தியவை என்பதையும் முக்கியமாகக் கொண்டு Spotify கணக்கிடும் 0–100 மதிப்பெண்; குறிப்பு அதை நிறுத்தப்பட்டது எனக் குறிக்கிறது, Spotify-இன் பிப்ரவரி 2026 மாற்றங்கள் 11 பிப்ரவரி 2026 முதல் உருவாக்கப்பட்ட development-mode செயலிகளுக்கு அதை நீக்கின.

ஒரு பாடல் ஏன் 0 ப்ளேக்களைக் காட்டுகிறது?

ஏனெனில் அதற்கு 1,000-க்கும் குறைவு. 1,000-க்கும் குறைவான ப்ளேக்கள் உள்ள பாடல்களுக்கு Spotify 0 எனத் தெரிவிக்கிறது என்று spec சொல்கிறது; எனவே 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 தேடல் தேவையில்லை.

அந்த எண் எவ்வளவு சமீபத்தியது?

ப்ளே கவுண்ட்கள் ஒரு மணி நேரம் கேச் செய்யப்படுகின்றன, அதனால் ஒரு எண் பொதுவாக அதிகபட்சம் அவ்வளவு பழையதாக இருக்கும். STALE அல்லது FALLBACK என்று தொடங்கும் X-Cache மதிப்பு, நேரலைப் பெறுதல் மெதுவாக இருந்ததால் அல்லது தோல்வியடைந்ததால் பழைய நகல் வழங்கப்பட்டது என்று பொருள்; 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 ப்ளே கவுண்ட் வகைகளைக் கொண்டுள்ளது. இரண்டும் முடிவுக்குக் கட்டணம் வசூலிக்கின்றன.

எனக்கு எந்தத் திட்டம் தேவை?

எதுவும். இரண்டு ப்ளே கவுண்ட் endpoint-களும் ஒவ்வொரு திட்டத்திலும் உள்ளன, RapidAPI-யிலும் நேரடி போர்ட்டலிலும்; திட்டங்கள் மாதாந்திர அளவில் வேறுபடுகின்றன. ஒவ்வொரு RapidAPI திட்டமும் வினாடிக்கு 5 கோரிக்கைகளை அனுமதிக்கிறது; ஒவ்வொரு நேரடி விசையிலும் 10 உள்ளடங்கும். RapidAPI-இன் இலவசத் திட்டம் மாதம் 1,000 கோரிக்கைகளை அனுமதிக்கிறது.

ஆதாரங்கள்

More guides

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

ஒரு விசையைப் பெற்று உங்கள் முதல் ப்ளே கவுண்ட்டை எடுங்கள்

இரண்டு ப்ளே கவுண்ட் endpoint-களும் ஒவ்வொரு திட்டத்திலும் உள்ளன, RapidAPI-யிலும் நேரடி போர்ட்டலிலும்; Apify-இல் மேலுள்ள இரண்டு actor-களும் அதே எண்ணிக்கைகளை டேட்டாசெட் வரிசைகளாகத் தருகின்றன, முடிவுக்குக் கட்டணம். RapidAPI-இன் இலவச நிலை மாதம் 1,000 கோரிக்கைகள்: ஒரு அழைப்புக்கு 50 பாடல்கள் வரை என்ற கணக்கில், 50,000 ப்ளே கவுண்ட்கள் வரை.

RapidAPI Apify நேரடி போர்ட்டல்

இன்னும் வாங்கத் தயாராக இல்லையா? இலவச சோதனை விசை பெறுங்கள்: 7 நாட்களில் 500 கோரிக்கைகள், கார்டு தேவையில்லை.