API Documentation

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

Edinburgh is the world’s favourite Festival city with over 43,000 performances taking place across the 11 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 11 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 Listings Widget

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

Festival listings widget

Festival 2012 - 2018 2019 Notes
Edinburgh International Children's Festival YES YES
Edinburgh Science Festival YES YES
Royal Edinburgh Military Tattoo YES YES
Edinburgh International Film Festival YES YES
Edinburgh International Festival YES YES
Edinburgh Jazz & Blues Festival YES YES
Edinburgh Festival Fringe YES YES
Edinburgh Art Festival YES YES
Edinburgh International Book Festival YES YES
Edinburgh International Storytelling Festival YES YES
Edinburgh's Hogmanay YES YES
Access to Edinburgh Festival Fringe listings is subject to approval.