గైడ్

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 నుండి సృష్టించిన డెవలప్‌మెంట్-మోడ్ యాప్‌ల కోసం దాన్ని తొలగించాయి.

కౌంట్ చేసే పనిని స్కోర్ చేయలేదు. ఇది సాపేక్షమైనది, కాబట్టి ఆల్బమ్ లేదా కేటలాగ్ అంతటా కూడదు, ఇటీవలి ప్లేలకే ప్రాధాన్యం ఇస్తుంది — అదే రిఫరెన్స్ ఇప్పుడు ఎక్కువగా ప్లే అవుతున్న పాటలకు గతంలో ఎక్కువగా ప్లే అయిన పాటల కంటే ఎక్కువ స్కోర్ వస్తుందని చెబుతుంది — కాబట్టి ఒక ట్రాక్ ఇప్పటివరకు మొత్తం ఎన్నిసార్లు ప్లే అయిందో అది చెప్పలేదు.

స్పెక్ మాటల్లో, ఈ API Partner గ్రూప్ “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count ఒక ట్రాక్ మొత్తం కౌంట్‌ను ఇస్తుంది, /partner/tracks/count 50 ట్రాక్స్ వరకు ఒకేసారి ఇస్తుంది, /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[]
status ok కాని అడిగిన ids.

0 అంటే 1,000 కంటే తక్కువ, ఎప్పుడూ ప్లే కాలేదని కాదు. 1,000 కంటే తక్కువ ప్లేలు ఉన్న ట్రాక్స్‌కు Spotify 0 ఇస్తుందని స్పెక్ చెబుతుంది, కాబట్టి 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 ids వరకు తీసుకుని, మీరు పంపిన క్రమంలోనే సమాధానం ఇస్తుంది, కాబట్టి 50 ట్రాక్స్‌కు 50 requests కాకుండా ఒకే request అవుతుంది.

ప్లే కౌంట్‌లను పొందండి

ఒక ట్రాక్, Spotify id తో

id అంటే ఏ Spotify URL లోనైనా /track/ తర్వాత ఉండే 22 అక్షరాల స్ట్రింగ్. ట్రాక్‌ను దాని ISRC తో వెతకడానికి id= స్థానంలో isrc= పంపండి.

ఒకే కాల్‌లో 50 ట్రాక్స్ వరకు

కౌంట్ కంటే ముందు ప్రతి ఎంట్రీ status చదవండి. ఎంట్రీలు ids క్రమంలో తిరిగి వస్తాయి; ప్లే కౌంట్ లేని ఎంట్రీ దాని స్థానంలో not_found లేదా error గా గుర్తించబడి, missing లో మళ్లీ జాబితా అవుతుంది.

కోడ్ లేకుండా ప్లే కౌంట్‌లు

కౌంట్‌లు మీ సొంత కోడ్ కోసం కాకుండా స్ప్రెడ్‌షీట్ కోసం అయితే, అదే నిర్వాహకుల రెండు Apify actors వాటిని డేటాసెట్‌గా ఇస్తాయి. రన్‌కు Apify ఖాతా కావాలి, API key అవసరం లేదు: మీరు లింక్‌లను పేస్ట్ చేసి JSON లేదా CSV డౌన్‌లోడ్ చేసుకుంటారు.

  • Spotify Play Count Scraper (కొత్త ట్యాబ్‌లో తెరుచుకుంటుంది)eduair94/spotify-play-count-scraper

    ట్రాక్, ఆల్బమ్, ఆర్టిస్ట్ లేదా ప్లేలిస్ట్ లింక్‌లు, URIలు లేదా 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 వరకు తగ్గుతుంది. రన్ ఎప్పుడు 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, ఇది Spotify ఎక్కువగా మొత్తం ప్లేలు, అవి ఎంత ఇటీవలివి అనే దాని నుండి లెక్కించే 0–100 స్కోర్; రిఫరెన్స్ దాన్ని deprecated అని గుర్తిస్తుంది, Spotify ఫిబ్రవరి 2026 మార్పులు 11 ఫిబ్రవరి 2026 నుండి సృష్టించిన డెవలప్‌మెంట్-మోడ్ యాప్‌ల కోసం దాన్ని తొలగించాయి.

ఒక ట్రాక్ 0 ప్లేలు ఎందుకు చూపిస్తుంది?

ఎందుకంటే దానికి 1,000 కంటే తక్కువ ఉన్నాయి. 1,000 కంటే తక్కువ ప్లేలు ఉన్న ట్రాక్స్‌కు Spotify 0 ఇస్తుందని స్పెక్ చెబుతుంది, కాబట్టి 0 అంటే 1,000 కంటే తక్కువ, ఎప్పుడూ ప్లే కాలేదని కాదు.

చాలా ట్రాక్స్ ప్లే కౌంట్‌లను ఒకేసారి పొందవచ్చా?

పొందవచ్చు. GET /partner/tracks/count కామాతో వేరు చేసిన 50 ట్రాక్ ids వరకు తీసుకుని request క్రమంలో సమాధానం ఇస్తుంది, ప్రతి ఎంట్రీకి status ok, not_found లేదా error; ప్లే కౌంట్ లేని ids missing లో కూడా జాబితా అవుతాయి. 50 ట్రాక్స్‌కు 50 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) లోని 61 కేటగిరీలలో 5 ప్లే కౌంట్ కేటగిరీలు. రెండూ ఫలితానికి బిల్ చేస్తాయి.

నాకు ఏ ప్లాన్ కావాలి?

ఏదైనా. రెండు ప్లే కౌంట్ endpoints ప్రతి ప్లాన్‌లో ఉన్నాయి, RapidAPI, డైరెక్ట్ పోర్టల్ రెండింటిలోనూ, ప్లాన్‌ల మధ్య తేడా నెలవారీ వాల్యూమ్. ప్రతి RapidAPI ప్లాన్ సెకనుకు 5 requests అనుమతిస్తుంది, ప్రతి డైరెక్ట్ key లో 10 కలిపి ఉంటాయి. RapidAPI ఉచిత ప్లాన్ నెలకు 1,000 requests అనుమతిస్తుంది.

మూలాలు

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

key పొంది మీ మొదటి ప్లే కౌంట్‌ను తీసుకోండి

రెండు ప్లే కౌంట్ endpoints ప్రతి ప్లాన్‌లో ఉన్నాయి, RapidAPI, డైరెక్ట్ పోర్టల్ రెండింటిలోనూ; Apify లో పైన ఉన్న రెండు actors అవే కౌంట్‌లను డేటాసెట్ వరుసలుగా ఇస్తాయి, ఫలితానికి బిల్ అవుతాయి. RapidAPI ఉచిత టియర్ నెలకు 1,000 requests: ఒక్కో కాల్‌కు 50 ట్రాక్స్ వరకు అంటే, 50,000 ప్లే కౌంట్‌ల వరకు.

కొనడానికి ఇంకా సిద్ధంగా లేరా? ఉచిత ట్రయల్ key పొందండి: 7 రోజుల్లో 500 requests, కార్డ్ అవసరం లేదు.