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

news.group

http://api.gigulate.com/1.0/news.group

Returns news stats of grouped data. Good for building graphs etc.

Parameters

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

Keywords (q=)
Inclusive and exclusive string filter of title and content of story (comma delimited)

  • string — Simple string search

Sources (sources=)
Inclusive and exclusive string filter of sources (comma delimited)

Authority (authority=)
Show all or only authoritative news articles

  • string — Authority of news article
    • "none" — Any news article
    • "featured" — Articles that have been deemed important according to the Gigulator

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

Group by (group=)
What time frequency to group the data together?

  • string — How to group the data
    • "day" — Group stories by day
    • "week" — Group stories by week
    • "month" — Group stories by month

Return

<api.gigulate version="1.0">
	<news.group total="[total grouped items related to this api query]">
		<group>
			<date.from>[Grouped Time Start]</date.from>
			<date.to>[Grouped Time End]</date.to>
			<total>[total items]</total>
		</group>
		[...]
	</news.group>
</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?

Find all the bands everybody is talking about in news and blogs. Then see them live. Faster.

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