/v2/media

GET

Parameter Options
id The Media ID you wish to examine.
id_list A comma separated list of Media IDs you wish to examine.

Usage

This will return a JSON object structured as follows:

{
  "media" : {
    "id" : 4728,
    "title" : "CMI5434 What Could I Say",
    "genre" : "Pop",
    "duration" : 212,
    "filename" : "CMI.5434.What Could I Say.wav",
    "preview_url" : "...",
    "waveform_url" : "...",    
    "artists" : [
      { "id" : 2081, "name" : "Daniel's Window" },
      { "id" : 2082, "name" : "Lance Dale Gehl" },
      { "id" : 1385, "name" : "Alby Lee Odum" }
    ],
    "catalog" : { "id" : 1, "name" : "Spiffy All Media" },
    "provider" : { "id" : 1, "name" : "Spiffy Music" },
    "picked" : false
  }
}

For an :id_list the JSON object is structured as follows:

{
"media" : [
    {
      "id" : 4728,
      "title" : "CMI5434 What Could I Say",
      "genre" : "Pop",
      "duration" : 212,
      "filename" : "CMI.5434.What Could I Say.wav",
      "preview_url" : "...",
      "waveform_url" : "...",    
      "artists" : [
        { "id" : 2081, "name" : "Daniel's Window" },
        { "id" : 2082, "name" : "Lance Dale Gehl" },
        { "id" : 1385, "name" : "Alby Lee Odum" }
      ],
      "catalog" : { "id" : 1, "name" : "Spiffy All Media" },
      "provider" : { "id" : 1, "name" : "Spiffy Music" },
      "picked" : false
    },
    {
      "id" : 17,
      "title" : "Ridiculous - Instrumental",
      "genre" : "Urban",
      "duration" : 247,
      "filename" : "CMI.56.i.Ridiculous.wav",
      "preview_url" : "...",
      "waveform_url" : "...",    
      "artists" : [
        { "id" : 34, "name" : "George Washington" }
      ],
      "catalog" : { "id" : 1, "name" : "Spiffy All Media" },
      "provider" : { "id" : 1, "name" : "Spiffy Music" },
      "picked" : false
    },
    . . .
  ]
}

The picked field indicates if the media record is a featured item, promoted by the Rumblefish editorial staff. For any list of media, featured items will be the first listed.

Try It!

POST

Parameter Options
id The media ID for the file.
token Your access token.
format mp3, wav, flac, aiff, ogg The format of the file to retrieve.
bitrate 64k, 128k, 256k, 320k The bitrate of the file to retrieve.
license_key Also called RADKey, this string is returned from the license method and is required in order to download a media.

Usage

The media resource provides on-demand conversion of media files into the format you provide. You must provide a valid token and media ID in order to access the files. To preview files, please see the preview resource.

Because of the on-demand nature, your requested file may not be immediately available. While your file is being converted, the API will respond with the following JSON message:

{ 'retry_in' : 5 }

Where retry_in is an estimated number of seconds for when the file will be ready. Simply reissue the same POST query, and if the file is ready, the API will respond with:

{ 'media_url' : 'http://music.rumblefish.com/...'}

Where media_url represents a URL where you can retrieve the formatted file. Currently, rendered audio files will be available for a default period of 24 hours.

Try It! (get your license key first)