If you want to access our extensive database of events then the Evently API is for you! Integrate our API easily into your website or application and start building cool products with our events data.
Find out how the API works and start adding Evently events to your website.
What is the Evently API?
The Evently API allows website owners to add Evently events content to their website. Evently events data comes from some of the industry's top venues and promoters. We give you access to over 1,000 unique event listings each month. You can use our API to display events by genre, venue or even geographic location.
1. Technical Details
Our API is accessible via HTTP, is RESTful, and offers both JSON and XML response formats (find the schemas below). All data responses are UTF-8 encoded.
You must pass your API key as a parameter to every request you make.
Only details on future events are available.
Times and dates are provided in UTC timezone and are in in ISO 8601 format.
We use a combination of IDs and UUIDs to identify resources. Genres have an ID, whereas Events and Venues have UUIDs.
When accessing the API you will need to provide your API key. You can do this via a GET parameter like so:
Or if you prefer, you can pass the API key within the Authorization header.
We can render responses for you using JSON or XML.
In order to specify your choice of response format you can append .json or .xml to the request path like so:
GET http://api.event.ly/v3/events.json GET http://api.event.ly/v3/events.xml
You can pass a format parameter along with your GET request:
GET http://api.event.ly/v3/events?format=json GET http://api.event.ly/v3/events?format=xml
Or you can use an Accept header.
Results are returned 100 elements at a time. To get subsequent elements use the page parameter as follows:
Pagination is enabled on all API resources.
Pagination usage example: Get the first 300 venues in London as JSON (remember to add your API key):
GET http://api.event.ly/v3/venues/search.json?city=London GET http://api.event.ly/v3/venues/search.json?city=London&page=2 GET http://api.event.ly/v3/venues/search.json?city=London&page=3
How to fetch the event data you want
You can fetch event data from our API based on Genre, Venue or even geographic location.
2. How to fetch events by genre
Method: Events by genre ID
You can fetch the available genres and their associated ID using the following endpoint:
Which returns a list of all genres.
Example Response containing all genres
Use the genre ID to return all future events of a particular genre (in pages of 100) as XML
Required parameters: genreid and apikey
Optional parameters: page (Page of result you wish to look at. 100 events per page. Defaults to page 1)
Allowed values: Positive integers - a HTTP 204 Status code will be returned if the page contains no venues.
3. How to fetch events by venue
First you need to find the venue UUID you're interested in.
You can search for a venue by longitude and latitude, and by the presence of a word in any or all Venue fields.
Method: Venue search by field
To find any venue in north-west London with a name that contains Jazz.
To find any venue with a postcode that contains the word EC2.
To find any venue with the string "Chocolate Rain" anywhere in it's address or name (note, parameters need to be URL encoded).
Available search parameters
4. Getting a specific venue by it's UUID
GET /v3/venues/<venue-UUID> Returns a single venue by its UUID.
Example venue response
5. Other available endpoints
GET /v3/events Returns the next 100 events. Events in the past will not be returned by default but can always be found by visiting an event directly.
6. Example Event Usage
Get the first 100 events at Purple Turtle as JSON (remember to add your API key):