Skiddle Events API

Please note, the Skiddle Events API is still in Beta and being developed. The API is for non-commercial use only. Any commercial use must be first approved in writing by emailing apps@skiddle.com

Getting Started!

The Skiddle Events API has been developed to follow RESTful principles where possible (and not overly complicated). The aim has been to create an API which is simple and intuative to use rather than following strict policies to the letter.

At present we don't have any client libraries available, but any REST library that allows you to specify the end-point can be used with this API.

Return Format

All results are returned in plain-text JSON format which is cross-platform compatable.

Authentication

All requests require a valid API key. To apply for a free apikey please Apply here.

To access the API you must specify your API KEY on all requests. This should be in the format 'api_key=abcdefghijklmnop'

We monitor all requests and reserve the right to rate-limit or block any excessive requests. Limits are continually changed - please contact us if you are expecting to hit our API frequently.

Events

Events search endpoint: http://www.skiddle.com/api/v1/events/ (method: GET) Gets multiple events based upon search parameters (see below)

Event details endpoint: http://www.skiddle.com/api/v1/events/12345/ (method: GET) Gets information for a single event

Event search parameters

Geographical:
latitude: (decimal, optional) Specify a latitude to find nearby events (eg 53.000)
longitude: (decimal, optional) Specify a longitude to find nearby events (eg -1.234)
radius: (decimal, optional) Find events within the specified miles radius (eg 10)
To use geo searching, all 3 of the above parameters must be specified

eventcode: (string, optional) Filter by type of event. Note the category is selected by the event promoter when submitting the event so can be subjective! Choose from:

FEST = Festivals
LIVE = Live music
CLUB = Clubbing/Dance music
DATE = Dating event
THEATRE = Theatre/Dance
COMEDY = Comedy
EXHIB = Exhibitions and Attractions
KIDS = Kids/Family Event
BARPUB = Bar/Pub event
LGB = Gay/Lesbian event
SPORT = Sporting event
ARTS = The Arts

minDate: (string,optional) Find events on or after this date. Format as YYYY-MM-DD

maxDate: (string,optional) Find events before or on this date. Format as YYYY-MM-DD

venueid: (integer,optional) Find events at a particular venue. See the venues search for details (as an integer)

b: (integer,optional) Find events attached to a particular brandID (eg Ministry of Sound). See the brands search for details

a: (integer,optional) Find events that a particular artistID is tagged to (eg Riva Starr). See the artsits search for details

order: (integer,optional) Specify sort order. Chose from:

0: (default) Date, featured, eventname
12: Date order, then eventname
2: Event Name then Date
3: Venue Name, then Event Name, then Date
4: Popularity (most popular first)
5: Best rated venues first

limit: (Integer, optional) Specify number of records returned (max 100, default 20)
offset: (Integer, optional) Specify record number to start at (for paging, in conjunction with limit, order) (default 0)

Venues

Venues search endpoint: http://www.skiddle.com/api/v1/venues/ (method: GET) Gets multiple venues based upon search parameters (see below)

Venue details endpoint: http://www.skiddle.com/api/v1/venues/12345/ (method: GET) Gets information for a single venue

Venue search parameters

Geographical:
latitude: (decimal, optional) Specify a latitude to find nearby venues(eg 53.000)
longitude: (decimal, optional) Specify a longitude to find nearby venues(eg -1.234)
radius: (decimal, optional) Find venues within the specified miles radius (eg 10)
To use geo searching, all 3 of the above parameters must be specified

type: (string,optional) Type of venue. Chose from: B= Bar/Pub
N= Nightclub
L = Live Music
O = Outdoor venue
T = Theatre
S = Sports ground
G = Gallery

limit: (Integer, optional) Specify number of records returned (max 100, default 20)
offset: (Integer, optional) Specify record number to start at (for paging, in conjunction with limit, order) (default 0)

Artists

Artists search endpoint: http://www.skiddle.com/api/v1/artists/ (method: GET) Gets multiple artists based upon search parameters (see below)

Artist search parameters

name: (string,optional) Name of artist to search for

venueid: (integer,optional) Find artists playing at a particular venue. See the venues search for details (as an integer)

b: (integer,optional) Find artists playing for a particular brandID (eg Ministry of Sound). See the brands search for details