API Guide

General search calls

Return Artist details from artist name
theaudiodb.com/api/v1/json/{APIKEY}/search.php?s={Artist name}
Example - theaudiodb.com/api/v1/json/1/search.php?s=coldplay

Return all Album details from artist name
theaudiodb.com/api/v1/json/{APIKEY}/searchalbum.php?s={Artist name}

Return single album details from artist + album name
theaudiodb.com/api/v1/json/{APIKEY}/searchalbum.php?s={Artist name}&a={Album name}

Return single album details from album name
theaudiodb.com/api/v1/json/{APIKEY}/searchalbum.php?a={Album name}

Return track details from artist/track name
theaudiodb.com/api/v1/json/{APIKEY}/searchtrack.php?s={Artist_Name}&t={Single_Name}

Return Discography for an Artist with Album names and year only
theaudiodb.com/api/v1/json/{APIKEY}/discography.php?s={Artist_Name}

Return Discography for an Artist with Album names and year only using known MBID
theaudiodb.com/api/v1/json/{APIKEY}/discography-mb.php?s={Music_Brainz_Artist_ID}


Artist Data

Return individul Artist details using known TADB_Artist_ID
theaudiodb.com/api/v1/json/{APIKEY}/artist.php?i={artistid}

Return individual Artist info using a known MusicBrainz_Artist_ID
theaudiodb.com/api/v1/json/{APIKEY}/artist-mb.php?i={mb_artist_id}


Album Data

Return All Albums for an Artist using known TADB_Artist_ID
theaudiodb.com/api/v1/json/{APIKEY}/album.php?i={artistid}

Return individual Album info using known TADB_Album_ID
theaudiodb.com/api/v1/json/{APIKEY}/album.php?m={albumid}

Return individual Album info using a known MusicBrainz_Release-Group_ID
theaudiodb.com/api/v1/json/{APIKEY}/album-mb.php?i={mb_release-group_id}


Track Data

Return All Tracks for Album from known TADB_Album_ID
theaudiodb.com/api/v1/json/{APIKEY}/track.php?m={albumid}

Return individual track info using a known TADB_Track_ID
theaudiodb.com/api/v1/json/{APIKEY}/track.php?h={trackid}

Return individual track info using a known MusicBrainz_Recording_ID
theaudiodb.com/api/v1/json/{APIKEY}/track-mb.php?i={mb_recording_id}


Music Videos

Return all the Music videos for a known TADB_Artist_ID
theaudiodb.com/api/v1/json/{APIKEY}/mvid.php?i=(artistid}

Return all the Music videos for a known Music_Brainz_ID
theaudiodb.com/api/v1/json/{APIKEY}/mvid-mb.php?i=(MbArtistID}

Return a Music DVD from artist/mdvd name
theaudiodb.com/api/v1/json/{APIKEY}/searchmdvd.php?s={Artist_Name}&a={Music_Dvd_Name}


Top 10 Tracks

Return The top 10 Most Loved tracks for an Artist Name
theaudiodb.com/api/v1/json/{APIKEY}/track-top10.php?s=(artistname}

Return The top 10 Most Loved tracks for an Artist Music Brainz ID
theaudiodb.com/api/v1/json/{APIKEY}/track-top10-mb.php?s=(Music_Brainz_Artist_ID}


Images

Preview Images
Most of the time you won't want to download the original large image, just get a small preview. This is possible simple by adding "/preview" onto the end URL. This will give you a small 200px version. This will work with TheAudioDB.com and Fanart.tv URL's in exactly the same way hopefully :)

Original Image - theaudiodb.com/images/media/artist/thumb/xxtwus1340291734.jpg
Small Image - theaudiodb.com/images/media/artist/thumb/xxtwus1340291734.jpg/preview


Listing user ratings via the api

List every rating made by a user
theaudiodb.com/api/v1/json/{apikey}/ratings-album.php?user={username}
theaudiodb.com/api/v1/json/{apikey}/ratings-track.php?user={username}

Example
theaudiodb.com/api/v1/json/1/ratings-track.php?user=Arturo007


Submitting user ratings via the api

Submit Rating via API
theaudiodb.com/api/v1/json/{apikey}/submit-album.php?user={user}&artist={artist}&album={album}&rating={1-10}&api={apitoken}
theaudiodb.com/api/v1/json/{apikey}/submit-track.php?user={user}&artist={artist}&album={album}&track={track}&rating={1-10}&api={apitoken}

Example (with api token removed)
theaudiodb.com/api/v1/json/1/submit-album.php?user=zag&artist=Alison%20Krauss&album=Essential&rating=7&api=&api=
theaudiodb.com/api/v1/json/1/submit-track.php?user=zag&artist=Alison_Krauss&album=Essential&track=Restless&rating=7&api=

You can find the API token for on the user page, top right on the menu click on your username (it will only show up if you are logged in as yourself).

theaudiodb.com/user/username



API also provides a responses in JSON like this:
{"result":"SUCCESS New rating"}
{"result":"SUCCESS Updated rating"}
{"result":"ERROR No item found"}
{"result":"ERROR Missing input"}


Current Trending Music

theaudiodb.com/api/v1/json/1/trending.php?country=us&type=itunes&format=albums
theaudiodb.com/api/v1/json/1/trending.php?country=us&type=itunes&format=singles

Parameters:

type: itunes (only for now but will extend in future to more sources)
country: us, gb, de, fr, it
format: albums, singles


Song Hash Lookup

theaudiodb.com/api/v1/json/{APIKEY}/search-hash.php?h1={Hash1}&h2={Hash2}

theaudiodb.com/api/v1/json/1/search-hash.php?h1=5C9A5186D36C5CD0&h2=8B79EDB8090D16CB

NOTE: At the moment both hashes are required and must each be 16 characters long