Welcome to the GigaTools API (v1.0).

Browse 203123 Gigs in 3423 Cities in 138 Countries.

You can apply for an API Key and then using that, query the entire database of public Gig listings.

You do not need an API Key to read the Gigs of one GigaTools User or Group. If you want to do this simply read that User's / Group's public Gigs feed URL which you can find on the Admin site.

Request an API Key here

Gig data is searchable via location, eg: City, Country, Venue and/or date range as well as via a User's Soundcloud or Twitter ID. The API is still in development, and we will post full documentation shortly. Thanks for your patience :-)

API Calls:

Get all Upcoming Gigs
Get Gigs within a Date Range
Get Upcoming Gigs via City
Get Upcoming Gigs via Country
Get Upcoming Gigs via Venue
Combine Location info with a Date range
Get GigaTools Users via Soundcloud IDs
Get Upcoming Gigs via Soundcloud Username
Get Upcoming Gigs via Twitter Username
Get Upcoming Gigs via Mixcloud Username

Get all upcoming Gigs

API Call:
http://api.gigatools.com/gigs.json?api_key=c2e9810f49c30a98fv
Result:
{
  "city": "Ibiza",
  "country": "Spain",
  "eventdate": "2013-06-25",
  "info": " ",
  "name": "San Rafael",
  "showtime": null,
  "state": null,
  "url": "",
  "url_tix": null,
  "venue": "Vista Club",
  "event_owner": "Anja Schneider",
  "follow_url": "http://gigs.gigatools.com/u/anjaschneider",
  "event_image": null
},

Get Gigs within a Specific Date Range:

API Call:
/gigs.json?from_date[]="2013-01-01"&to_date[]="2013-02-01"&api_key=c2e9810f49c30a98fv

Result:
{
  "city": "POITIERS",
  "country": "France",
  "eventdate": "2013-01-02",
  "info": "",
  "name": "MANIF regularisation des Sans-Papiers -18h00-",
  "showtime": null,
  "state": "",
  "url": "",
  "url_tix": null,
  "venue": "devant le Palais de Justice",
  "event_owner": "Place d'Armes",
  "follow_url": "http://gigs.gigatools.com/u/Bandit",
  "event_image": null
},

Get Upcoming Gigs via their City:

API Call:
/city.json?cities[]=Berlin&api_key=c2e9810f49c30a98fv

You can stack up to 10x cities via appending '&cities[]=City Name' to the URL

Result:
{
  "city": "Berlin",
  "country": "Germany",
  "eventdate": "2013-06-29",
  "info": "",
  "name": "Upon.You Label Night",
  "showtime": null,
  "state": "",
  "url": "",
  "url_tix": null,
  "venue": "Panorama Bar",
  "event_owner": "Marco Resmann",
  "follow_url": "http://gigs.gigatools.com/u/Marco",
  "event_image": null
},

Get Upcoming Gigs via their Country:

API Call:
/country.json?countries[]=austria&api_key=c2e9810f49c30a98fv

You can stack up to 10x countries via appending '&countries[]=City Name' to the URL

Result:
{
  "city": "Vienna",
  "country": "Austria",
  "eventdate": "2013-06-27",
  "info": "The Original @ PRATERSAUNA"
  "name": "SIP After Partys 2013 @ PRATERSAUNA",
  "showtime": null,
  "state": "",
  "url": "https://www.facebook.com/events/319326031527483",
  "url_tix": "http://vvk.sip-partys.at/",
  "venue": "PRATERSAUNA",
  "event_owner": "Mathias Markovits",
  "follow_url": "http://gigs.gigatools.com/u/Mathias",
  "event_image": "http://gigatools-prod.s3.amazonaws.com/event/169059/original/sip.jpg?1371142952"
},

Get Upcoming Gigs via their Venue:

API Call:
/venue.json?venues[]=Berghain&api_key=c2e9810f49c30a98fv

You can stack up to 10x venues via appending '&venues[]=Venue Name' to the URL

Result:
{
  "city": "Berlin",
  "country": "Germany",
  "eventdate": "2013-06-29",
  "info": "",
  "name": "Album Release Party",
  "showtime": null,
  "state": "",
  "url": "",
  "url_tix": null,
  "venue": "Berghain",
  "event_owner": "Marcel Fengler",
  "follow_url": "http://gigs.gigatools.com/u/MarcelFengler",
  "event_image": null
},

Combine Location info with a Date range:

API Call:
/city.json?cities[]=Ibiza&from_date[]="2013-06-01"&to_date[]="2013-07-01"&api_key=c2e9810f49c30a98fv

This method works with City, Country & Venue

Result:
{
  "city": "Ibiza",
  "country": "Spain",
  "eventdate": "2013-06-25",
  "info": " ",
  "name": "San Rafael",
  "showtime": null,
  "state": null,
  "url": "",
  "url_tix": null,
  "venue": "Vista Club",
  "event_owner": "Anja Schneider",
  "follow_url": "http://gigs.gigatools.com/u/anjaschneider",
  "event_image": null
},

Get GigaTools Users Via an Array of Soundcloud User IDs:

