Welcome to the GigaTools API (v1.0).
Browse
210403 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:
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
