1. Listings API 2012
Guide for users v1

2. The API contains listings data for the Edinburgh festivals whose
listings data are publicly available at the time. The twelve
participating festivals in order of data being available on the
API are:
Imaginate Festival
Edinburgh International Science Festival
Royal Edinburgh Military Tattoo
Edinburgh International Film Festival
Edinburgh International Festival
Edinburgh Jazz&Blues Festival
Edinburgh Festival Fringe
Edinburgh Art Festival
Edinburgh Mela
Edinburgh International Book Festival
Edinburgh International Storytelling Festival
Edinburgh’s Hogmanay

3. Please visit festivalslab.com to
see the API schema & other
technical & usage info.
And similar to last year, access
to the API will work like this....

4. First of all you simply log on to register.festivalslab.com,
review the API usage licence terms and register your details.
This gives you Use Type A status and an API key with
automatic access to data from all available festivals apart
from the Fringe
The reason we have separated out the Fringe data is that as
you will see from the API licence, the Fringe data has
different terms of usage to that of the other festivals
The API key that you will have at this stage will however
include dummy Fringe data for development purposes.
Details of this is explained at api.festivalslab.com

5. So if you would like to also include the full,
live Fringe data to your existing API key
you will fall into one of two further user
types:
Press/media organisations approved by the
Fringe to have API access (Use Type B)
Users who want to use the API to develop
new applications or augment existing ones
(Use Type C)

6. If you are an approved press/media user,
access will be granted asap after
application
If you are an app developer please email
api@festivalslab.com and accesses will be
granted following successful approval of a
candidate app.
Details of this approval process is at
festivalslab.com

7. And remember, whatever type of user
you’ll be, PLEASE PLEASE make sure you
review the usage terms in the API licence.
Thanks ;)
And to help us with analytics, we are
requesting that you use one API key per
application. Therefore pls use a different
email address to register for more than
one key

8. Full details at festivalslab.com
Any questions to api@festivalslab.com
And thank you for your participation and
we’d appreciate your feedback