APIs powered by the data of Phish.net. The current API version is
All valid requests to the API will begin with https://api.phish.net/v5.
artists- return artist data
attendance- return information about show attendance
jamcharts- return jam chart data
reviews- return data about show reviews
setlists- return setlist data
shows- return show data
songdata- return extended song data, including lyrics and history
songs- return song data
users- return data about a user
venues- return venue data
: See special methods
You can effectively "query" for a field using the above. To find a given setlist, you can use /v5/shows/showdate/YYYY-mm-dd.json. To get all setlists containing a specific song, /v5/setlists/song/songname.json or better yet /v5/setlists/slug/url-friendly-song-name.json.
Be sure to see our example calls for more.
With each request, your API key must be included via either a POST or GET parameter. Data can be passed by URI. Your requests may be rate-limited.
You can request API keys here.
Additional parameters may be passed via query string:
order_by: name of column to sort by
direction: direction to sort, either
limit: number, maximum number of results to return
no_header: if requesting data in HTML format, the argument _noheader will suppress the Phish.net banner
callback: if requesting data in JSON format, sending a callback will wrap the resulting JSON file in a callback function call
Available formats are JSON (.json) and HTML (.html). Some methods may support XML (.xml).
Unlike previous versions of our API, local storage is permitted, however, we request that you periodically refresh your data so that you are not presenting users outdated data.
We highly encourage you to cache frequently accessed data locally. API usage is tracked and apps that demand too much data, or data too frequently, will be disabled.
Note that Phish.net API response data itself is cached for a short period. If you are looking to embed data from an in-progress show, you will need to use a special method that are forthcoming.
Some parts of the API code use parts of a project called DB-to-API.