The current version of the Bearly Dead Setlists API version is v2
.
All valid requests to the API will begin with https://bearlydead.songfishapp.com/api/v2. If you use that URL without any further data, it will return HTTP 204, no valid method found.
setlists
- display all setlist datalatest
- display most recent show setlist datashows
- display all show datasongs
- display all song datavenues
- display all venue datajamcharts
- display all jam chart data/[version]/[method].[format]
/[version]/[method]/[ID].[format]
/[version]/[method]/[column]/[value].[format]
There is no authentication for API calls - no token or key is necessary. No data is passed via POST or HEAD requests, only by URI and, optionally, by GET parameters.
Additional parameters may be passed via query string:
order_by
: name of column to sort bydirection
: direction to sort, either asc
or desc
(default asc
)limit
: number, maximum number of results to returne.g., /[version]/[method]/[column]/[value].[format]?order_by=[column]&direction=[direction]
API version 2 data is available in the following formats: JSON (.json) and HTML (.html).
The following are valid URLs to call the API:
If your request contains an error, you may end up with unexpected output. If your request URI contains a typos, uses improper case, or requests or sorts by a nonexistent column, you may end up with no data in your response.
If you use the HTML format – an error will display "No results found.".
The JSON format works a bit differently. Every JSON response is has three return nodes: error
, error_message
, and data
. A successful response will contain error
0, a blank error_message
, and a data
object populated with your response. An error response will contain error
1, a text-based error message
, and a blank data
object.