View as Markdown
Spotify icon

Spotify ACTION

Get a Track

Get a track by its name or ID. See the docs here
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Spotify account once, then configure and run Get a Track from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "spotify-get-track",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    spotify: { authProvisionId: "apn_xxxxxxx" },
    trackId: "Track ID",
    market: "Market",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get a Track inputs
Property Type Description
trackId Track ID string
Type to search for any track or artist on Spotify, or enter a custom expression to reference a specific track ID (for example, 4iV5W9uYEdYUVa79Axb7Rh).
Required Dynamic
market Market string
Type to search for a country or enter a custom expression to specify the ISO 3166-1 alpha-2 country code.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
spotify-get-track
Version
0.1.7
App
Spotify
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes