SHshutterstock
audio

Search for tracks

Changed on

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

Request

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

is_pro_freeboolean nullable

Show only pro-free tracks when true, only pro tracks when false, or all tracks when null

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"
        },
        "waveform_json": {
          "file_size": 0,
          "url": "https://ak.picdn.net/shutterstock/audio/442583/waveform/waveform.json"
        }
      },
      "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"
}

Changes

  • b43cab3aaaaaRevision changes
    • info

      added the new optional query request parameter is_pro_free

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • d2e03e7f655dRevision changes
    • breaking

      the // response's property type changed from integer to number for status

    • info

      api operation id searchAudio removed and replaced with searchTracks

    • info

      added the optional property /// to the response with the status