API Documentation


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.

Methods

  • setlists - display setlist data
  • latest - display most recent show setlist data
  • shows - display show data
  • songs - display song data
  • venues - display venue data
  • jamcharts - display jam chart data
  • albums - display data related to discography
  • metadata - display setlist metadata
  • links - display links attached to shows
  • uploads - display show metadata, including poster art and featured images
  • appearances - display muscian appearances

Special Methods

Special methods behave differently than regular methods.

  • list - the list method has a unique syntax and response format - see "List Syntax" for more

API Request Structure

  • all data returned via a method: /[version]/[method].[format]
  • specific row in a method: /[version]/[method]/[ID].[format]
  • all rows matching a query: /[version]/[method]/[column]/[value].[format]

Authentication

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 in the query string.

Additional Parameters

Additional parameters may be passed via query string:

  • order_by: name of column to sort by
  • direction: direction to sort, either asc or desc (default asc)
  • limit: number, maximum number of results to return

e.g., /[version]/[method]/[column]/[value].[format]?order_by=[column]&direction=[direction]

Formats

API version 2 data is available in the following formats: JSON (.json) and HTML (.html).


Powered by Songfish