# Spotify API: Search music > Searches Spotify for songs, artists, albums, playlists or podcasts by keywords and returns them in Spotify's result order. Songs and albums include a release date when Spotify gives a full date. Unofficial. Not affiliated with or endorsed by Spotify. - Page: https://fous.com/methods/spotify.com/search-music - Method: `spotify.com/search_music`, version 1 - Website: spotify.com - Returns: name, type, artists, owner, publisher, album, release date, length, image link, Spotify link, Spotify ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `type` | string | no | `"playlists"` | Kind of result, such as songs. One of "songs", "artists", "albums", "playlists", "podcasts". Default "songs". | | `query` | string | yes | `"lofi study"` | Words to search for, such as Adele Hello. | | `country` | string | no | | Country name or two-letter code, such as United States or GB. Default "United States". | | `max_results` | integer | no | `12` | Maximum number of results, such as 10. Default 10. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "type": "playlists", "query": "lofi study", "max_results": 12 } ``` Its output: ```json { "results": [ { "name": "chill lofi study beats", "type": "playlist", "album": null, "owner": "Spotify", "length": null, "artists": null, "publisher": null, "image_link": "https://i.scdn.co/image/ab67706f000000021498ddc160581579f9b55979", "spotify_id": "37i9dQZF1DX8Uebhn9wzrS", "release_date": null, "spotify_link": "https://open.spotify.com/playlist/37i9dQZF1DX8Uebhn9wzrS" }, { "name": "Lofi Study 2026", "type": "playlist", "album": null, "owner": "Lofi Girl", "length": null, "artists": null, "publisher": null, "image_link": "https://image-cdn-fa.spotifycdn.com/image/ab67706c0000d72ce8fcb214bcd7d054018d9fe4", "spotify_id": "6zCID88oNjNv9zx6puDHKj", "release_date": null, "spotify_link": "https://open.spotify.com/playlist/6zCID88oNjNv9zx6puDHKj" }, { "name": "lofi autumn beats ๐Ÿ๐Ÿ‚", "type": "playlist", "album": null, "owner": "Spotify", "length": null, "artists": null, "publisher": null, "image_link": "https://i.scdn.co/image/ab67706f00000002409a98a40d38e6c16f39d796", "spotify_id": "37i9dQZF1DX9O8HCSWScgZ", "release_date": null, "spotify_link": "https://open.spotify.com/playlist/37i9dQZF1DX9O8HCSWScgZ" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"spotify.com/search_music","input":{"type":"playlists","query":"lofi study","max_results":12}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find songs matching the words Adele Hello, limit to 10 results, country United States - Show me 25 albums with the keyword jazz piano, country GB - Look up artists named Radiohead and return up to 5 results - Search for podcasts about true crime on spotify.com, max 15 results - Get playlists tagged chill lofi beats for the country Germany, 20 results ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "type": { "enum": [ "songs", "artists", "albums", "playlists", "podcasts" ], "type": "string", "default": "songs", "description": "Kind of result, such as songs." }, "query": { "type": "string", "minLength": 1, "description": "Words to search for, such as Adele Hello." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, such as United States or GB." }, "max_results": { "type": "integer", "default": 10, "maximum": 50, "minimum": 1, "description": "Maximum number of results, such as 10." } } } ``` ## Output schema ```json { "type": "object", "required": [ "results" ], "properties": { "results": { "type": "array", "items": { "type": "object", "required": [ "name", "type", "spotify_link", "spotify_id" ], "properties": { "name": { "type": "string" }, "type": { "enum": [ "song", "artist", "album", "playlist", "podcast" ], "type": "string" }, "album": { "type": [ "string", "null" ] }, "owner": { "type": [ "string", "null" ] }, "length": { "type": [ "string", "null" ] }, "artists": { "type": [ "string", "null" ] }, "publisher": { "type": [ "string", "null" ] }, "image_link": { "type": [ "string", "null" ] }, "spotify_id": { "type": "string" }, "release_date": { "type": [ "string", "null" ] }, "spotify_link": { "type": "string" } } }, "description": "Matches in Spotify search order." } } } ``` ## See more - [Spotify API: Get song](https://fous.com/methods/open.spotify.com/get-song.md): Finds a Spotify song by title (optionally narrowed by artist), track link, URI or track ID and returns its public play count and details. Without an artist, the most-played exact title match wins. Previews and ISRC may be unavailable for some tracks. - [Spotify API: Get album](https://fous.com/methods/open.spotify.com/get-album.md): Gets a Spotify album by name (optionally with the artist), album link or album ID, with its details and ordered track list including play counts. - [Spotify API: Get artist](https://fous.com/methods/open.spotify.com/get-artist.md): Gets a Spotify artist's public profile from their name, artist link or ID: listeners, followers, world rank, top cities, popular tracks, latest release and release counts. - [Spotify API: List top podcasts](https://fous.com/methods/open.spotify.com/list-top-podcasts.md): Lists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries. - [Apple API: Search songs](https://fous.com/methods/music.apple.com/search-songs.md): Searches the Apple Music song catalog by title and artist words, returning matching tracks in relevance order with prices and previews when available. - [Apple API: Search podcasts](https://fous.com/methods/podcasts.apple.com/search-podcasts.md): Finds Apple Podcasts shows by name or topic in a country, ordered by search relevance, with ratings when the show page provides them. - [Kworb API: Get Spotify daily chart](https://fous.com/methods/kworb.net/get-spotify-daily-chart.md): Returns the latest published Spotify daily Top 200 chart from Kworb for a country or worldwide, with rankings and stream counts. - [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links. - [All Spotify methods](https://fous.com/methods/spotify.com.md)