Gabay

Spotify play count API: kabuuang stream ng kahit anong kanta, gamit ang id o ISRC

Hindi kailanman sinasabi ng Web API ng Spotify kung ilang beses na-play ang isang kanta. Ang pinakamalapit dito ay ang popularity, isang 0–100 na score na inilalarawan ng sarili nitong reference bilang nakabatay higit sa lahat sa kabuuang play, at minarkahan nitong deprecated. Ibinabalik ng mga endpoint na ito ang mismong bilang: isang kanta gamit ang Spotify id o ISRC, o hanggang 50 kanta sa isang tawag.

Ni Eduardo Airaudo, maintainer ng API · Na-update Oktubre 22, 2026

Ano ang hindi isinasama ng opisyal na track object

Ibinabalik ng GET /v1/tracks/{id} sa Spotify Web API ang album, ang mga artist, duration_ms, explicit, external_ids, ang pangalan, popularity, at ilan pang field. Wala sa mga ito ang nagbibilang ng play. Ang popularity ang pinakamalapit: ibinibigay ito ng reference ng Spotify bilang value na 0 hanggang 100, na kinakalkula higit sa lahat mula sa dami ng play ng isang kanta at kung gaano kabago ang mga ito, at minamarkahan itong deprecated. Inalis ito ng mga pagbabago ng Spotify noong Pebrero 2026 para sa mga app sa development mode na ginawa mula 11 Pebrero 2026.

Hindi magagawa ng isang score ang kayang gawin ng isang bilang. Relative ito, kaya hindi ito nagsasama-sama sa isang album o catalog, at pinapaboran nito ang mga kamakailang play — sinasabi ng parehong reference na mas mataas ang score ng mga kantang maraming play ngayon kaysa sa mga kantang maraming play noon — kaya hindi nito masasabi kung ilang beses na-play ang isang kanta sa buong panahon.

Sa mga salita ng spec, ang Partner group ng API na ito ay “Spotify's internal (pathfinder) data, including play counts”. Ibinabalik ng /partner/track/count ang kabuuang bilang ng isang kanta, ibinabalik ng /partner/tracks/count ang sa hanggang 50 kanta nang sabay-sabay, at dala ng /partner/track ito sa loob ng buong record ng kanta.

Ano ang ibinabalik

Isa-isang field, ayon sa pagkakadefine ng mga response schema ng spec. Tinatawag ng single-track na tawag ang bilang na streams; playcount naman ang tawag dito ng batch.

Isang kanta

GET /partner/track/count

streams: Ang kabuuang play count, bilang integer (int64). Nullable sa spec, at 0 para sa kantang wala pang 1,000 play.
spotify_track_id: Ang Spotify id ng kanta.
isrc: Ang ISRC ng kanta. Nullable sa spec.
result: success o error, na may maikling message sa tabi nito.

Isang batch

GET /partner/tracks/count

tracks[]: Isang entry kada hiniling na id, ayon sa pagkakasunod ng request.
tracks[].playcount: Kabuuang play (int64, nullable); 0 para sa kantang wala pang 1,000.
tracks[].status: ok, not_found, o error, na may error na text kapag error ito.
tracks[].name: Pangalan ng kanta; null kapag hindi ito nahanap.
tracks[].artists[]: id at name ng bawat artist.
tracks[].releaseDate: Ang release date ng album ng kanta: YYYY-MM-DD, o mas magaspang na precision.
missing[]: Ang mga hiniling na id na ang status ay hindi ok.

Ang 0 ay nangangahulugang wala pang 1,000, hindi hindi pa napapakinggan. Sinasabi ng spec na 0 ang iniuulat ng Spotify para sa mga kantang wala pang 1,000 play, kaya itala ang 0 bilang “wala pang 1,000” sa halip na bilang.

Naitalang sample · kinuha noong 2026-10-22

GET /partner/track/count

{

"result": "success",

"message": "Data Retrieved.",

"spotify_track_id": "7qiZfU4dY1lWllzX7mPBI3",

"streams": 5152826895

}

6 linya — ang buong naitalang body.

Naitalang sample · kinuha noong 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 linya — ang buong naitalang body.

Isang kanta, o 50 kada tawag

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.
Mga paramspotify_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.
Mga paramids, 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).
Mga paramid, slim, cache

Tumatanggap ang /partner/tracks/count ng hanggang 50 id na pinaghiwalay ng kuwit at sumasagot ayon sa pagkakasunod na ipinadala, kaya isang request lang ang gastos ng 50 kanta sa halip na 50.

Kunin ang mga play count

Isang kanta, gamit ang Spotify id

curl -X GET \

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

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

Ang id ay ang 22-character na string pagkatapos ng /track/ sa kahit anong Spotify URL. Para hanapin ang kanta gamit ang ISRC nito, ipadala ang isrc= sa halip na id=.

Hanggang 50 kanta sa isang tawag

curl -X GET \

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

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

Basahin ang status ng bawat entry bago ang bilang nito. Bumabalik ang mga entry ayon sa pagkakasunod ng mga id; ang entry na walang play count ay minamarkahang not_found o error bilang kapalit, at inililista muli sa missing.

Mga play count nang walang code

Kung para sa spreadsheet ang mga bilang at hindi para sa sarili mong code, dalawang Apify actor mula sa iisang maintainer ang nagbabalik ng mga ito bilang dataset. Kailangan ng Apify account sa isang run at hindi API key: mag-paste ng mga link at mag-download ng JSON o CSV.

