API Documentation.
This page describes what information our APIs return, and how to retrieve it. To review the API Terms of Use and apply for a client API key, go to our Developer API page.
Please review whether the API returns all the information you require. For example, images are not provided.
Event Search API.
Search for upcoming events. If no parameters are passed, then all the upcoming events will be returned. To improve response time, please use a combination of the parameters to retrieve only the desired events.
Parameters.
Request Examples.
Response Example.
Note, start time and end time are only possible for live streams. It isn't possible to have an end time without having a start time.
b2bInd indicates whether that artist is performing back to back with the next artist in the list. Any number of artists may perform b2b e.g. 3 artists. The same artist may perform in multiple b2b's for the same event.
Nearby Events API.
Find upcoming events that are nearby the provided latitude, longitude, and state. If the provided coordinates are not near a supported country, then all festivals and all live streams will be returned.
Parameters.
Request Examples.
Response Example.
See the above response example for Event Search API.
Locations API.
Retrieves information about the specified location. If the city/state parameters are not supplied, then all the popular locations will be returned (same locations that are used in Edmtrain's location dropdowns).
Parameters.
Request Examples.
Response Example.
API Errors.
If an error occurs, then the success attribute will be set to false. The message attribute will indicate the type of error.
Response Example.
locations?state=fake&client=...