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.

Festival 2012 2013 2014 2015 2016 Notes
Imaginate Festival YES YES YES YES Spring 16
Edinburgh International Science Festival YES YES YES YES Feb 16
Royal Edinburgh Military Tattoo YES YES YES YES YES
Edinburgh International Film Festival YES YES YES YES May 16
Edinburgh International Festival YES YES YES YES Partial Full listings 6th April 16
Edinburgh Jazz & Blues Festival YES YES YES YES April 16
Edinburgh Festival Fringe YES YES YES YES Partial Gradual release, full release 8 June 16
Edinburgh Art Festival YES YES YES YES July 16
Edinburgh Mela YES YES YES YES July 16
Edinburgh International Book Festival YES YES YES YES 9 June 16
Edinburgh International Storytelling Festival YES YES YES YES Oct 16
Edinburgh's Hogmanay YES YES YES YES Winter 16
Access to Edinburgh Festival Fringe listings is subject to approval.
Register now ➤