Authentication

Quantone’s API uses AppID and AppKey authentication for simplified access and authorization. Using AppID mode is simple. Check your account details to find your access string for your app and begin!

Do I need to authenticate?

Yes, Quantone’s API is only accessible through the use of AppID and require the use of an AppKey. Each application you create should use a new AppID and AppKey. These ids and keys are unique to the application and should be stored securely.

How do I find my AppID and AppKey?

In order to receive an AppID, you must do the following:
  1. For new users: Sign up for a Quantone user account
    • Upon registration, you will be asked to name and describe your application. This will generate your first app_id
    • To retrieve the AppKey, confirm your account registration and follow the AppKey retrieval instructions: Dashboard Applications select App Name View
  2. For existing users: login to Quantone account
    • Follow the same AppKey retrieval instructions for an existing app: Dashboard Applications select App Name View
    • To create a new app, My Applications Create New Application View

How do I call the API?

API Address
Quantone API
https://data.quantonemusic.com/v3/
Music Geek API
https://recommend.quantonemusic.com/

Both APIs are stateless, which means you need to identify yourself with each call.

On each call to the API you will need an AppID and AppKey included in your HTTP request header. An AppID and AppKey are provided when you register.

  • AppID = {Your Application ID}
  • AppKey = {Your Application Key}

The HTTP Request Header should look something like this:

GET /v3/albums?title=rumours HTTP/1.1
Host: data.quantonemusic.com
Connection: keep-alive
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.83 Safari/535.11
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Encoding: gzip,deflate,sdch
Accept-Language: en-GB,en-US;q=0.8,en;q=0.6
Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.3
AppID: {Your Application ID}
AppKey: {Your Application Key}

If you are accessing the Rest API via your web browser, a variety of plugins are available for each browser which allow you to specify HTTP Request Header information.

Browser Extension/Plugin/App
Chrome ModHeader
Firefox Modify Headers
Internet Explorer Fiddler
Safari Fiddler