Leitfaden

Spotify-Wiedergaben-API: Gesamtstreams jedes Titels, per ID oder ISRC

Die Web API von Spotify verrät nie, wie oft ein Titel gespielt wurde. Am nächsten kommt ihr die Popularität, ein Wert von 0–100, den ihre eigene Referenz als überwiegend auf den Gesamtwiedergaben beruhend beschreibt und als veraltet markiert. Diese Endpunkte liefern die Zahl selbst: einen Titel per Spotify-ID oder ISRC oder bis zu 50 Titel in einem Aufruf.

Von Eduardo Airaudo, Maintainer der API · Aktualisiert am 22. Oktober 2026

Was das offizielle Track-Objekt auslässt

GET /v1/tracks/{id} in der Spotify Web API liefert das Album, die Künstler, duration_ms, explicit, external_ids, den Namen, popularity und einige weitere Felder. Keines davon zählt Wiedergaben. Am nächsten kommt die Popularität: Die Referenz von Spotify beschreibt sie als Wert von 0 bis 100, berechnet überwiegend daraus, wie oft ein Titel gespielt wurde und wie aktuell diese Wiedergaben sind, und markiert sie als veraltet. Mit den Änderungen vom Februar 2026 hat Spotify sie für Apps im Entwicklungsmodus entfernt, die ab dem 11. Februar 2026 erstellt wurden.

Ein Score kann nicht leisten, was eine Zahl leistet. Er ist relativ, summiert sich also nicht über ein Album oder einen Katalog, und er bevorzugt aktuelle Wiedergaben — dieselbe Referenz sagt, dass derzeit viel gespielte Songs höher punkten als früher viel gespielte —, sodass er nicht sagen kann, wie oft ein Titel insgesamt je gespielt wurde.

In den Worten der Spezifikation ist die Partner-Gruppe dieser API „Spotify's internal (pathfinder) data, including play counts“. /partner/track/count liefert die Gesamtzahl der Wiedergaben eines Titels, /partner/tracks/count die von bis zu 50 Titeln auf einmal, und /partner/track trägt sie im vollständigen Titeldatensatz.

Was zurückkommt

Feld für Feld, wie die Antwortschemas der Spezifikation sie definieren. Der Einzelaufruf nennt die Zahl streams; der Batch-Aufruf nennt sie playcount.

Ein Titel

GET /partner/track/count

streams
Die Gesamtzahl der Wiedergaben als Ganzzahl (int64). In der Spezifikation nullable, und 0 bei einem Titel mit unter 1.000 Wiedergaben.
spotify_track_id
Die Spotify-ID des Titels.
isrc
Der ISRC des Titels. In der Spezifikation nullable.
result
success oder error, mit einer kurzen message daneben.

Ein Batch

GET /partner/tracks/count

tracks[]
Ein Eintrag pro angeforderter ID, in der Reihenfolge der Anfrage.
tracks[].playcount
Gesamtwiedergaben (int64, nullable); 0 bei einem Titel unter 1.000.
tracks[].status
ok, not_found oder error, mit einem error-Text, wenn es error ist.
tracks[].name
Der Name des Titels; null, wenn er nicht gefunden wurde.
tracks[].artists[]
id und name jedes Künstlers.
tracks[].releaseDate
Das Veröffentlichungsdatum des Albums des Titels: YYYY-MM-DD oder eine gröbere Genauigkeit.
missing[]
Die angeforderten IDs, deren Status nicht ok ist.

Eine 0 bedeutet unter 1.000, nicht nie gespielt. Laut Spezifikation meldet Spotify 0 für Titel mit weniger als 1.000 Wiedergaben; speichern Sie eine 0 daher als „unter 1.000“ und nicht als Zahl.

Aufgezeichnetes Beispiel · erfasst am 2026-10-22

GET /partner/track/count

6 Zeilen — der gesamte aufgezeichnete Body.

Aufgezeichnetes Beispiel · erfasst am 2026-10-22

GET /partner/tracks/count

18 Zeilen — der gesamte aufgezeichnete Body.

Ein Titel oder 50 pro Aufruf

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

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

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

    Parameterid, slim, cache

/partner/tracks/count nimmt bis zu 50 durch Kommas getrennte IDs entgegen und antwortet in der Reihenfolge, in der Sie sie gesendet haben; 50 Titel kosten also eine Anfrage statt 50.

Wiedergaben abrufen

Ein Titel, per Spotify-ID

Die ID ist die 22 Zeichen lange Zeichenfolge nach /track/ in jeder Spotify-URL. Um einen Titel über seine ISRC nachzuschlagen, senden Sie isrc= anstelle von id=.

Bis zu 50 Titel in einem Aufruf

Lesen Sie das Feld status jedes Eintrags, bevor Sie seine Zahl verwenden. Die Einträge kommen in der Reihenfolge der IDs zurück; einer ohne Wiedergaben wird stattdessen als not_found oder error markiert und zusätzlich in missing aufgeführt.

