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 Notes
Imaginate Festival YES YES YES YES YES
Edinburgh International Science Festival YES YES YES YES YES
Royal Edinburgh Military Tattoo YES YES YES YES YES
Edinburgh International Film Festival YES YES YES YES YES
Edinburgh International Festival YES YES YES YES YES
Edinburgh Jazz & Blues Festival YES YES YES YES YES
Edinburgh Festival Fringe YES YES YES YES YES
Edinburgh Art Festival YES YES YES YES YES
Edinburgh Mela YES YES YES YES NO
Edinburgh International Book Festival YES YES YES YES YES
Edinburgh International Storytelling Festival YES YES YES YES YES
Edinburgh's Hogmanay YES YES YES YES YES
Access to Edinburgh Festival Fringe listings is subject to approval.