The current version of the El Göose.net API version is v2
.
All valid requests to the API will begin with https://elgoose.net/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 dataalbums
- display all data related to discography/[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:
Description | URL |
---|---|
https://elgoose.net/api/v2/setlists/showyear/2022.json?order_by=showdate | shows from 2022 |
https://elgoose.net/api/v2/setlists/songname/Hungersite.html | setlist records of the song "Hungersite" |
https://elgoose.net/api/v2/latest.json?order_by=position&direction=asc | latest shows, sorted by position ASC |
https://elgoose.net/api/v2/shows/show_id/1658554962.html | shows with show_id 1658554962 |
https://elgoose.net/api/v2/venues.json | all venues |
https://elgoose.net/api/v2/shows/venuename/High+Sierra+Music+Festival.html | venues named High Sierra Music Festival |
https://elgoose.net/api/v2/venues/state/CA.html | Shows in the state of California |
https://elgoose.net/api/v2/venues/city/Quincy.json | Shows in Quincy |
https://elgoose.net/api/v2/jamcharts/city/Quincy.html | Jamchart entries in Quincy |
https://elgoose.net/api/v2/jamcharts.html | All jamchart entries in JSON |
https://elgoose.net/api/v2/albums.json | All album tracks in JSON |
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.