Search for tracks

GET {{baseUrl}}/v2/audio/search

This endpoint searches for tracks. If you specify more than one search parameter, the API uses an AND condition. Array parameters can be specified multiple times; in this case, the API uses an AND or an OR condition with those values, depending on the parameter.

Request Params

Key	Datatype	Description
`artists`	string	Show tracks with one of the specified artist names or IDs
`bpm`	string	(Deprecated; use bpm_from and bpm_to instead) Show tracks with the specified beats per minute
`bpm_from`	string	Show tracks with the specified beats per minute or faster
`bpm_to`	string	Show tracks with the specified beats per minute or slower
`duration`	string	Show tracks with the specified duration in seconds
`duration_from`	string	Show tracks with the specified duration or longer in seconds
`duration_to`	string	Show tracks with the specified duration or shorter in seconds
`genre`	string	Show tracks with each of the specified genres; to get the list of genres, use `GET /v2/audio/genres`
`is_instrumental`	string	Show instrumental music only
`instruments`	string	Show tracks with each of the specified instruments; to get the list of instruments, use `GET /v2/audio/instruments`
`moods`	string	Show tracks with each of the specified moods; to get the list of moods, use `GET /v2/audio/moods`
`page`	number	Page number
`per_page`	number	Number of results per page
`query`	string	One or more search terms separated by spaces
`sort`	string	Sort by
`sort_order`	string	Sort order
`vocal_description`	string	Show tracks with the specified vocal description (male, female)
`view`	string	Amount of detail to render in the response
`fields`	string	Fields to display in the response; see the documentation for the fields parameter in the overview section
`library`	string	Which library to search
`language`	string	Which language to search in

RESPONSES

status: OK

{&quot;page&quot;:1,&quot;per_page&quot;:5,&quot;total_count&quot;:25,&quot;search_id&quot;:&quot;c298887c-6f3e-45df-b6cd-41b246e4a104&quot;,&quot;data&quot;:[{&quot;vocal_description&quot;:&quot;&quot;,&quot;keywords&quot;:[&quot;celebratory&quot;,&quot;chic&quot;,&quot;euphoric&quot;,&quot;good times&quot;,&quot;hip&quot;,&quot;optimistic&quot;,&quot;party&quot;,&quot;soaring&quot;,&quot;upbeat&quot;],&quot;artists&quot;:[{&quot;name&quot;:&quot;Klimenko Music&quot;}],&quot;genres&quot;:[&quot;Dance/Electronic&quot;,&quot;Electro Pop&quot;,&quot;Pop/Rock&quot;],&quot;instruments&quot;:[&quot;Piano&quot;,&quot;Synth bass&quot;,&quot;Synth drums&quot;,&quot;Synthesizer&quot;],&quot;id&quot;:&quot;442583&quot;,&quot;isrc&quot;:&quot;&quot;,&quot;description&quot;:&quot;Pulsing and feel-good, featuring soaring synthesizer, groovy synth bass drums and synth drums that create a euphoric, upbeat mood.&quot;,&quot;similar_artists&quot;:[],&quot;releases&quot;:[],&quot;is_instrumental&quot;:true,&quot;title&quot;:&quot;Another Tomorrow&quot;,&quot;is_adult&quot;:false,&quot;lyrics&quot;:&quot;&quot;,&quot;media_type&quot;:&quot;audio&quot;,&quot;recording_version&quot;:&quot;&quot;,&quot;moods&quot;:[&quot;Bright&quot;,&quot;Confident&quot;,&quot;Fun&quot;,&quot;Happy&quot;,&quot;Inspiring&quot;,&quot;Optimistic&quot;,&quot;Playful&quot;,&quot;Sophisticated&quot;,&quot;Stylish&quot;,&quot;Uplifting&quot;],&quot;language&quot;:&quot;en&quot;,&quot;assets&quot;:{&quot;clean_audio&quot;:{&quot;file_size&quot;:35188408},&quot;preview_mp3&quot;:{&quot;file_size&quot;:4400203,&quot;url&quot;:&quot;https://ak.picdn.net/shutterstock/audio/442583/preview/preview.mp3&quot;},&quot;preview_ogg&quot;:{&quot;file_size&quot;:4453197,&quot;url&quot;:&quot;https://ak.picdn.net/shutterstock/audio/442583/preview/preview.ogg&quot;},&quot;waveform&quot;:{&quot;file_size&quot;:18778,&quot;url&quot;:&quot;https://ak.picdn.net/shutterstock/audio/442583/waveform/waveform.png&quot;}},&quot;contributor&quot;:{&quot;id&quot;:&quot;2847971&quot;},&quot;duration&quot;:183,&quot;album&quot;:{&quot;id&quot;:&quot;&quot;,&quot;title&quot;:&quot;&quot;},&quot;published_time&quot;:&quot;2016-08-16T14:30:03-04:00&quot;,&quot;updated_time&quot;:&quot;2016-08-18T17:59:33-04:00&quot;,&quot;bpm&quot;:110,&quot;added_date&quot;:&quot;2016-08-16&quot;,&quot;url&quot;:&quot;&quot;}]}