Skip to content

MediaSearchInterfaceSearchMediaMessage

HTTP API schema

← HTTP API reference

Search for tracks, albums, artists, playlists, shows or episodes with a query.

MediaSearchInterfaceSearchMediaMessage fields

querystringRequired

Freeform query string

typestring

Resource kind: track, album, artist, playlist, show or episode when advertised. Defaults to track

Default: track

albumstring

Search by album name, can only be used when searching albums, and tracks

artiststring

Search by artist name, can only be used when searching artists, albums and tracks

yearstring

Search by year, can only be used when searching albums, years, and tracks. You can pass a range like 1990-2000

maxResultsinteger

Maximum results on one page.

minimum: 1

maximum: 50

Default: 20

nextTokenstring

Copy the opaque continuation from the previous result with the same query and filters.

minLength: 1

View source specification ↗