API Call:
/search.json?soundcloud_user_ids=1039,6251,19986369&api_key=c2e9810f49c30a98fv

This will return an object with GigaTools User info for each successful result.

Result:
{
  "artistname": "Grandmaster Flash",
  "mixcloud_url": null,
  "soundcloud_url": "http://soundcloud.com/dj-grandmaster-flash",
  "url": "http://www.grandmasterflash.com/",
  "username": "GrandmasterFlash",
  "follow_url": "http://gigs.gigatools.com/u/GrandmasterFlash",
  "twitter_url": "http://twitter.com/DJFlash4eva",
  "last_updated_at": 1375448252
},
{
  "artistname": "Speedy J",
  "mixcloud_url": null,
  "soundcloud_url": "http://soundcloud.com/jochempaap",
  "url": "http://www.speedyj.com",
  "username": "jochempaap",
  "follow_url": "http://gigs.gigatools.com/u/jochempaap",
  "twitter_url": "http://twitter.com/jochempaap",
  "last_updated_at": 1377947044
}
{
  "artistname": "Material Object",
  "mixcloud_url": "http://www.mixcloud.com/materialobject/",
  "soundcloud_url": "http://soundcloud.com/materialobject",
  "url": "http://www.materialobject.com",
  "username": "materialobject",
  "follow_url": "http://gigs.gigatools.com/u/materialobject",
  "twitter_url": "http://twitter.com/materialobject",
  "last_updated_at": 1378308270
},

Find a User & their Gigs via their Soundcloud Username:

API Call:
/search.json?api_key=c2e9810f49c30a98fv&soundcloud_username=jochempaap

Result:
{
  "artistname": "Speedy J",
  "bookingcontact": "natalie@electricdeluxe.net",
  "soundcloud_url": "http://soundcloud.com/jochempaap",
  "url": "http://www.speedyj.com",
  "username": "jochempaap",
  "follow_url": "http://gigs.gigatools.com/u/jochempaap",
  "twitter_url": "http://twitter.com/jochempaap"
}
{
  "city": "Amsterdam",
  "country": "Netherlands",
  "eventdate": "2013-08-24",
  "info": "",
  "name": "Mysteryland Edlx Stage",
  "showtime": null,
  "state": "",
  "url": "http://travel.mysteryland.com/event/69/mysteryland-amsterdam-2013.html",
  "url_tix": null,
  "venue": "Spaarndammerbwrt",
  "event_owner": "Speedy J",
  "follow_url": "http://gigs.gigatools.com/u/jochempaap",
  "event_image": null
},

Find a User & their Gigs via their Twitter Username:

/search.json?api_key=c2e9810f49c30a98fv&twitter_username=djflash4eva
{
  "artistname": "Grandmaster Flash",
  "bookingcontact": "dave.alcock@mn2s.com",
  "soundcloud_url": "http://soundcloud.com/dj-grandmaster-flash",
  "url": "http://www.grandmasterflash.com/",
  "username": "GrandmasterFlash",
  "follow_url": "http://gigs.gigatools.com/u/GrandmasterFlash",
  "twitter_url": "http://twitter.com/DJFlash4eva"
}
{
  "city": "London ",
  "country": "United Kingdom",
  "eventdate": "2013-05-03",
  "info": "",
  "name": "",
  "showtime": null,
  "state": "",
  "url": "http://www.bbc.co.uk/6music",
  "url_tix": null,
  "venue": "Grandmaster Flash BBC Radio 6 Mix 22.00 - 00.00 GMT",
  "event_owner": "Grandmaster Flash",
  "follow_url": "http://gigs.gigatools.com/u/GrandmasterFlash",
  "event_image": null
},

Find a User & their Gigs via their Mixcloud Username:

/search.json?api_key=c2e9810f49c30a98fv&mixcloud_username=audioinjection
{
  artistname": "Audio Injection",
  "bookingcontact": "nicole@palaciomedia.com",
  "mixcloud_url": "http://www.mixcloud.com/audioinjection/",
  "soundcloud_url": "http://soundcloud.com/audioinjection",
  "url": "http://www.audioinjection.com",
  "username": "audioinjectionla",
  "follow_url": "http://gigs.gigatools.com/u/audioinjectionla",
  "twitter_url": "http://twitter.com/audio_injection
}
{
  "city": "Chicago",
  "country": "United States",
  "eventdate": "2012-07-27",
  "info": "Line-up /\r\nAudio Injection\r\nSubmerge\r\nRicardo Garduno\r\nKomprezzor\r\nAlex Zelenka",
  "name": "Transmissions",
  "showtime": "2000-01-01T22:00:00Z",
  "state": "Illinois",
  "url": "https://www.facebook.com/events/223740227729005/",
  "url_tix": null,
  "venue": "Primary Night Club",
  "event_owner": "Audio Injection",
  "follow_url": "http://gigs.gigatools.com/u/audioinjectionla",
  "event_image": null
},
Stay tuned to the @GGTLS Twitter feed for updates and if you have questions or want to get in touch, do so via our website