JamBase API Documentation

Overview

The JamBase API enables outside applications to make calls to acquire JamBase data. All calls are available to any developer through a standard Rest-based format.

Request Format

Authentication: All API calls need to include the authentication parameter "&apikey=" + key.

http://api.jambase.com/search?apikey=abc123

Zip code: Include "zip" parameter as a 5 digit U.S. zipcode to filter results by location. If no radius parameter is provided, a default of 50 miles will be used:

http://api.jambase.com/search?zip=94107&apikey=abc123

Radius: Include "radius" parameter to change location filter:

http://api.jambase.com/search?zip=94107&radius=75&apikey=abc123

Band: Include "band" parameter to include results only for that artist:

http://api.jambase.com/search?band=Smashing+Pumpkins&apikey=abc123

User: Include "user" parameter to limit the results to only that My JamBase user's favorite artists:

http://api.jambase.com/search?user=jambase&apikey=abc123
("jambase" is an actual My JamBase user for "JamBase Picks")

Combination: Include any of the above together to mix the results:

http://api.jambase.com/search?band=Wilco&zip=94107&radius=25&apikey=abc123
http://api.jambase.com/search?zip=94107&radius=25&user=jambase&apikey=abc123

Sample API Response

<JamBase_Data>
<Results_Title>San Francisco, CA</Results_Title>
<event> 
	<event_id>846323</event_id> 
	<artists> 
		<artist><artist_id>7053</artist_id>
			<artist_name>Railroad Earth</artist_name></artist> 
		<artist><artist_id>24189</artist_id>
			<artist_name>Jim Lauderdale</artist_name></artist> 
	</artists> 
	<event_date>5/2/2009</event_date> 
	<venue> 
		<venue_id>727</venue_id>
		<venue_name>The Fillmore</venue_name> 
		<venue_city>San Francisco</venue_city>
		<venue_state>CA</venue_state> 
		<venue_zip>94115</venue_zip> 
	</venue> 
	<ticket_url>http://www.jambase.com/Redirect.aspx?EventID=846323</ticket_url>
	<event_url>http://www.jambase.com/Shows/Event.aspx?eventID=846323</event_url>
</event> 
<event> 
	<event_id>881234</event_id> 
	<artists> 
		<artist><artist_id>38176</artist_id>
			<artist_name>Oleta Adams</artist_name></artist>
	</artists>
	<event_date>5/2/2009</event_date>
	<venue>
		<venue_id>71720</venue_id>
		<venue_name>Nikko Hotel</venue_name> 
		<venue_city>San Francisco</venue_city>
		<venue_state>CA</venue_state> 
		<venue_zip>94102</venue_zip>
	</venue>
	<ticket_url>http://www.jambase.com/Redirect.aspx?EventID=881234</ticket_url>
	<event_url>http://www.jambase.com/Shows/Event.aspx?eventID=881234</event_url>
</event>
<event>
	...
</event>
</JamBase_Data>

Attribution

To comply with the JamBase API Terms of Use, you must display attribution on your web site or client application if JamBase API content or data are served from your website or client application. Please adhere to the following usage guidelines:

a. Linking.

When using the JamBase API, you must provide a link to JamBase.com using the standard linking format on your site for each event using the link provided from the API's 'event_url' node.

b. JamBase Logo

All data provided by the JamBase API must be accompanied by approved JamBase attribution or JamBase Logo that links directly to www.JamBase.com. Logos cannot be resized or edited in any fashion. If JamBase Data is used in alternative media formats, equivalent attribution must be given to JamBase. Prior written consent from JamBase is required to use JamBase Data without attribution.

Example Attribution:

**Concert information provided by <a href="http://www.jambase.com">JamBase</a>**
Here's a logo you can use to adhere to our attribution requirements:
JamBase Logo (140x70)
 
Here's the HTML code:
<a href="http://www.JamBase.com" target="_top" title="JamBase Concert Search">
<img src= "http://images.jambase.com/logos/jambase140x70.gif" alt="Search JamBase Concerts" border="0" /></a>


JamBase Fav Icon (16x16)
 
Developers can also include the JamBase Fav Icon in their applications if the regularly sized logo does not fit with their schema. This logo needs to be appropriately link to the relevant event page or JamBase homepage.
For sample implementations please see the JamBase API Applications Gallery