Spotify Play Count Scraper (magbubukas sa bagong tab)eduair94/spotify-play-count-scraper
Mag-paste ng mga link, URI, o id ng kanta, album, artist, o playlist; nagbabalik ito ng isang row kada kanta kasama ang play count nito — ang mga top na kanta o buong diskograpiya ng artist, bawat kanta sa album o playlist — at, kung hihilingin, isang row na may buwanang tagapakinig ng artist.
Spotify Scraper (magbubukas sa bagong tab)eduair94/spotify-scraper
Ang pangkalahatang actor: 61 category, 5 sa mga ito ay play count (track_play_count, album_play_counts, artist_play_counts, artist_discography_play_counts, playlist_play_counts), at isrc, na naghahanap ng kanta gamit ang ISRC nito kasama ang play count.

Parehong naniningil kada resulta, sa mga presyong nakalista noong Oktubre 22, 2026: $0.001 kada row sa libreng plan ng Apify, pababa sa $0.0006 mula Gold pataas. Nasa gabay sa scraper kung kailan mas mainam ang run kaysa sa key, at kung kailan hindi.

Kasaysayang naitatabi na: 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.

Gamitin ito mula sa AI assistant (MCP): hingin sa Claude, Cursor, o VS Code ang stream ng isang kanta, at ibinabalik ng get_track_play_count tool ng Spotify MCP server ang kabuuang play count mula sa API na ito. I-set up ang MCP server.

Mga tanong

Nagbabalik ba ng play count ang Spotify Web API?

Hindi. Walang play count field ang track object sa Web API reference. Ang pinakamalapit nitong field, ang popularity, ay isang 0–100 na score na kinakalkula ng Spotify higit sa lahat mula sa kabuuang play at kung gaano kabago ang mga ito; minamarkahan ito ng reference na deprecated, at inalis ito ng mga pagbabago ng Spotify noong Pebrero 2026 para sa mga app sa development mode na ginawa mula 11 Pebrero 2026.

Bakit 0 play ang ipinapakita ng isang kanta?

Dahil wala pa itong 1,000. Sinasabi ng spec na 0 ang iniuulat ng Spotify para sa mga kantang wala pang 1,000 play, kaya ang 0 ay nangangahulugang wala pang 1,000, hindi hindi pa napapakinggan.

Puwede bang kumuha ng play count ng maraming kanta nang sabay-sabay?

Oo. Tumatanggap ang GET /partner/tracks/count ng hanggang 50 track id na pinaghiwalay ng kuwit at sumasagot ayon sa pagkakasunod ng request, bawat entry na may status na ok, not_found, o error; inililista rin sa missing ang mga id na walang play count. Isang request lang ang gastos ng 50 kanta sa halip na 50.

Puwede bang hanapin ang kanta gamit ang ISRC?

Oo. Tumatanggap ang GET /partner/track/count ng isrc sa halip na Spotify id, kaya hindi na kailangan ng id lookup muna para sa catalog na naka-key sa ISRC.

Gaano kasariwa ang numero?

Naka-cache nang isang oras ang mga play count, kaya karaniwang hindi hihigit sa ganoon katanda ang bilang. Ang X-Cache value na nagsisimula sa STALE o FALLBACK ay nangangahulugang mas lumang kopya ang inihain dahil mabagal o nabigo ang live fetch; ibinibigay ng X-Cache-Stale-Age ang edad nito sa segundo. Idagdag ang cache=false para kumuha ng bago. Dumadaan din sa sariling cache ng demo ang mga Run button sa site na ito, kaya maaaring mas luma ang numero roon.

Makakakuha ba ng play count nang hindi nagsusulat ng code?

Oo, sa Apify: kailangan ng Apify account sa isang run at hindi API key. Tumatanggap ang Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) ng mga link ng kanta, album, artist, o playlist at nagbabalik ng isang row kada kanta kasama ang play count nito; may 5 play-count category ang Spotify Scraper (eduair94/spotify-scraper) sa 61 nito. Parehong naniningil kada resulta.

Anong plan ang kailangan?

Kahit alin. Nasa bawat plan ang dalawang play-count endpoint, RapidAPI man o direct portal, at buwanang volume ang pagkakaiba ng mga plan. Pinapayagan ng bawat RapidAPI plan ang 5 request kada segundo at kasama sa bawat direct key ang 10. Pinapayagan ng libreng plan ng RapidAPI ang 1,000 request kada buwan.

Mga pinagmulan

Get Track — Spotify Web API reference — ang opisyal na track object: walang play count, at minarkahang deprecated ang popularity.
Mga pagbabago noong Pebrero 2026 — Spotify for Developers reference — ang popularity ng kanta ay kabilang sa mga inalis na field.
Migration guide para sa Pebrero 2026 — Spotify for Developers — kung sino ang sakop ng mga pag-alis: mga app sa development mode, ang mga bago ay mula 11 Pebrero 2026; hindi apektado ang mga app na may extended quota.
GET /partner/track/count sa site na ito — ang mga parameter nito, ang mga error status nito, at isang Run button.
GET /partner/tracks/count sa site na ito — ang batch na tawag, na may parehong mga ito.
Spotify Play Count Scraper sa Apify — ang no-code na ruta: ang input nito at ang presyo kada row, ayon sa kasalukuyang nailathala.

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

Kumuha ng key at kunin ang unang play count

Nasa bawat plan ang dalawang play-count endpoint, RapidAPI man o direct portal; sa Apify, ibinabalik ng dalawang actor sa itaas ang parehong bilang bilang mga dataset row, na sinisingil kada resulta. 1,000 request kada buwan ang libreng tier ng RapidAPI: sa hanggang 50 kanta kada tawag, hanggang 50,000 play count.

RapidAPI Apify Direct Portal

Hindi pa handang bumili? Kumuha ng libreng trial key: 500 request sa loob ng 7 araw, walang card.