Wiedergaben ohne Code

Wenn die Zahlen für eine Tabelle und nicht für Ihren eigenen Code gedacht sind, liefern zwei Apify-Actors desselben Maintainers sie als Dataset. Ein Lauf braucht ein Apify-Konto, aber keinen API-Schlüssel: Sie fügen Links ein und laden JSON oder CSV herunter.

Beide rechnen pro Ergebnis ab, zu den am aufgeführten Preisen: $0.001 pro Zeile im kostenlosen Apify-Tarif, bis hinunter zu $0.0006 ab Gold. Wann ein Lauf besser ist als ein Schlüssel und wann nicht, steht in dem Scraper-Leitfaden.

Ein bereits geführter Verlauf: 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.

Nutzung aus einem KI-Assistenten (MCP): Fragen Sie Claude, Cursor oder VS Code nach den Streams eines Titels, und das Tool get_track_play_count des Spotify-MCP-Servers liefert die Gesamtwiedergaben aus dieser API. MCP-Server einrichten.

Fragen

Liefert die Spotify Web API Wiedergaben?

Nein. Das Track-Objekt in der Referenz der Web API hat kein Feld für Wiedergaben. Das nächstliegende Feld, popularity, ist ein Wert von 0–100, den Spotify überwiegend aus den Gesamtwiedergaben und deren Aktualität berechnet; die Referenz markiert es als veraltet, und Spotify hat es mit den Änderungen vom Februar 2026 für Apps im Entwicklungsmodus entfernt, die ab dem 11. Februar 2026 erstellt wurden.

Warum zeigt ein Titel 0 Wiedergaben?

Weil er weniger als 1.000 hat. Laut Spezifikation meldet Spotify 0 für Titel mit weniger als 1.000 Wiedergaben; eine 0 bedeutet also unter 1.000, nicht nie gespielt.

Kann ich die Wiedergaben vieler Titel auf einmal abrufen?

Ja. GET /partner/tracks/count nimmt bis zu 50 durch Kommas getrennte Titel-IDs entgegen und antwortet in der Reihenfolge der Anfrage, jeder Eintrag mit dem Status ok, not_found oder error; IDs ohne Wiedergaben werden zusätzlich in missing aufgeführt. 50 Titel kosten eine Anfrage statt 50.

Kann ich einen Titel über die ISRC nachschlagen?

Ja. GET /partner/track/count nimmt isrc anstelle einer Spotify-ID entgegen, ein nach ISRC geordneter Katalog braucht also keine vorherige ID-Suche.

Wie aktuell ist die Zahl?

Wiedergaben werden eine Stunde lang zwischengespeichert, eine Zahl ist also typischerweise höchstens so alt. Ein Wert von X-Cache, der mit STALE oder FALLBACK beginnt, bedeutet, dass eine ältere Kopie geliefert wurde, weil der Live-Abruf langsam war oder fehlschlug; X-Cache-Stale-Age nennt ihr Alter in Sekunden. Mit cache=false erzwingen Sie einen frischen Abruf. Auch die Ausführen-Schaltflächen auf dieser Website laufen über den eigenen Cache der Demo, eine Zahl dort kann also älter sein.

Kann ich Wiedergaben ohne Code abrufen?

Ja, auf Apify: Ein Lauf braucht ein Apify-Konto, aber keinen API-Schlüssel. Der Actor Spotify Play Count Scraper (eduair94/spotify-play-count-scraper) nimmt Links zu Titeln, Alben, Künstlern oder Playlists entgegen und liefert eine Zeile pro Titel mit seinen Wiedergaben; der Actor Spotify Scraper (eduair94/spotify-scraper) hat 5 Kategorien zu Wiedergaben unter seinen 61. Beide rechnen pro Ergebnis ab.

Welchen Tarif brauche ich?

Jeden. Beide Endpunkte für Wiedergaben sind in jedem Tarif enthalten, bei RapidAPI wie im Direktportal, und die Tarife unterscheiden sich im monatlichen Volumen. Jeder RapidAPI-Tarif erlaubt 5 Anfragen pro Sekunde, und jeder Direktschlüssel enthält 10. Der kostenlose Tarif von RapidAPI erlaubt 1.000 Anfragen im Monat.

Quellen

More guides

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

Schlüssel holen und die erste Wiedergabenzahl abrufen

Beide Endpunkte für Wiedergaben sind in jedem Tarif enthalten, bei RapidAPI wie im Direktportal; auf Apify liefern die beiden oben genannten Actors dieselben Zahlen als Dataset-Zeilen, abgerechnet pro Ergebnis. Der kostenlose Tarif von RapidAPI umfasst 1.000 Anfragen im Monat: bei bis zu 50 Titeln pro Aufruf bis zu 50.000 Wiedergabenzahlen.

RapidAPI Apify Direktportal

Noch nicht kaufbereit? Kostenlosen Testschlüssel holen: 500 Anfragen in 7 Tagen, keine Karte.