Query
RequiredTextFree text. Field filters work too: artist:Radiohead year:2007.
Example value (replace with your own):
weird fishes
In this guide
Search
Find tracks, albums, artists, playlists, shows or episodes by name.
What this action does #
First, connect Spotify in Services. Then open Actions → + → Spotify and choose Search.
More about this action
The way most shortcuts start: turn a spoken or typed phrase into a URI, then feed that URI to Start Playback or Add to Queue. Results are grouped by type, so the value you want is usually `tracks.items[0].uri`.
Inputs to fill in #
Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.
Types
RequiredListOne or more. Each requested type gets its own result list.
A list of choice values. Use a comma-separated list.
Choices: album, artist, playlist, track, show, episode, audiobook
Example value (replace with your own):
track
Market
OptionalTextISO 3166-1 alpha-2 country code.
Example value (replace with your own):
US
Limit
OptionalWhole number1–10.
Example value (replace with your own):
10
Offset
OptionalWhole number0–1000.
Example value (replace with your own):
0
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 |
|---|---|---|
tracks | object | A group of named values. |
tracks.total | integer | Whole-number value. |
tracks.items | array | A list of values. |
tracks.items[].id | string | Text value. |
tracks.items[].name | string | Text value. |
tracks.items[].uri | string | Feed this to Start Playback or Add to Queue. |
tracks.items[].duration_ms | integer | Whole-number value. |
tracks.items[].artists | array | A list of values. |
tracks.items[].artists[].name | string | Text value. |
tracks.items[].album | object | A group of named values. |
tracks.items[].album.name | string | Text value. |
tracks.items[].album.images | array | A list of values. |
tracks.items[].album.images[].url | string | Text value. |
artists | object | Present only if requested. |
albums | object | Present only if requested. |
playlists | object | Present only if requested. |
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/search
Action identifier: spotify.search.v1
No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.
| Input | Request key | Location |
|---|---|---|
| Query | q | query |
| Types | type | query |
| Market | market | query |
| Limit | limit | query |
| Offset | offset | query |