View as Markdown
Spotify icon

Spotify ACTION

Get Recommendations

Create a list of recommendations based on the available information for a given seed entity and matched against similar artists and tracks. If there is sufficient information about the provided seeds, a list of tracks will be returned together with pool size details. See the docs here.
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Spotify account once, then configure and run Get Recommendations 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-recommendations",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    spotify: { authProvisionId: "apn_xxxxxxx" },
    seedArtists: ["Seed Artists"],
    seedGenres: ["Seed Genres"],
  },
})

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 Recommendations inputs
Property Type Description
seedArtists Seed Artists string[]
An array of Spotify IDs for seed artists. Type to search for any artist on Spotify. Up to 5 seed values may be provided in any combination of seedArtists, seedTracks and seedGenres.
Optional Dynamic
seedGenres Seed Genres string[]
An array of genres. Up to 5 seed values may be provided in any combination of seedArtists, seedTracks and seedGenres.
Optional Dynamic
seedTracks Seed Tracks string[]
An array of Spotify IDs for a seed track. Type to search for any track on Spotify. Up to 5 seed values may be provided in any combination of seedArtists, seedTracks and seedGenres.
Optional Dynamic
limit Limit integer
The maximum number of items to return. The default is 100.
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-recommendations
Version
0.1.8
App
Spotify
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes