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

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.

Explore

About

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.
  • Find out more