Spotify API
Spotify artists, albums and tracks by Spotify id, with followers, monthly listeners and play counts.
Spotify artists, albums and tracks by Spotify id, with followers, monthly listeners and play counts.
When To Use This API
The Spotify API is for agent workflows that need public, platform-native data without writing a custom collector for every task. Use it when a prompt needs evidence from live public records, when a Skill needs repeatable enrichment, or when product code needs the same contract an agent discovered through MCP.
This section lists 3 live Spotify operations from the canonical OpenAPI spec. Each operation page documents the route, method, parameters, response envelope, pagination behavior when available, and the error vocabulary shared across UnifAPI.
- Compare artists by monthly listeners, followers, world rank and top cities for A&R and booking research.
- Read an album's tracks with play counts to see which songs carry a release.
- Map related artists and discography summaries to find similar acts for playlists and campaigns.
Agent Contract Notes
Agents usually discover these endpoints with the hosted UnifAPI MCP server, inspect the operation schema, then call only the records needed for the current task. Developers can call the same endpoints over HTTP with an API key, which makes the path from exploratory agent run to production integration direct.
Every successful response uses a stable envelope with a request id, data payload, optional pagination cursor, and billing metadata. Errors use the same closed vocabulary across platforms, so retry logic, user-facing explanations, and cost reporting can stay consistent even when a workflow spans multiple public-data sources.
When you are choosing an operation, start from the public identifier the user already has: a profile username, post id, channel id, subreddit name, search term, or URL-derived slug. Prefer the narrowest endpoint that answers the question, then expand only when the agent needs more evidence. This keeps record usage predictable, makes citations easier to explain, and avoids turning a focused research task into an expensive crawl.
Operations
Albums
GET /spotify/albums/{id}— Get a Spotify album — Returns a Spotify album by id: title, artists, release date, label, cover art and tracks.
Artists
GET /spotify/artists/{id}— Get a Spotify artist — Returns a Spotify artist by id: name, genres, followers, monthly listeners, world rank, related artists and discography.
Tracks
GET /spotify/tracks/{id}— Get a Spotify track — Returns a Spotify track by id: title, duration, play count, explicit flag, album and artists.