Mwongozo

API ya mara zilizochezwa kwenye Spotify: mara zilizochezwa kwa jumla za wimbo wowote, kwa ID au ISRC

Web API ya Spotify haisemi kamwe wimbo umechezwa mara ngapi. Kilicho karibu zaidi ni popularity, alama ya 0–100 ambayo marejeo yake yenyewe yanaeleza kuwa inatokana zaidi na jumla ya mara zilizochezwa, na imeiweka alama ya iliyositishwa. Endpoint hizi hurudisha idadi yenyewe: wimbo mmoja kwa ID ya Spotify au ISRC, au hadi nyimbo 50 kwa ombi moja.

Na Eduardo Airaudo, mtunzaji wa API · Imesasishwa 22 Oktoba 2026

Kile ambacho kitu rasmi cha wimbo kinaacha

GET /v1/tracks/{id} kwenye Spotify Web API hurudisha albamu, wasanii, duration_ms, explicit, external_ids, jina, popularity na vichache zaidi. Hakuna hata kimoja kinachohesabu mara zilizochezwa. Popularity ndiyo iliyo karibu zaidi: marejeo ya Spotify yanaitaja kuwa thamani kutoka 0 hadi 100, inayokokotolewa zaidi kutokana na mara ambazo wimbo umechezwa na jinsi zilivyo za hivi karibuni, na kuiweka alama ya iliyositishwa. Mabadiliko ya Spotify ya Februari 2026 yaliiondoa kwa programu za development mode zilizoundwa kuanzia tarehe 11 Februari 2026.

Alama haiwezi kufanya kazi ya idadi. Ni ya kulinganisha, kwa hiyo haijumlishwi kwenye albamu au katalogi; na inapendelea mara za hivi karibuni — marejeo yaleyale yanasema nyimbo zinazochezwa sana sasa hupata alama ya juu kuliko nyimbo zilizochezwa sana zamani — kwa hiyo haiwezi kusema wimbo umechezwa mara ngapi tangu mwanzo.

Kwa maneno ya spec, kikundi cha Partner cha API hii ni “Spotify's internal (pathfinder) data, including play counts”. /partner/track/count hurudisha idadi ya jumla ya wimbo mmoja, /partner/tracks/count ya hadi nyimbo 50 kwa wakati mmoja, na /partner/track huibeba ndani ya rekodi kamili ya wimbo.

Kinachorudi

Sehemu kwa sehemu, kama schema za majibu za spec zinavyoeleza. Ombi la wimbo mmoja huita idadi hiyo streams; la kundi huiita playcount.

Wimbo mmoja

GET /partner/track/count

streams
Idadi ya mara zilizochezwa kwa jumla, kama namba nzima (int64). Inaweza kuwa null kwenye spec, na ni 0 kwa wimbo wenye chini ya mara 1,000.
spotify_track_id
ID ya Spotify ya wimbo.
isrc
ISRC ya wimbo. Inaweza kuwa null kwenye spec.
result
success au error, pamoja na message fupi kando yake.

Kundi

GET /partner/tracks/count

tracks[]
Ingizo moja kwa kila ID iliyoombwa, kwa mpangilio wa ombi.
tracks[].playcount
Mara zilizochezwa kwa jumla (int64, inaweza kuwa null); 0 kwa wimbo wenye chini ya 1,000.
tracks[].status
ok, not_found au error, pamoja na maandishi ya error inapokuwa error.
tracks[].name
Jina la wimbo; null usipopatikana.
tracks[].artists[]
id na name ya kila msanii.
tracks[].releaseDate
Tarehe ya kutolewa ya albamu ya wimbo: YYYY-MM-DD, au usahihi wa chini zaidi.
missing[]
ID zilizoombwa ambazo hali yake si ok.

0 humaanisha chini ya 1,000, si kwamba haijawahi kuchezwa. Spec inasema Spotify huripoti 0 kwa nyimbo zenye chini ya mara 1,000, kwa hiyo hifadhi 0 kama “chini ya 1,000” badala ya idadi.

Sampuli iliyorekodiwa · ilinaswa 2026-10-22

GET /partner/track/count

Mistari 6 — body yote iliyorekodiwa.

Sampuli iliyorekodiwa · ilinaswa 2026-10-22

GET /partner/tracks/count

Mistari 18 — body yote iliyorekodiwa.

Wimbo mmoja, au nyimbo 50 kwa kila ombi

  • 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.

    Vigezospotify_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.

    Vigezoids, 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).

    Vigezoid, slim, cache

/partner/tracks/count hupokea hadi ID 50 zilizotenganishwa kwa koma na hujibu kwa mpangilio uliotuma, kwa hiyo nyimbo 50 zinagharimu ombi moja badala ya maombi 50.

Pata mara zilizochezwa

Wimbo mmoja, kwa ID ya Spotify

ID ni mfuatano wa herufi 22 baada ya /track/ kwenye URL yoyote ya Spotify. Kutafuta wimbo kwa ISRC yake, tuma isrc= badala ya id=.

Hadi nyimbo 50 kwa ombi moja

Soma status ya kila ingizo kabla ya idadi yake. Maingizo hurudi kwa mpangilio wa ID; lile lisilo na idadi ya mara zilizochezwa huwekwa alama ya not_found au error mahali pake, na huorodheshwa tena kwenye missing.

Mara zilizochezwa bila msimbo

Ikiwa idadi ni za lahajedwali badala ya msimbo wako mwenyewe, Apify actors mbili kutoka kwa mtunzaji yuleyule huzirudisha kama dataset. Uendeshaji unahitaji akaunti ya Apify na hauhitaji ufunguo wa API: unabandika viungo na kupakua JSON au CSV.

Zote hutoza kwa kila matokeo, kwa bei zilizoorodheshwa tarehe : $0.001 kwa mstari kwenye mpango wa bure wa Apify, hadi $0.0006 kuanzia Gold. Wakati uendeshaji unapomshinda ufunguo, na wakati haumshindi, upo kwenye mwongozo wa scraper.

Historia ambayo tayari inatunzwa: 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.

Itumie kutoka kwa msaidizi wa AI (MCP): mwombe Claude, Cursor au VS Code mara zilizochezwa za wimbo, na zana ya get_track_play_count ya seva ya Spotify MCP hurudisha mara zilizochezwa kwa jumla kutoka API hii. Sanidi seva ya MCP.

Maswali

Je, Spotify Web API hurudisha mara zilizochezwa?

Hapana. Kitu cha wimbo kwenye marejeo ya Web API hakina sehemu ya mara zilizochezwa. Sehemu iliyo karibu zaidi, popularity, ni alama ya 0–100 ambayo Spotify huikokotoa zaidi kutokana na jumla ya mara zilizochezwa na jinsi zilivyo za hivi karibuni; marejeo yanaiweka alama ya iliyositishwa, na mabadiliko ya Spotify ya Februari 2026 yaliiondoa kwa programu za development mode zilizoundwa kuanzia tarehe 11 Februari 2026.

Kwa nini wimbo unaonyesha mara 0 zilizochezwa?

Kwa sababu una chini ya 1,000. Spec inasema Spotify huripoti 0 kwa nyimbo zenye chini ya mara 1,000, kwa hiyo 0 humaanisha chini ya 1,000, si kwamba haijawahi kuchezwa.

Je, naweza kupata mara zilizochezwa za nyimbo nyingi kwa wakati mmoja?

Ndiyo. GET /partner/tracks/count hupokea hadi ID 50 za nyimbo zilizotenganishwa kwa koma na hujibu kwa mpangilio wa ombi, kila ingizo likiwa na hali ya ok, not_found au error; ID zisizo na idadi ya mara zilizochezwa pia huorodheshwa kwenye missing. Nyimbo 50 zinagharimu ombi moja badala ya maombi 50.

Je, naweza kutafuta wimbo kwa ISRC?

Ndiyo. GET /partner/track/count hupokea isrc badala ya ID ya Spotify, kwa hiyo katalogi iliyopangwa kwa ISRC haihitaji kutafuta ID kwanza.

Namba hii ni ya sasa kiasi gani?

Mara zilizochezwa huhifadhiwa kwenye akiba kwa saa moja, kwa hiyo idadi kwa kawaida ina umri wa juu zaidi wa muda huo. Thamani ya X-Cache inayoanza na STALE au FALLBACK inamaanisha nakala ya zamani ilitolewa kwa sababu upatikanaji wa moja kwa moja ulikuwa polepole au ulishindwa; X-Cache-Stale-Age hutoa umri wake kwa sekunde. Ongeza cache=false kupata mpya. Vitufe vya Endesha kwenye tovuti hii pia hupitia akiba ya onyesho yenyewe, kwa hiyo namba huko inaweza kuwa ya zamani zaidi.

Je, naweza kupata mara zilizochezwa bila kuandika msimbo?

Ndiyo, kwenye Apify: uendeshaji unahitaji akaunti ya Apify na hauhitaji ufunguo wa API. Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) hupokea viungo vya wimbo, albamu, msanii au orodha ya kucheza na hurudisha mstari mmoja kwa kila wimbo pamoja na idadi yake ya mara zilizochezwa; Spotify Scraper (eduair94/spotify-scraper) ina kategoria 5 za mara zilizochezwa kati ya 61. Zote hutoza kwa kila matokeo.

Ninahitaji mpango upi?

Yoyote. Endpoint zote mbili za mara zilizochezwa ziko kwenye kila mpango, RapidAPI na lango la moja kwa moja pia, na mipango hutofautiana kwa wingi wa kila mwezi. Kila mpango wa RapidAPI unaruhusu maombi 5 kwa sekunde na kila ufunguo wa moja kwa moja unajumuisha 10. Mpango wa bure wa RapidAPI unaruhusu maombi 1,000 kwa mwezi.

Vyanzo

More guides

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

Pata ufunguo na uvute mara zako za kwanza zilizochezwa

Endpoint zote mbili za mara zilizochezwa ziko kwenye kila mpango, RapidAPI na lango la moja kwa moja pia; kwenye Apify, actors mbili zilizo juu hurudisha idadi zilezile kama mistari ya dataset, kwa malipo ya kila matokeo. Kiwango cha bure cha RapidAPI ni maombi 1,000 kwa mwezi: kwa hadi nyimbo 50 kwa ombi, hadi idadi 50,000 za mara zilizochezwa.

RapidAPI Apify Lango la Moja kwa Moja

Bado hujawa tayari kununua? Pata ufunguo wa majaribio bure: maombi 500 kwa siku 7, bila kadi.