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.