Book a demo

Get Track

spotify.get_track
ActionBusiness appsconnection required

Calls the Spotify API with the connection's credentials.

Read one track's catalogue metadata by its Spotify id.

Ask about SpotifyAll Spotify nodesProvider API docs ↗

Connection

Required
Yes — the node will not save without one
Auth type
OAuth 2.0
Providers
Spotify
Secret shape
{"client_id": "…", "client_secret": "…", "refresh_token": "…"}
Config it needs
market, device_id
Resolved by
config.connection_id, else node.connection_id

Configuration

2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
track_id
The Spotify id of the track, as it appears in a search result or a playlist item.
stringYes——11dFghVXANMlKmJXsNCbNl
market
ISO 3166-1 alpha-2 country code deciding which catalogue is visible, such as 'US'. Left blank, the connection's default market is used, and the market on the authorised account takes priority over both.
stringNo——US

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "market": "US",
  "track_id": "11dFghVXANMlKmJXsNCbNl"
}

Output

One shape.

result

FieldTypeExample
id
The track's Spotify id.
string—
uri
The track's Spotify URI, which playback nodes take.
string—
name
The track title.
string—
duration_ms
Track length in milliseconds.
number—
explicit
True when the track is marked explicit.
boolean—
popularity
Spotify's popularity score from 0 to 100.
number—
preview_url
A 30-second preview MP3, or null.
string—
album.id
Spotify id of the album the track appears on.
string—
album.name
Name of that album.
string—
artists[].id
Spotify id of each credited artist.
string—
artists[].name
Name of each credited artist.
string—
external_urls.spotify
Open the track in a Spotify client.
string—
{
  "album": {
    "id": "",
    "name": ""
  },
  "artists": [
    {
      "id": "",
      "name": ""
    }
  ],
  "duration_ms": 0,
  "explicit": false,
  "external_urls": {
    "spotify": ""
  },
  "id": "",
  "name": "",
  "popularity": 0,
  "preview_url": "",
  "uri": ""
}

Related Spotify nodes

See Get Track run in a workflow.

In a technical demo we add the Spotify connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demoTalk to sales