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

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

Returns all gigs related to the search query.

Parameters

ID (id=)
Returns a specific gig

Artists (artists=)
Inclusive and exclusive related artist filter (comma delimited)

  • string — Simple string search
  • string — MusicBrainz artist id (prefix mb:)
  • int — Gigulate artist id (prefix id:)

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 gigs by date or distance (distance works only when locale is applied)

  • string — Order by
    • "distance.closest" — Closest items first
    • "distance.furthest" — Furthest items first
    • "date.desc" — Date upcoming desc
    • "date.asc" — Date upcoming asc

Return

<api.gigulate version="1.0">
	<gigs.gigs total="[total items]">
		<gig id="[Gig ID]">
			<date>[Gig Date ISO8601]</date>
			<url>[Gig URL]</url>
			<artists total="[total artists]">
				<artist id="[Artist ID]" mbid="[MusicBrainz ID]">
					<name>[Artist Name]</name>
					<url>[Artist URL]</url>
				</artist>
				[...]
			</artists>
			<venue id="[Venue ID]">
				<name>[Venue Name]</name>
				<url>[Venue URL]</url>
				<address>[Venue Address]</address>
				<locale lon="[longitude]" lat="[latitude]" />
			</venue>
		</gig>
		[...]
	</gigs.gigs>
</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.