Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
audio

Search for tracks

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.

get/v2/audio/search

Query parameters

artistsstring[]

Show tracks with one of the specified artist names or IDs

bpminteger

(Deprecated; use bpm_from and bpm_to instead) Show tracks with the specified beats per minute

bpm_frominteger

Show tracks with the specified beats per minute or faster

bpm_tointeger

Show tracks with the specified beats per minute or slower

durationinteger

Show tracks with the specified duration in seconds

duration_frominteger

Show tracks with the specified duration or longer in seconds

duration_tointeger

Show tracks with the specified duration or shorter in seconds

genrestring[]

Show tracks with each of the specified genres; to get the list of genres, use GET /v2/audio/genres

is_instrumentalboolean

Show instrumental music only

instrumentsstring[]

Show tracks with each of the specified instruments; to get the list of instruments, use GET /v2/audio/instruments

moodsstring[]

Show tracks with each of the specified moods; to get the list of moods, use GET /v2/audio/moods

pageinteger

Page number

per_pageinteger

Number of results per page

querystring

One or more search terms separated by spaces

sort'score' | 'ranking_all' | 'artist' | 'title' | 'bpm' | 'freshness' | 'duration'

Sort by

sort_order'asc' | 'desc'

Sort order

vocal_descriptionstring

Show tracks with the specified vocal description (male, female)

view'minimal' | 'full'

Amount of detail to render in the response

fieldsstring

Fields to display in the response; see the documentation for the fields parameter in the overview section

library'shutterstock' | 'premier'

Which library to search

languagestring

Which language to search in

Response

OK

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

total_countinteger required

Total count of all results across all pages

search_idstring required

ID of the search

Example response

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