API Parameters

Events

The SonicLiving API can return events for one or many artists with a single query. This is extremely powerful feature for listing events to go along with applications that support user playlists.

The API is available here: http://api.sonicliving.com/api/

Parameters

name	values	specification type
key	API key	auth
q	query type : artists | all | pop	query
artists[]	artist names	artist
venue_ids[]	venue ids	SL venue_id
zips[]	zip codes	location
lat[]	latitude value	location
lon[]	longitude value	location
current_ip_loc	true	get location from current ip address
ip_loc	ip address	get location from given ip address
radius[]	number of miles	location
start	date value : YYYY-MM-DD	date
end	date value : YYYY-MM-DD	date
date	date value : YYYY-MM-DD	date
limit	integer	limit number of results

q: query type optional parameter

The default query type is "artists". This is used when the 'q' value is unspecified. If query type is "all", then All events within the other specified restrictions will be returned (date/region/radius/etc..) and ordered by date If query type is "pop", then All events within the other specified restrictions will be returned (date/region/radius/etc..) and ordered by popularity query type "all" or "pop" overrides the artists[] parameter

artists[]: shows for a given artist. artists is currently required unless a different query type or venue is specified

This performs a lookup for a specific artist, as opposed to a general search. You can specify this argument multiple times, for multiple searches at once. artists[]=beck&artists[]=radiohead will return shows for both Beck and Radiohead. Note that the "&" (ampersand) character must be replaced with "and".

venue_ids[]: shows for a given venue. venue_ids are not required

This performs a lookup for a specific venue_id, as opposed to a general search. You can specify this argument multiple times, for multiple searches at once. SonicLiving venue_id's are returned in the json resultset, and may change over time.

key: The API access key is currently required

Get your API key here

zips[]: restrict search to a zip code. zips not required

This limits your lookup to a specific zip code. If omitted, all the events for an artist will be returned. You can specify this argument multiple times, for multiple searches at once. zips[]=94610&zips[]=10012&artists[]=beck&artists[]=radiohead will return shows for both Beck and Radiohead in Oakland and New York.

lat[]: restrict search to a geo location. lat/lon pairs not required
lon[]: restrict search to a geo location. lat/lon values must be paired evenly or no results will be returned

This limits your lookup to a specific geo location. If omitted, all the events for an artist will be returned. You can specify these argument multiple times, for multiple searches at once. &lat[]=38.325&lon[]=-122.708&artists[]=beck will return shows for both Beck in the SF area.

current_ip_loc=true: restrict search to a geo location based on the requesting current ip address.
ip_loc: restrict search to a geo location based on a given ip address

This limits your lookup to a specific geo location. If omitted, all the events for an artist will be returned. You can specify either current_ip_loc or ip_loc, but not both. These will override any other location values.

start: restrict search to a start date. start/end date pairs not required
end: restrict search to an end date. start/end date pairs not required
date: restrict search to a single specific date. This is equivalent to setting start=end

This limits your lookup to a specific date range. The parameters are inclusive. You may not currently specify a start date in the past. &start=2008-12-20&end=2008-12-31 will return shows between the dates specified.

radius: specifiy the radius around zip codes to look for shows.

Radius around a zip code (or lat/long) in miles. If omitted, a default radius of 50 miles is used. You can specify this argument only once. zips[]=10012&artists[]=beck&radius=5 will return shows for both Beck within 5 miles of New York. Note: there is a 140 mile radius limit. Omit the zip and radius to return all shows for the specified artists.