| Lemonrock Gig Listings API | |
The Lemonrock Gig Listings API enables you to provide links on your own web site to gigs in any UK town. When your link is clicked, the user is taken to the Lemonrock site, and a page of gigs is shown, based on the parameters in your link. You can specify a distance around the town in miles, and the number of days ahead to include in the listings.
Your link must contain at least a town name, along with either the postcode or the county name. If neither postcode nor county name is supplied with the town name, the correct page may not be shown.
URL
http://www.lemonrock.com/gigs.php
HTTP GET parameters
town
parameter name: town
inclusion: mandatory (or optional, if postcode is specified - see below)
details: URL encoded town/city name, e.g. Abbots%20Langley or St%20Albans
postcode
parameter name: pc
inclusion: optional (or mandatory, if town is not specified - see above)
details: URL encoded postcode, e.g. WD5%200NF or AL1. The postcode must match the town.
Note: You may specify the postcode only, without a town name or county name. However, the page shown may not match your intended town, as some towns have the same postcode (see note on postcodes below).
county
parameter name: county
inclusion: optional
details: URL encoded county, e.g. Herts or County%20Durham. The county must match the town.
Note: specifying either pc or county in addition to the town makes the town unambiguous, and is the recommended method.
miles
parameter name: miles
inclusion: optional
details: set to a numeric value between 5 and 30 (from the following values: 5, 6, 7, 8, 9, 10, 12, 14, 16, 18, 20, 25, 30, 40, 50). Selects the radius around the specified town.
default: 10
days
parameter name: days
inclusion: optional
details: set to the number of days of listings required (1 = today only, 7 = one week (actually 8 days), 14 = two weeks (actually 15 days)).
default: 7
Notes
Towns such as St Albans, St Andrews, etc, do not have full stops (e.g. St. Albans)
Postcodes: Lemonrock uses only the first part of the postcode, so cannot differentiate between towns using the postcode alone. Postcodes can be complete, or partial; however, Lemonrock uses only the first part, before the space.
Parameters are not case sensitive (st%20albans and St%20Albans are treated as identical).
When the user arrives at the Lemonrock site, they will be sent a cookie, as part of the listings page. This enables Lemonrock to remember their search settings. However, the links from your site will still work if cookies from Lemonrock are not accepted by the user's browser.
Examples
1. http://www.lemonrock.com/gigs.php?town=Exeter&days=14
(note: this works because there is only one Exeter)
2. http://www.lemonrock.com/gigs.php?pc=WD2%200NF&town=Abbots%20Langley
(note: days defaults to 1 week, miles defaults to 10)
3. http://www.lemonrock.com/gigs.php?town=Watford&county=Herts&miles=8
HTML link examples
To link to the Lemonrock gig guide for a particular town, you must use the <a> (anchor) tag, e.g.:
<a href="http://www.lemonrock.com/gigs.php?town=hove&pc=BN3%207TR">Gigs in Hove</a>
will produce the following link on your own site:
Gigs in Hove
|
