API Documentation

The Edinburgh Festivals Listings API provides open access to the event listings of Edinburgh’s 12 major Festivals.

Edinburgh is the world’s favourite Festival city with over 43,000 performances taking place across the 12 Festivals year round - so there is a lot of data here! We’re excited to be able to open this up to let third-party developers interact with what is on offer. There are some straightforward terms and conditions for using the listings, so please make sure you've read over the licence before accessing the data.

What's available?

The API provides all the publicly available listings for the following 12 festivals - there is sometimes a short delay between a festival's public programme launch and the listings appearing in the API but we aim to keep this to a minimum. Note that events do get changed and updated throughout the year.

NEW Festival Listings Widget

It's now easier than ever to include the festival listings on your own website!

Festival listings widget

Festival 2012 2013 2014 2015 2016 2017 Notes
Edinburgh International Children's Festival YES YES YES YES YES YES
Edinburgh International Science Festival YES YES YES YES YES YES
Royal Edinburgh Military Tattoo YES YES YES YES YES YES
Edinburgh International Film Festival YES YES YES YES YES 31 May 17
Edinburgh International Festival YES YES YES YES YES YES
Edinburgh Jazz & Blues Festival YES YES YES YES YES Partial Full release May 17
Edinburgh Festival Fringe YES YES YES YES YES Partial Gradual release, full release 7 June 16
Edinburgh Art Festival YES YES YES YES YES Partial Full release May 17
Edinburgh Mela YES YES YES YES
Edinburgh International Book Festival YES YES YES YES YES June 17
Edinburgh International Storytelling Festival YES YES YES YES YES Oct 17
Edinburgh's Hogmanay YES YES YES YES YES Winter 17
Access to Edinburgh Festival Fringe listings is subject to approval.