search
suspend fun searchForItem(q: String, types: Set<SearchType>, market: CountryCode? = null, pagingOptions: PagingOptions = PagingOptions(), includeExternalAudio: Boolean = false): SpotifyApiResponse<SearchResponse>
Searches the Spotify catalog for albums, artists, tracks, playlists, and other item types.
Return
Wrapped Spotify API response with status code and parsed Spotify payload.
Parameters
q
Search query text sent to Spotify catalog search.
types
Resource types to include in the Spotify search (album, artist, track, playlist, etc.).
market
Market (country) code used to localize and filter content.
paging
Paging options (limit, offset) used for paged endpoints.
include
Whether to include externally hosted audio in search results (include_external=audio).