Listings API

We encourage the open use of this data, and ask that you let us know if you build anything cool!

Please note: this api is not totally finalized! If you're building anything with this API, please get in touch with us so we can keep you abreast of the latest changes. Once the API is finalized, this warning will be taken down.

Questions, comments, etc., can be directed to Mike Schuette at schuette@onesolstice.com.

Version 1

/v1/:year/cities

  • Query parameters
    • id
      Integer
    • name
      String, case-insensitive. Can be a partial string, eg "mad" for "Madison".

/v1/:year/performances

  • Query parameters
    • id
      Integer
    • city_id
      Integer from /v1/:year/cities
    • artist_name
      String, case-insensitive. Can be a partial string, eg "monk" for "The Monkees".
    • location_name
      String, case-insensitive. Can be a partial string, eg "club" for "Club 77".
    • genre
      String, case-insensitive. Can be a partial string, eg "hip" for "Hip-Hop".
    • neighborhood
      String, case-insensitive. Can be a partial string, eg "bro" for "Brooklyn".
    • TODO starts_after
      Integer number of millis since epoch. Intended for use with JavaScript Date.getTime(). Performs a >= search using the local time for the city.
    • TODO ends_before
      Integer number of millis since epoch. Intended for use with JavaScript Date.getTime(). Performs a <= search using the local time for the city.
    • page
      Integer which page of results to return. 50 results are returned per page.

/v1/:year/performances/count

You may use all of the same parameters as for /v1/:year/performances/ and this will return a total count of the results for that query.

/v1/:year/artists

  • Query parameters
    • id
      Integer
    • city_id
      Integer from /v1/:year/cities
    • name
      String, case-insensitive. Can be a partial string, eg "monk" for "The Monkees".
    • genre
      String, case-insensitive. Can be a partial string, eg "hip" for "Hip-Hop".
    • page
      Integer which page of results to return. 50 results are returned per page.

/v1/:year/artists/count

You may use all of the same parameters as for /v1/:year/artists/ and this will return a total count of the results for that query.

/v1/:year/locations

  • Query parameters
    • id
      Integer
    • city_id
      Integer from /v1/:year/cities
    • name
      String, case-insensitive. Can be a partial string, eg "club" for "Club 77".
    • neighborhood
      String, case-insensitive. Can be a partial string, eg "bro" for "Brooklyn".
    • location_type
      String, case-insensitive. Can be a partial string. See also: "location_types" from /v1/:year/cities
    • rain_accommodations
      String, case-insensitive. Can be a partial string. See also: "rain_accommodations" from /v1/:year/cities
    • page
      Integer which page of results to return. 50 results are returned per page.

/v1/:year/locations/count

You may use all of the same parameters as for /v1/:year/locations/ and this will return a total count of the results for that query.