Playing in the Sandbox
Hi there! This is the Rumblefish API sandbox. It's a staging environment where our developers get to share early access to the fun things we're working on. Consequently, we need to make sure you're aware of a few things:
- No music for you! Sorry, but we can't allow you to license music through the sandbox. Check out FriendlyMusic.com if you're lookin' for the goods!
- We want feedback. How was your experience with the Rumblefish API? Did it suck? Do you love or hate the documentation? Is there a feature you're dying to see? We want to hear from you directly!
Thanks for checking us out!
The Rumblefish API allows you to find, license, and download music for use in videos, slideshows, games, and all things that lawyers consider "moving pictures."
Documentation is available for all of the resources, simply by appending
.html to the URL of the
resource you want to know about. Check out the links in the sidebar to see what we mean. If you ever get lost,
you can come back here.
The documentation for each resource is simply split up by the HTTP verbs you'll be using. Want to know what
GET /v2/media does for you? Head on over to
media#get. Go ahead and click around
a bit to get acquainted. We'll be here when you get back.
Hey, did you see the Try It! section in the docs? Try it out. It'll give you an in-browser demonstration of how that piece works.
So, that's a quick tour of how the API and documentation works. Now, into the meat of the matter ...
Get a Portal
A portal is basically a set of rules that defines what kind of music you have access to. Rumblefish provides licensing for everything from social media to corporate presentations to international films, and to ensure that you're able to get access to the rights types of music and licenses, we create a portal for you.
Please note: you will need a
portal account to license or download media.
Get a Portal Token
Given your portal credentials, head on over to the
resource to get an access token. This token tells us that you've successfully authenticated, and also allows us
to automatically match our responses to the requirements of your portal.
Currently, the best way to explore music is via the
search resource. Head over there
to learn more about how to zero in on the perfect track.
The steps to licensing and downloading a track are pretty straight forward:
- Authenticate and get a token via the
- Find the
mediayou wish to license.
- Register a license via the
- Request the format and bitrate of the licensed
mediayou would like to download.
- Download the encoded and licensed
Why are the request and download steps separate? We have an on-demand rendering system that generates MP3s, OGGs, WAVs, FLACs, AIFFs and other formats in whatever bitrate you want. It takes a minute or two for us to convert the files, and when conversion is done, you will receive a unique download URL for the file you requested.
Please note, only authorized partners can register licenses via the API.