Genre

Music genre

Description

A music genre (rock, jazz, punk rock,...).
It can be a global genre (12 global genres such as rock, jazz...) or a more detailed genre (sub-genre including Electro-pop, Free jazz...). Genres are all related to each other. One may have a parent, and/or a subgenre, etc.
If a genre don't have a parent genre, it is considered as global genre, for example: Rock, Electro,... The main field will be set to 1 if it is a global genre, 0 otherwise.

Example :
Get the classical music genre
http://api.music-story.com/en/genre/28

Fields

Name	Description	Facultatively	Type	Restriction
id	Unique ID	no	int	Unlimited
name	Name	no	string	Unlimited
url	Music Story url	no	string	Unlimited
main	Description	no	boolean	Unlimited
update_date	Last update date	no	date	Unlimited
create_date	Database entry date	no	date	Unlimited

Connectors

Name	Description	Returns
search	Action of researching	A list of Genres
genres	Genres associated to a genre	A list of Genres
artists	Artists belonging to a genre	A list of Artists
news	News associated to a genre	A list of News
timeline	Timelines associated to a genre	A list of Timeline
releases	Releases associated to a genre	A list of Releases
news	Albums related to a genre	A list of Albums
youtubechannel	Youtube channels related to a genre	A list of YoutubeChannels
youtube	Youtube videos related to a Genre	A list of Youtube
recordings	Retrieves the recordings of the Genre	A list of Recording

Searching for genres

Example :
Search genres whose name begins with "Rock"
http://api.music-story.com/en/genre/search?name=Rock

genres

Gathers the genres associated to a genre
Links between genres can take following values :

Parent : Another genre is an influence of a genre
Children : Another genre is a succesor of a genre

Added fields	Description	Facultatively	Type	Restriction
link	Type of links between genres	no	"Parent"/"Children"	Unlimited

Example :
Search genres equality at Rock
http://api.music-story.com/en/genre/1/genres

artists

In order to gather the list of artists linked to the current genre, the link can be:

Main : Genre is a global genre ot an artist (only majors like rock for example)
Principal : Genre is main genre of an artist
Secondary : Genre is secondary genre of an artist
Influence : Genre is an influence for an artist
Must : Artist is a "must" in a genre

Added fields	Description	Facultatively	Type	Restriction
link	Type of link between artist and genre	no	"Main"/"Principal"/"Secondary"/"Influence"/"Must"	Unlimited

Example :
Search artists who are equality in rock genre
http://api.music-story.com/en/genre/1/artists

news

Gathers the news associated with the current genre

Example :
Search news associated to the rock genre
http://api.music-story.com/en/genre/21/news

timeline

Gathers the news associated with the current genre

Example :
Search timeline associated to the rock genre
http://api.music-story.com/en/genre/21/timeline

releases

Gathers releases associated with the current genre

Links between releases and genre can take the following values :

Main : Genre is global genre of a release
Principal : Genre is main genre of a release
Must : Release is a "must" for a genre

Added fields	Description	Facultatively	Type	Restriction
link	Type of link between release and genre	no	"Main"/"Principal"/"Must"	Unlimited

Example :
Search versions of album classified in the rock genre
http://api.music-story.com/en/genre/1/releases

albums

Gathers albums associated with the current genre

Links between releases and album can take the following values :

Main : Genre is global genre of an album
Principal : Genre is main genre of an album
Must : Album is a "must" for a genre

Added fields	Description	Facultatively	Type	Restriction
link	Type of link between album and genre	no	"Main"/"Principal"/"Must"	Unlimited

Example :
Search albums classified in the rock genre
http://api.music-story.com/en/genre/1/albums

youtubechannel

Gets Youtube channels associated with the current genre

Example :
Search Youtube Channels associated to the rock genre
http://api.music-story.com/en/genre/1/youtubechannel

youtube

Gets YouTube videos associated with the current genre

Example :
Search Youtube videos associated to the rock genre
http://api.music-story.com/en/genre/5/youtube

recordings

Gathers the recordings of the Genre

Example :
Search of the recordings linked to the genre Pop
http://api.music-story.com/en/genre/5/recordings