# Spotify

10 endpoints on Spotify. Every one returns the same response shape and has a flat, published price in credits.

Category: [Music & audio](https://onekey.dev/docs/categories/music.md) · [Overview page](https://onekey.dev/platforms/spotify)

> [!NOTE] **2 of 10 endpoints are marked "needs a pack" or "may need a pack"** in the table: free credits reach only the open fetch path; a verified email and a purchased pack unlock the rest. See [pricing](https://onekey.dev/pricing).

## Endpoints

| Endpoint | What it does | Cost | Status |
| --- | --- | --- | --- |
| [`album`](https://onekey.dev/docs/api/spotify/album.md) | Spotify album by id. | 1 credit | beta |
| [`artist`](https://onekey.dev/docs/api/spotify/artist.md) | Spotify artist by id. | 1 credit | beta |
| [`artist_top_tracks`](https://onekey.dev/docs/api/spotify/artist_top_tracks.md) | Top tracks of a Spotify artist (US). | 5 credits | beta |
| [`new_releases`](https://onekey.dev/docs/api/spotify/new_releases.md) | New album releases on Spotify. | 5 credits | beta |
| [`oembed`](https://onekey.dev/docs/api/spotify/oembed.md) | Spotify embed metadata for a track/album/playlist/artist/episode/show URL (oEmbed). | 1 credit | stable |
| [`podcast`](https://onekey.dev/docs/api/spotify/podcast.md) | A Spotify podcast (show): title, publisher, description, cover, rating where available. | 2 credits | beta **may need a pack** |
| [`podcast_episodes`](https://onekey.dev/docs/api/spotify/podcast_episodes.md) | Episodes of a Spotify podcast, newest first. | 2 credits | beta **may need a pack** |
| [`search_artists`](https://onekey.dev/docs/api/spotify/search_artists.md) | Search Spotify artists. | 5 credits | beta |
| [`search_tracks`](https://onekey.dev/docs/api/spotify/search_tracks.md) | Search Spotify tracks. | 1 credit | beta |
| [`track`](https://onekey.dev/docs/api/spotify/track.md) | Spotify track by id. | 1 credit | beta |

Every endpoint page has a **Field mapping** section showing which source field becomes which [unified field](https://onekey.dev/docs/schema.md) (fixed schema) or platform-specific `ext.` field.