In this guide
Get Currently Playing Track
What the user is listening to right now.
What this action does #
First, connect Spotify in Services. Then open Actions → + → Spotify and choose Get Currently Playing Track.
More about this action
Returns no content at all when nothing is playing, which is a success.
Inputs to fill in #
This action has no input fields. You can name and save it after choosing the action.
What comes back #
In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.
| Returned field | Type | Meaning |
|---|---|---|
is_playing | boolean | True or false. |
progress_ms | integer | Milliseconds into the track. |
currently_playing_type | string | track, episode, ad or unknown. |
item | object | The track, or the episode when a podcast is playing. |
item.id | string | Text value. |
item.name | string | Text value. |
item.uri | string | Text value. |
item.duration_ms | integer | Whole-number value. |
item.explicit | boolean | True or false. |
item.popularity | integer | Whole-number value. |
item.external_urls | object | A group of named values. |
item.external_urls.spotify | string | Shareable link to the track. |
item.artists | array | A list of values. |
item.artists[].id | string | Text value. |
item.artists[].name | string | Text value. |
item.artists[].uri | string | Text value. |
item.album | object | A group of named values. |
item.album.id | string | Text value. |
item.album.name | string | Text value. |
item.album.release_date | string | Text value. |
item.album.total_tracks | integer | Whole-number value. |
item.album.images | array | A list of values. |
item.album.images[].url | string | Cover art, largest first. |
item.album.images[].height | integer | Whole-number value. |
item.album.images[].width | integer | Whole-number value. |
Run it from Shortcuts #
- Give the action a recognizable name and tap Save.
- In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
- Supply any Param or File slots you bound in the inputs, then run the shortcut.
If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.
Advanced reference #
Request, permissions, and identifiers
Request: GET https://api.spotify.com/v1/me/player/currently-playing
Action identifier: spotify.player.currentlyPlaying.get.v1
Permissions declared for this action: user-read-playback-state. The account’s own access rules also apply.