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 :

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:

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 :

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 :

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

music story

Forgot your password ?