Sign in
latestOpenAPI 3.0.02026-07-131091452.6 MB

d2e03e7f655d

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"
}