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

• int — Venue ID (see also: gigs.venues)

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>