WelshGigs Logo

API

We have a few methods for you to show our data on your own website, app or program. For websites and apps we have an easy to use javascript library. All you need to do is include a few lines of code and you can show data formatted to your design as if its coming from your own website.

If you want to include the gig guide on your website please email me for help

Javascript

With a few small lines of code you could include the welshgigs gig guide on your website or app. You can show the list with a number of options or limits:

  • Full list
  • Single venue (limit to show gigs for only your venue) - Great if you are a venue
  • Limited date ranges (even show historic events)

Simple

Without any options, calling the gig guide is only three lines. Place these lines on your page where you would like the guide to appear.

<div id="wg_gigguide"></div> <script src="//www.welshgigs.com/api/v2/api.js"></script> <script>gigGuide();</script>

Options

You can pass options to the javascript function via an array with the details in the table below

Option Meaning Values Default
venue The unique ID for the venue - the gig guide will only show gigs for that venue Interger
time Show the door times (if avaliable) true / false true
price Show the ticket prices (if avaliable) true / false true
dateFormat Format the date different to eg. Sunday 18th January See dates table below l jS F

Dates

The dafe format should be within single quotes as the full example below shows

Letter Meaning Example
l A full textual representation of the day of the week Sunday through Saturday
D A textual representation of a day, three letters Mon through Sun
j Day of the month without leading zeros 1 to 31
S English ordinal suffix for the day of the month st, nd, rd or th. Works well with j
F A full textual representation of a month January through December
n Numeric representation of a month, without leading zeros 1 through 12
Y A full numeric representation of a year, 4 digits 1999 or 2003
y A two digit representation of a year 99 or 03

Making it fit your design

The gig guide is within a table structure. The main container has an id of "wg_gigguide". Using CSS you can style the guide to match your own website.

Including the code on your page will format the table as shown under the full example.

<style> #wg_gigguide table td a { color:#22F; } </style>

Full example

You can try the code yourself and see what it does before putting it on your website

<style> #wg_gigguide table td a { color:#22F; } </style> <div id="wg_gigguide"></div> <script src="//www.welshgigs.com/api/v2/api.js"></script> <script> var options = [ ['venue',2274], ['time',true], ['price',true], ['dateFormat','l jS F'], ]; gigGuide(options); </script>

Output

JSON

The WelshGigs JSON API is currently offline. We are working on it and will post here when it is back online.