The current version of the neighbortunes API version is v2
.
All valid requests to the API will begin with https://neighbortunes.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://neighbortunes.net/api/v2/setlists/showyear/2022.json?order_by=showdate | shows from 2022 |
https://neighbortunes.net/api/v2/setlists/songname/Don%27t+You+Cry.html | setlist records of the song "Don't You Cry" |
https://neighbortunes.net/api/v2/latest.json?order_by=position&direction=asc | latest shows, sorted by position ASC |
https://neighbortunes.net/api/v2/shows/show_id/1638552412.html | shows with show_id 1638552412 |
https://neighbortunes.net/api/v2/venues.json | all venues |
https://neighbortunes.net/api/v2/shows/venuename/Soundcheck+Studios.html | venues named Soundcheck Studios |
https://neighbortunes.net/api/v2/venues/state/MA.html | Shows in the state of Massachusetts |
https://neighbortunes.net/api/v2/venues/city/Pembroke.json | Shows in Pembroke |
https://neighbortunes.net/api/v2/jamcharts/city/Pembroke.html | Jamchart entries in Pembroke |
https://neighbortunes.net/api/v2/jamcharts.html | All jamchart entries in JSON |
https://neighbortunes.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.