Overview

The Music Tank exposes its data from a public API found at https://api.themusictank.com/. Anybody can gain access and run queries against it assuming the calls are correctly authenticated.

All of the API responses are in JSON format.

API Plans

We wish to monetize access to our API, but we do not know which kind of offering would best suit API consumers.

We have no idea what type of adoption there may be for the API yet. For that reason, there is no obvious mechanism to switch plans or buy a different subscription.

Here is the ballpark of the types of access plans we'd eventually like to offer:

Plan Daily Requests Pricing
Free
Access to basic datasets
50 Free
Premium
Access to more endpoints and details
1,000 Least $
Partner
Access to all endpoints
10,000 Reasonable $
Unlimited
Unlimited access to all endpoints
Unlimited Most $

Changing Your Plan

If you feel you need to change plan to get more daily queries or to gain access to additional data in the responses, please contact us explaining what you are trying to build. Together we can figure something out that will work out for you.

Authentication

You must authenticate all API requests using the unique JWT that is tied to your Tanker profile.

A JSON Web Token (JWT) is a JSON-based open standard for creating access tokens that assert a number of claims. TMT's API uses JWTs to authenticate calls made against it and tie the request to your user account.

Obtaining a token

Create a TMT account to automatically gain access to the Free access plan.

You may find your access token in your API Settings page (assuming you are logged in).

Keep its value secret just like you would a password. Each time the token is used to make a request, said request will be made on your behalf. You may reset your token from your settings page at any time if you think it has been compromised.

Authenticated Query Example

Your JWT must be passed as an Authorization header using the Bearer schema to all requests made to the API. The content of the header should look like the following:

Authorization: Bearer <token>

The API's protected routes will check for a valid JWT in the Authorization header. If it's present and valid the user will be granted access protected resources assuming the API plan has not been exhausted.

For instance here's how you could query artists using curl:

$ curl -H 'Accept: application/json' -H "Authorization: Bearer <token>" https://api.themusictank.com/artists/nirvana/

Endpoints Documentation

There is little documentation since we are still actively building the API and there is still low interest in adoption.

The API's endpoints are exposed using Swagger here in the meantime.

Quota Headers

Each API response include extra headers to help you manage how you handle you daily request quota.

Key Description
x-api-requests-made The number of requests made on your daily quota.
x-api-requests-allowed The total allowed daily requests your account can perform.
x-api-requests-remaining The amount of remaining requests you account can perform during the period.
x-api-resets The datetime moment when the quota resets.
x-api-starts The datetime moment when the quota started.

Usage Restrictions

As per the NC-ND licence, you may not use this information to build your own version of The Music Tank.

This means you can't build an application that, like us, prints review data in a similar way.

We however encourage you to build upon that data with your own twist. That may be (but should in no way be limited to) visualization tools or building your own datasets derived from our information.

No matter what you end up doing, we are really curious and interested to see what you can build. Make sure to keep us in that loop! :)

Rate limits

The REST Api is rate limited and throttled to be able to continue serving the data to everyone effectively. You must respect these limits.

Termination

Failure to comply can result in a closing of your TMT account and a permanent revokation of your access to our data sources.



Start typing and submit the form to search across everything on TMT.