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
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:
Access to basic datasets
Access to more endpoints and details
Access to all endpoints
Unlimited access to all endpoints
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.
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/
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.
Each API response include extra headers to help you manage how you handle you daily request quota.
|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.|
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! :)
The REST Api is rate limited and throttled to be able to continue serving the data to everyone effectively. You must respect these limits.
Failure to comply can result in a closing of your TMT account and a permanent revokation of your access to our data sources.