Welcome to the GigaTools API (v1.0).

Browse 241502 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 the API to read the Gigs for a single User or Group. These can be accessed by that User or Group's Gigs Feed, More info can be found 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 :-)

Request an API Key here

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 Soundcloud URL
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 Soundcloud URL:

API Call:
/search.json?api_key=c2e9810f49c30a98fv&soundcloud_url=florian-kaltstrom

Result:
{
  "artistname": "Florian Kaltstrom"",
  "bookingcontact": "floriankaltstrom@hotmail.de",
  "soundcloud_url": "http://soundcloud.com/florian-kaltstrom",
  "url": "http://www.floriankaltstrom.de",
  "username": "Kaltstrom",
  "follow_url": "http://gigs.gigatools.com/u/Kaltstrom",
  "twitter_url": "http://twitter.com/kaltstroem"
}
{
  "city": "Vienna",
  "country": "Austria",
  "eventdate": "2014-01-17",
  "info": "",
  "name": "Zuckerwatt",
  "showtime": null,
  "state": "",
  "url": "https://www.facebook.com/events/558560897561766",
  "url_tix": null,
  "venue": "SASS Music Club",
  "event_owner": "Florian Kaltstrom",
  "follow_url": "http://gigs.gigatools.com/u/Kaltstrom",
  "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