Get a free Gigulate account now Login Signup
×

Join Gigulate,
it's free!

Start tracking your favourite bands and get access to automagical music news, blogs & gigs!
or login

gigs.venues

http://api.gigulate.com/1.0/gigs.venues

Returns related venues to search.

Parameters

ID (id=)
Returns a specific venue

Timeband (time=)
Two dates to filter articles between. Accepts unix timestamp and ISO 8601 formatted date strings.

  • string — 2 timestamps (comma delimited) of time band

Limit (limit=)
Limit the number of items that appear within the output. If there is a comma it starts as an offset. E.g. 50,100: Show 50 results, but start from the 100th result.

  • string — Default of 25, max of 100

Venues (venues=)
Inclusive and exlcusive related venue filter (comma delimited).

Locale (locale=)
Filter stories according to longitude and latitude. [distance] is radius in km

  • string — [lon],[lat],[distance]

Order by (order=)
Order the venues by date or distance (distance works only when locale is applied)

  • string — Order by
    • "distance.closest" — Closest items first
    • "distance.furthest" — Furthest items first
    • "name.desc" — Venue Name alphabetical desc
    • "name.asc" — Venue Name alphabetical asc

Return

<api.gigulate version="1.0">
	<gigs.venues total="[total items]">
		<venue id="[Venue ID]">
			<name>[Venue Name]</name>
			<url>[Venue URL]</url>
			<address>[Venue Address]</address>
			<locale lon="[longitude]" lat="[latitude]" />
		</venue>
		[...]
	</gigs.venues>
</api.gigulate>

Get a API key

You need to have a free Gigulate account in order to apply for a Gigulate API key.

What's Gigulate?

Hype bands? Never heard of 'em? Find out who's talking about the hottest bands before you head to the gig.

The sharpest music minds plugged into the world's greatest music machine.