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!
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.

Explore

About

What's Gigulate?

  • Sorted. Music news at hyperspeed.
  • The sharpest music minds plugged into the world's greatest music machine.
  • Find out more