Developers

We try to expose our information in easily consumable ways to the extent that we can. Though everything is still being built at the moment, more information and discussion can be found on our GitHub.

API

By joining TMT, you automatically gain access to the Free access Plan. You may find your access token in your settings page.

Plans

Though only the free plan is enabled as we keep on developing our basic features, here are the types of API access plans we currently wish to offer:

  • Free (50 requests / day)
  • Premium (1, 000 requests / day) [very small $]
  • Partner (10, 000 requests / day) [small $]
  • Unlimited [more $]

Example calls

* This list of calls is not exhaustive and the process still needs to be thoroughly documented. *

Artists

curl https://themusictank.com/api/v1/artists/nirvana?api_token=[YOUR_API_TOKEN]

{
    id: 2,
    name: "Nirvana",
    slug: "nirvana",
    thumbnail: 1,
    is_featured: null,
    created_at: "2017-09-18 15:54:08",
    updated_at: "2017-09-18 15:56:38",
    hex: "#725917"
}

Albums

curl https://themusictank.com/api/v1/albums/nevermind?api_token=[YOUR_API_TOKEN]

{
    id: 10,
    name: "Nevermind",
    slug: "nevermind",
    artist_id: 2,
    year: null,
    month: null,
    day: null,
    thumbnail: 1,
    created_at: "2017-09-18 15:54:08",
    updated_at: "2017-09-18 15:58:10",
    hex: "#2B3E83"
}

Tracks

curl https://themusictank.com/api/v1/tracks/smells-like-teen-spirit?api_token=[YOUR_API_TOKEN]

{
    id: 145,
    name: "Smells Like Teen Spirit",
    slug: "smells-like-teen-spirit",
    artist_id: 2,
    album_id: 10,
    youtube_key: "hTWKbfoikeg",
    length: 302,
    position_int: 1,
    position: "1",
    created_at: "2017-09-18 15:54:08",
    updated_at: "2017-09-18 16:40:00"
}

oEmbed

All of our resources expose oEmbed data as JSON. The returned data informs you on how TMT resources should be embeded in your oEmbed-aware application.

Query us using the following URL pattern, where you would send a valid URL to the url= parameter:

https://themusictank.com/oembed?url=https%3A%2F%2Fwww.themusictank.com%2Fartists%2nirvana

Open Search

We support open search as defined by our opensearch.osdx file.