Spotify
Musik suchen, Playlists verwalten, Wiedergabe steuern und auf deine Bibliothek zugreifen
sp
Nutzungsanleitung
Integriere Spotify in deinen Workflow. Suche nach Titeln, Alben, Künstlern und Playlists. Verwalte Playlists, greife auf deine Bibliothek zu, steuere die Wiedergabe, durchsuche Podcasts und Hörbücher.
Tools
spotify_search
Suche nach Titeln, Alben, Künstlern oder Playlists auf Spotify. Liefert passende Ergebnisse basierend auf der Anfrage.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
query | string | Ja | Suchanfrage (z.B. "Bohemian Rhapsody", "artist:Queen", "genre:rock") |
type | string | Nein | Art der Ergebnisse: track, album, artist, playlist oder durch Komma getrennt (z.B. "track,artist") |
limit | number | Nein | Maximale Anzahl der zurückzugebenden Ergebnisse (1-50) |
offset | number | Nein | Index des ersten Ergebnisses für die Paginierung |
market | string | Nein | ISO 3166-1 alpha-2 Ländercode zur Filterung der Ergebnisse (z.B. "US", "GB") |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
tracks | array | Liste der passenden Titel |
spotify_get_track
Erhalte detaillierte Informationen über einen bestimmten Titel auf Spotify anhand seiner ID.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
trackId | string | Ja | Die Spotify-ID des Titels |
market | string | Nein | ISO 3166-1 alpha-2 Ländercode für die Verfügbarkeit des Titels |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
id | string | Spotify-Track-ID |
name | string | Trackname |
artists | array | Liste der Künstler |
album | object | Album-Informationen |
duration_ms | number | Trackdauer in Millisekunden |
explicit | boolean | Ob der Track explizite Inhalte enthält |
popularity | number | Popularitätswert (0-100) |
preview_url | string | URL zur 30-Sekunden-Vorschau |
external_url | string | Spotify-URL |
uri | string | Spotify-URI für den Track |
spotify_get_tracks
Erhalte detaillierte Informationen über mehrere Tracks auf Spotify anhand ihrer IDs (bis zu 50).
Input
| Parameter | Type | Erforderlich | Beschreibung |
|---|---|---|---|
trackIds | string | Ja | Kommagetrennte Liste von Spotify-Track-IDs (max. 50) |
market | string | Nein | ISO 3166-1 Alpha-2-Ländercode für Track-Verfügbarkeit |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
tracks | array | Liste der Tracks |
spotify_get_album
Erhalte detaillierte Informationen über ein Album auf Spotify anhand seiner ID, einschließlich der Trackliste.
Input
| Parameter | Type | Erforderlich | Beschreibung |
|---|---|---|---|
albumId | string | Ja | Die Spotify-ID des Albums |
market | string | Nein | ISO 3166-1 Alpha-2-Ländercode für Track-Verfügbarkeit |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
id | string | Spotify-Album-ID |
name | string | Albumname |
artists | array | Liste der Künstler |
album_type | string | Art des Albums (album, single, compilation) |
total_tracks | number | Gesamtanzahl der Tracks |
release_date | string | Veröffentlichungsdatum |
label | string | Plattenlabel |
popularity | number | Popularitätswert (0-100) |
genres | array | Liste der Genres |
image_url | string | URL des Albumcovers |
tracks | array | Liste der Tracks auf dem Album |
external_url | string | Spotify-URL |
spotify_get_albums
Ruft Details für mehrere Alben anhand ihrer IDs ab.
Input
| Parameter | Type | Required | Beschreibung |
|---|---|---|---|
albumIds | string | Yes | Durch Kommas getrennte Album-IDs (max. 20) |
market | string | No | ISO-Ländercode für den Markt |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
albums | json | Liste der Alben |
spotify_get_album_tracks
Ruft die Tracks eines Albums ab.
Input
| Parameter | Type | Required | Beschreibung |
|---|---|---|---|
albumId | string | Yes | Die Spotify-Album-ID |
limit | number | No | Anzahl der zurückzugebenden Tracks (1-50) |
offset | number | No | Index des ersten zurückzugebenden Tracks |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
tracks | json | Liste der Tracks |
total | number | Gesamtanzahl der Tracks |
next | string | URL für die nächste Seite |
spotify_get_saved_albums
Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Anzahl der zurückzugebenden Alben (1-50) |
offset | number | Nein | Index des ersten zurückzugebenden Albums |
market | string | Nein | ISO-Ländercode für den Markt |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
albums | json | Liste der gespeicherten Alben |
total | number | Gesamtzahl der gespeicherten Alben |
next | string | URL für die nächste Seite |
spotify_save_albums
Alben für den Benutzer speichern
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
albumIds | string | Ja | Durch Kommas getrennte Album-IDs (max. 20) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Alben gespeichert wurden |
spotify_remove_saved_albums
Alben vom Benutzer entfernen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
albumIds | string | Ja | Durch Kommas getrennte Album-IDs (max. 20) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Alben entfernt wurden |
spotify_check_saved_albums
Prüfen, ob Alben in der Bibliothek gespeichert sind.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
albumIds | string | Ja | Durch Kommas getrennte Album-IDs (max. 20) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
results | json | Array von Booleschen Werten für jedes Album |
spotify_get_artist
Detaillierte Informationen über einen Künstler auf Spotify anhand seiner ID abrufen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
artistId | string | Ja | Die Spotify-ID des Künstlers |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Spotify-Künstler-ID |
name | string | Künstlername |
genres | array | Liste der mit dem Künstler verbundenen Genres |
popularity | number | Popularitätswert (0-100) |
followers | number | Anzahl der Follower |
image_url | string | Künstler-Bild-URL |
external_url | string | Spotify-URL |
spotify_get_artists
Details für mehrere Künstler anhand ihrer IDs abrufen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
artistIds | string | Ja | Durch Kommas getrennte Künstler-IDs (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
artists | json | Liste der Künstler |
spotify_get_artist_albums
Alben eines Künstlers auf Spotify abrufen. Kann nach Albumtyp gefiltert werden.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
artistId | string | Ja | Die Spotify-ID des Künstlers |
include_groups | string | Nein | Nach Albumtyp filtern: album, single, appears_on, compilation (durch Komma getrennt) |
limit | number | Nein | Maximale Anzahl der zurückzugebenden Alben (1-50) |
offset | number | Nein | Index des ersten zurückzugebenden Albums |
market | string | Nein | ISO 3166-1 alpha-2 Ländercode |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
albums | array | Künstler |
spotify_get_artist_top_tracks
Die 10 beliebtesten Tracks eines Künstlers auf Spotify abrufen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
artistId | string | Ja | Die Spotify-ID des Künstlers |
market | string | Nein | ISO 3166-1 alpha-2 Ländercode (für diesen Endpunkt erforderlich) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
tracks | array | Künstler |
spotify_follow_artists
Einem oder mehreren Künstlern folgen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
artistIds | string | Ja | Durch Komma getrennte Künstler-IDs zum Folgen (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Künstlern erfolgreich gefolgt wurde |
spotify_unfollow_artists
Einem oder mehreren Künstlern entfolgen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
artistIds | string | Ja | Durch Komma getrennte Künstler-IDs zum Entfolgen (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Künstlern erfolgreich entfolgt wurde |
spotify_get_followed_artists
Den Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Anzahl der zurückzugebenden Künstler (1-50) |
after | string | Nein | Cursor für Paginierung (letzte Künstler-ID aus vorheriger Anfrage) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
artists | json | Liste der gefolgten Künstler |
total | number | Gesamtanzahl der gefolgten Künstler |
next | string | Cursor für die nächste Seite |
spotify_check_following
Prüfen, ob der Benutzer Künstlern oder anderen Benutzern folgt.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
type | string | Ja | Zu prüfender Typ: "artist" oder "user" |
ids | string | Ja | Durch Komma getrennte Künstler- oder Benutzer-IDs (max. 50) |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
results | json | Array von Booleschen Werten für jede ID |
spotify_get_show
Details zu einer Podcast-Show abrufen.
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
showId | string | Ja | Die Spotify-Show-ID |
market | string | Nein | ISO-Ländercode für den Markt |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Show-ID |
name | string | Show-Name |
description | string | Show-Beschreibung |
publisher | string | Publisher-Name |
total_episodes | number | Gesamtzahl der Episoden |
explicit | boolean | Enthält explizite Inhalte |
languages | json | Sprachen |
image_url | string | Cover-Bild-URL |
external_url | string | Spotify-URL |
spotify_get_shows
Details für mehrere Podcast-Shows abrufen.
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
showIds | string | Ja | Kommagetrennte Show-IDs (max. 50) |
market | string | Nein | ISO-Ländercode für den Markt |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
shows | json | Liste der Shows |
spotify_get_show_episodes
Episoden einer Podcast-Show abrufen.
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
showId | string | Ja | Die Spotify-Show-ID |
limit | number | Nein | Anzahl der zurückzugebenden Episoden (1-50) |
offset | number | Nein | Index der ersten zurückzugebenden Episode |
market | string | Nein | ISO-Ländercode für den Markt |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
episodes | json | Liste der Episoden |
total | number | Gesamtzahl der Episoden |
next | string | URL für die nächste Seite |
spotify_get_saved_shows
Benutzer abrufen
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Anzahl der zurückzugebenden Shows (1-50) |
offset | number | Nein | Index der ersten zurückzugebenden Show |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
shows | json | Liste der gespeicherten Shows |
total | number | Gesamtzahl der gespeicherten Shows |
next | string | URL für die nächste Seite |
spotify_save_shows
Podcast-Shows für den Benutzer speichern
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
showIds | string | Ja | Durch Kommas getrennte Show-IDs (max. 50) |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
success | boolean | Ob Shows gespeichert wurden |
spotify_remove_saved_shows
Podcast-Shows vom Benutzer entfernen
Input
| Parameter | Type | Required | Beschreibung |
|---|---|---|---|
showIds | string | Yes | Durch Komma getrennte Show-IDs (max. 50) |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
success | boolean | Ob Shows entfernt wurden |
spotify_check_saved_shows
Prüfen, ob Shows in der Bibliothek gespeichert sind.
Input
| Parameter | Type | Required | Beschreibung |
|---|---|---|---|
showIds | string | Yes | Durch Komma getrennte Show-IDs (max. 50) |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
results | json | Array von Booleschen Werten für jede Show |
spotify_get_episode
Details für eine Podcast-Episode abrufen.
Input
| Parameter | Type | Required | Beschreibung |
|---|---|---|---|
episodeId | string | Yes | Die Spotify-Episode-ID |
market | string | No | ISO-Ländercode für den Markt |
Output
| Parameter | Type | Beschreibung |
|---|---|---|
id | string | Episode-ID |
name | string | Name der Episode |
description | string | Beschreibung der Episode |
duration_ms | number | Dauer in ms |
release_date | string | Veröffentlichungsdatum |
explicit | boolean | Enthält explizite Inhalte |
show | json | Informationen zur übergeordneten Show |
image_url | string | URL des Coverbildes |
external_url | string | Spotify-URL |
spotify_get_episodes
Details für mehrere Podcast-Episoden abrufen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
episodeIds | string | Ja | Durch Komma getrennte Episoden-IDs (max. 50) |
market | string | Nein | ISO-Ländercode für den Markt |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
episodes | json | Liste der Episoden |
spotify_get_saved_episodes
Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Anzahl der zurückzugebenden Episoden (1-50) |
offset | number | Nein | Index der ersten zurückzugebenden Episode |
market | string | Nein | ISO-Ländercode für den Markt |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
episodes | json | Liste der gespeicherten Episoden |
total | number | Gesamtzahl der gespeicherten Episoden |
next | string | URL für die nächste Seite |
spotify_save_episodes
Podcast-Episoden für den Benutzer speichern
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
episodeIds | string | Ja | Durch Komma getrennte Episoden-IDs (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Episoden gespeichert wurden |
spotify_remove_saved_episodes
Podcast-Episoden vom Benutzer entfernen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
episodeIds | string | Ja | Kommagetrennte Episoden-IDs (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Episoden entfernt wurden |
spotify_check_saved_episodes
Prüfen, ob Episoden in der Bibliothek gespeichert sind.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
episodeIds | string | Ja | Kommagetrennte Episoden-IDs (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
results | json | Array von Booleschen Werten für jede Episode |
spotify_get_audiobook
Details für ein Hörbuch abrufen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
audiobookId | string | Ja | Die Spotify-Hörbuch-ID |
market | string | Nein | ISO-Ländercode für den Markt |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Hörbuch-ID |
name | string | Hörbuchname |
authors | json | Autoren |
narrators | json | Sprecher |
publisher | string | Verlag |
description | string | Beschreibung |
total_chapters | number | Gesamtzahl der Kapitel |
languages | json | Sprachen |
image_url | string | Cover-Bild-URL |
external_url | string | Spotify-URL |
spotify_get_audiobooks
Erhalte details für mehrere hörbücher.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
audiobookIds | string | Ja | Kommagetrennte hörbuch-IDs (max. 50) |
market | string | Nein | ISO-Ländercode für den Markt |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
audiobooks | json | Liste der hörbücher |
spotify_get_audiobook_chapters
Erhalte kapitel eines hörbuchs.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
audiobookId | string | Ja | Die Spotify hörbuch-ID |
limit | number | Nein | Anzahl der zurückzugebenden kapitel (1-50) |
offset | number | Nein | Index des ersten zurückzugebenden kapitels |
market | string | Nein | ISO-Ländercode für den Markt |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
chapters | json | Liste der kapitel |
total | number | Gesamtzahl der kapitel |
next | string | URL für die nächste seite |
spotify_get_saved_audiobooks
Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Anzahl der zurückzugebenden hörbücher (1-50) |
offset | number | Nein | Index des ersten zurückzugebenden hörbuchs |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
audiobooks | json | Liste der gespeicherten Hörbücher |
total | number | Gesamtzahl der gespeicherten Hörbücher |
next | string | URL für die nächste Seite |
spotify_save_audiobooks
Hörbücher für den Benutzer speichern
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
audiobookIds | string | Ja | Durch Kommas getrennte Hörbuch-IDs (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Hörbücher gespeichert wurden |
spotify_remove_saved_audiobooks
Hörbücher vom Benutzer entfernen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
audiobookIds | string | Ja | Durch Kommas getrennte Hörbuch-IDs (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Hörbücher entfernt wurden |
spotify_check_saved_audiobooks
Prüfen, ob Hörbücher in der Bibliothek gespeichert sind.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
audiobookIds | string | Ja | Durch Kommas getrennte Hörbuch-IDs (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
results | json | Array von Booleschen Werten für jedes Hörbuch |
spotify_get_playlist
Detaillierte Informationen über eine Playlist auf Spotify anhand ihrer ID abrufen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-ID der Playlist |
market | string | Nein | ISO 3166-1 alpha-2 Ländercode für die Verfügbarkeit des Tracks |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Spotify-Playlist-ID |
name | string | Playlist-Name |
description | string | Playlist-Beschreibung |
public | boolean | Ob die Playlist öffentlich ist |
collaborative | boolean | Ob die Playlist kollaborativ ist |
owner | object | Informationen zum Playlist-Besitzer |
image_url | string | URL des Playlist-Coverbildes |
total_tracks | number | Gesamtanzahl der Tracks |
snapshot_id | string | Playlist-Snapshot-ID für Versionierung |
external_url | string | Spotify-URL |
spotify_get_playlist_tracks
Ruft die Tracks in einer Spotify-Playlist ab.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-ID der Playlist |
limit | number | Nein | Maximale Anzahl der zurückzugebenden Tracks (1-100) |
offset | number | Nein | Index des ersten zurückzugebenden Tracks |
market | string | Nein | ISO 3166-1 alpha-2 Ländercode für die Verfügbarkeit des Tracks |
Ausgabe
| Parameter | Type | Beschreibung |
|---|---|---|
tracks | array | Liste der Titel in der Playlist |
spotify_get_playlist_cover
Eine Playlist abrufen
Eingabe
| Parameter | Type | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
Ausgabe
| Parameter | Type | Beschreibung |
|---|---|---|
images | json | Liste der Coverbilder |
spotify_get_user_playlists
Den aktuellen Benutzer abrufen
Eingabe
| Parameter | Type | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Maximale Anzahl der zurückzugebenden Playlists (1-50) |
offset | number | Nein | Index der ersten zurückzugebenden Playlist |
Ausgabe
| Parameter | Type | Beschreibung |
|---|---|---|
playlists | array | Benutzer |
spotify_create_playlist
Eine neue Playlist für den aktuellen Benutzer auf Spotify erstellen.
Eingabe
| Parameter | Type | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | Ja | Name für die neue Playlist |
description | string | Nein | Beschreibung für die Playlist |
public | boolean | Nein | Ob die Playlist öffentlich sein soll |
collaborative | boolean | Nein | Ob die Playlist kollaborativ sein soll (erfordert, dass öffentlich auf falsch gesetzt ist) |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Spotify-Playlist-ID |
name | string | Playlist-Name |
description | string | Playlist-Beschreibung |
public | boolean | Ob die Playlist öffentlich ist |
collaborative | boolean | Ob kollaborativ |
snapshot_id | string | Playlist-Snapshot-ID |
external_url | string | Spotify-URL |
spotify_update_playlist
Eine Playlist aktualisieren
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
name | string | Nein | Neuer Name für die Playlist |
description | string | Nein | Neue Beschreibung für die Playlist |
public | boolean | Nein | Ob die Playlist öffentlich sein soll |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob die Aktualisierung erfolgreich war |
spotify_add_playlist_cover
Ein benutzerdefiniertes Coverbild für eine Playlist hochladen. Das Bild muss im JPEG-Format und unter 256 KB sein.
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
imageBase64 | string | Ja | Base64-codiertes JPEG-Bild (max. 256 KB) |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob der Upload erfolgreich war |
spotify_add_tracks_to_playlist
Füge einen oder mehrere Tracks zu einer Spotify-Playlist hinzu.
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-ID der Playlist |
uris | string | Ja | Kommagetrennte Spotify-URIs (z.B. "spotify:track:xxx,spotify:track:yyy") |
position | number | Nein | Position zum Einfügen der Tracks (0-basiert). Wenn nicht angegeben, werden Tracks angehängt. |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
snapshot_id | string | Neue Playlist-Snapshot-ID nach der Änderung |
spotify_remove_tracks_from_playlist
Entferne einen oder mehrere Tracks aus einer Spotify-Playlist.
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-ID der Playlist |
uris | string | Ja | Kommagetrennte Spotify-URIs zum Entfernen (z.B. "spotify:track:xxx,spotify:track:yyy") |
Output
| Parameter | Typ | Beschreibung |
|---|---|---|
snapshot_id | string | Neue Playlist-Snapshot-ID nach der Änderung |
spotify_reorder_playlist_items
Verschiebe Tracks an eine andere Position in einer Playlist.
Input
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
range_start | number | Ja | Startindex der umzusortierenden Elemente |
insert_before | number | Ja | Index, vor dem die Elemente eingefügt werden sollen |
range_length | number | Nein | Anzahl der umzusortierenden Elemente |
snapshot_id | string | Nein | Playlist-Snapshot-ID für Nebenläufigkeitskontrolle |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
snapshot_id | string | Neue Playlist-Snapshot-ID |
spotify_replace_playlist_items
Ersetzt alle Elemente in einer Playlist durch neue Tracks.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
uris | string | Ja | Durch Kommas getrennte Spotify-URIs (max. 100) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
snapshot_id | string | Neue Playlist-Snapshot-ID |
spotify_follow_playlist
Einer Playlist folgen (speichern).
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
public | boolean | Nein | Ob die Playlist in öffentlichen Playlists erscheinen soll |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob das Folgen erfolgreich war |
spotify_unfollow_playlist
Einer Playlist entfolgen (nicht mehr speichern).
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob das Entfolgen erfolgreich war |
spotify_check_playlist_followers
Prüfen, ob Benutzer einer Playlist folgen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
playlistId | string | Ja | Die Spotify-Playlist-ID |
userIds | string | Ja | Durch Kommas getrennte Benutzer-IDs zur Überprüfung (max. 5) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
results | json | Array von Booleschen Werten für jeden Benutzer |
spotify_get_current_user
Aktuellen Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Spotify-Benutzer-ID |
display_name | string | Anzeigename |
email | string | E-Mail-Adresse |
country | string | Ländercode |
product | string | Abonnement-Stufe (free, premium) |
followers | number | Anzahl der Follower |
image_url | string | Profilbild-URL |
external_url | string | Spotify-Profil-URL |
spotify_get_user_profile
Einen Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
userId | string | Ja | Die Spotify-Benutzer-ID |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
id | string | Benutzer-ID |
display_name | string | Anzeigename |
followers | number | Anzahl der Follower |
image_url | string | Profilbild-URL |
external_url | string | Spotify-URL |
spotify_get_top_tracks
Aktuellen Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
time_range | string | Nein | Zeitraum: short_term (~4 Wochen), medium_term (~6 Monate), long_term (Jahre) |
limit | number | Nein | Anzahl der zurückzugebenden Tracks (1-50) |
offset | number | Nein | Index des ersten zurückzugebenden Tracks |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
tracks | array | Benutzer |
spotify_get_top_artists
Aktuellen Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
time_range | string | Nein | Zeitraum: short_term (~4 Wochen), medium_term (~6 Monate), long_term (Jahre) |
limit | number | Nein | Anzahl der zurückzugebenden Künstler (1-50) |
offset | number | Nein | Index des ersten zurückzugebenden Künstlers |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
artists | array | Benutzer |
spotify_get_saved_tracks
Aktuellen Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Anzahl der zurückzugebenden Tracks (1-50) |
offset | number | Nein | Index des ersten zurückzugebenden Tracks |
market | string | Nein | ISO 3166-1 alpha-2 Ländercode |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
tracks | array | Benutzer |
spotify_save_tracks
Tracks für den aktuellen Benutzer speichern
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
trackIds | string | Ja | Durch Kommas getrennte Spotify-Track-IDs zum Speichern (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob die Tracks erfolgreich gespeichert wurden |
spotify_remove_saved_tracks
Tracks vom Benutzer entfernen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
trackIds | string | Ja | Durch Kommas getrennte Track-IDs zum Entfernen (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob Tracks erfolgreich entfernt wurden |
spotify_check_saved_tracks
Prüfen, ob ein oder mehrere Tracks beim Benutzer gespeichert sind
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
trackIds | string | Ja | Durch Kommas getrennte Track-IDs zur Überprüfung (max. 50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
results | json | Array von Track-IDs mit Speicherstatus |
all_saved | boolean | Ob alle Tracks gespeichert sind |
none_saved | boolean | Ob keine Tracks gespeichert sind |
spotify_get_recently_played
Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
limit | number | Nein | Anzahl der zurückzugebenden Tracks (1-50) |
after | number | Nein | Unix-Zeitstempel in Millisekunden. Gibt Elemente nach diesem Cursor zurück. |
before | number | Nein | Unix-Zeitstempel in Millisekunden. Gibt Elemente vor diesem Cursor zurück. |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
items | array | Kürzlich gespielte Tracks |
spotify_get_new_releases
Eine Liste neuer Album-Veröffentlichungen abrufen, die bei Spotify vorgestellt werden.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
country | string | Nein | ISO 3166-1 Alpha-2-Ländercode (z.B. "US", "GB") |
limit | number | Nein | Anzahl der zurückzugebenden Veröffentlichungen (1-50) |
offset | number | Nein | Index der ersten zurückzugebenden Veröffentlichung |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
albums | json | Liste neuer Veröffentlichungen |
total | number | Gesamtzahl neuer Veröffentlichungen |
next | string | URL für die nächste Seite |
spotify_get_categories
Eine Liste von Browse-Kategorien abrufen, die zur Kennzeichnung von Elementen in Spotify verwendet werden.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
country | string | Nein | ISO 3166-1 Alpha-2-Ländercode (z.B. "US", "GB") |
locale | string | Nein | Locale-Code (z.B. "en_US", "es_MX") |
limit | number | Nein | Anzahl der zurückzugebenden Kategorien (1-50) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
categories | json | Liste der Durchsuchkategorien |
total | number | Gesamtanzahl der Kategorien |
spotify_get_markets
Ruft die Liste der Märkte ab, in denen Spotify verfügbar ist.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
markets | json | Liste der ISO-Ländercodes |
spotify_get_playback_state
Ruft den aktuellen Wiedergabestatus einschließlich Gerät, Titel und Fortschritt ab.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
market | string | Nein | ISO 3166-1 alpha-2 Ländercode |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
is_playing | boolean | Ob die Wiedergabe aktiv ist |
device | object | Informationen zum aktiven Gerät |
progress_ms | number | Fortschritt in Millisekunden |
currently_playing_type | string | Art des abgespielten Inhalts |
shuffle_state | boolean | Ob Zufallswiedergabe aktiviert ist |
repeat_state | string | Wiederholungsmodus (off, track, context) |
track | object | Aktuell abgespielter Titel |
spotify_get_currently_playing
Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
market | string | Nein | ISO-Ländercode für den Markt |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
is_playing | boolean | Ob die Wiedergabe aktiv ist |
progress_ms | number | Aktuelle Position im Track (ms) |
track | json | Aktuell spielender Track |
spotify_get_devices
Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
devices | array | Verfügbare Wiedergabegeräte |
spotify_get_queue
Benutzer abrufen
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
currently_playing | json | Aktuell spielender Track |
queue | json | Kommende Tracks in der Warteschlange |
spotify_play
Starten oder Fortsetzen der Wiedergabe auf Spotify. Kann bestimmte Tracks, Alben oder Playlists abspielen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
device_id | string | Nein | Geräte-ID, auf dem abgespielt werden soll. Wenn nicht angegeben, wird auf dem aktiven Gerät abgespielt. |
context_uri | string | Nein | Spotify-URI des Albums, Künstlers oder der Playlist, die abgespielt werden soll (z.B. "spotify:album:xxx") |
uris | string | Nein | Kommagetrennte Track-URIs zum Abspielen (z.B. "spotify:track:xxx,spotify:track:yyy") |
offset | number | Nein | Position im Kontext, an der die Wiedergabe beginnen soll (0-basierter Index) |
position_ms | number | Nein | Position im Track, von der aus gestartet werden soll (in Millisekunden) |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob die Wiedergabe erfolgreich gestartet wurde |
spotify_pause
Wiedergabe auf Spotify pausieren.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
device_id | string | Nein | Geräte-ID zum Pausieren. Wenn nicht angegeben, wird das aktive Gerät pausiert. |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob die Wiedergabe pausiert wurde |
spotify_skip_next
Zum nächsten Titel auf Spotify springen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
device_id | string | Nein | Geräte-ID. Wenn nicht angegeben, wird das aktive Gerät verwendet. |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob das Überspringen erfolgreich war |
spotify_skip_previous
Zum vorherigen Titel auf Spotify springen.
Eingabe
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
device_id | string | Nein | Geräte-ID. Wenn nicht angegeben, wird das aktive Gerät verwendet. |
Ausgabe
| Parameter | Typ | Beschreibung |
|---|---|---|
success | boolean | Ob das Überspringen erfolgreich war |
spotify_seek
Zu einer Position im aktuell spielenden Titel springen.
Eingabe
| Parameter | Type | Required | Description |
|---|---|---|---|
position_ms | number | Yes | Position in Millisekunden, zu der gesprungen werden soll |
device_id | string | No | Geräte-ID des Zielgeräts |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Ob der Sprung erfolgreich war |
spotify_add_to_queue
Einen Track zum Benutzer hinzufügen
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
uri | string | Yes | Spotify URI des hinzuzufügenden Tracks (z.B. "spotify:track:xxx") |
device_id | string | No | Geräte-ID. Wenn nicht angegeben, wird das aktive Gerät verwendet. |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Ob der Track zur Warteschlange hinzugefügt wurde |
spotify_set_volume
Die Wiedergabelautstärke auf Spotify einstellen.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
volume_percent | number | Yes | Lautstärke (0 bis 100) |
device_id | string | No | Geräte-ID. Wenn nicht angegeben, wird das aktive Gerät verwendet. |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Ob die Lautstärke eingestellt wurde |
spotify_set_repeat
Den Wiederholungsmodus für die Wiedergabe einstellen.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
state | string | Yes | Wiederholungsmodus: "off", "track" oder "context" |
device_id | string | No | Ziel-Geräte-ID |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Ob der Wiederholungsmodus erfolgreich eingestellt wurde |
spotify_set_shuffle
Zufallswiedergabe ein- oder ausschalten.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
state | boolean | Yes | true für Zufallswiedergabe ein, false für aus |
device_id | string | No | Ziel-Geräte-ID |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Ob die Zufallswiedergabe erfolgreich eingestellt wurde |
spotify_transfer_playback
Wiedergabe auf ein anderes Gerät übertragen.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
device_id | string | Yes | Geräte-ID, auf die die Wiedergabe übertragen werden soll |
play | boolean | No | Ob die Wiedergabe auf dem neuen Gerät gestartet werden soll |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Ob die Übertragung erfolgreich war |
Notes
- Category:
tools - Type:
spotify