Review

An album review and rating

Description

Album's review and/or quotation, from Music Story or from others specialized medias.
Initially from main french music magazines.

A review may not have any text in the "content" field if only a "rate" is assigned to the album.
In the same way, an album review can only have a text without rate.

IMPORTANT :
For publication of reviews from a third part media you must ask for an authorization.
Music Story gives a technical access to these contents and decline all responsabilities regarding their publication.

Example :
Fetches the review with the ID 1800
http://api.music-story.com/en/review/1800

Fetches the review with the ID 66362392
http://api.music-story.com/en/review/66362392

Sources

Name	Description	Maximum rating	Restriction	Language
Music Story	Review and rating from Music Story editorial team. No genre restriction. General process of main relases of the week. "Editorial" access restriction including pubilcation rights.	5	Editorial	French
Télérama	Review and rating from Télérama, cultural magazine (telerama.fr). Generalist editorial line.	4	None	France
Les Inrocks	Review and rating from Les Inrocks, cultural magazine and news (lesinrocks.com). Generalist editorial line with alternative rock focuses.	5	None	France
Magicrpm	Review and rating from specialized magazine Magic (magicrpm.com). Indie pop-rock editorial line.	6	None	France
Diapason Mag	Prestigious rating "Diapason d'or" from specialized Diapason magazine (diapasonmag.fr). No available review	1	None	France
Metal Obs	Review and rating from specialized magazine Metalobs (metalobs.com). Metal editorial line	5	None	France
Trax	Review from specialized magazine Trax (traxmag.fr). Electro editorial line. No rating available		None	France

Fields

Name	Description	Facultatively	Type	Restriction
id	Unique ID	non	int	Editorial
id_source	Source ID	non	int	Editorial
rate	Album rate	non	double unsigned	Editorial
max_rate	Source maximum rate	non	int	Editorial
percent_rate	Rate converted into percent	non	int	Editorial
content	Review text	non	string	Editorial
linked_content	Review text with links if available	non	string	Editorial
source	Source	non	string	Editorial
lang	Language of content	non	"FR"/"EN"	Editorial
country	Country of content	non	string	Editorial
url	Link to the review	non	string	Editorial
author	Review author	non	string	Editorial
copyright	Copyright of the review	non	string	Editorial
licence	Licence of the review	non	string	Editorial
update_date	Last update	non	date	Editorial
creation_date	Date of creation	non	date	Editorial

Connectors

Name	Description	Returns
search	Searching for Reviews	A list of Review
artists	Gathers artists associated to a review	A list of Artists
album	Displays the album concerned by the review	A list of Albums
releases	Releases associated to a review	A list of Releases

Searching for Reviews

Example :
Search for reviews from Music Story
http://api.music-story.com/en/review/search?source=Music%20Story

artists

Gathers artists associated to a review.
Links between artists and review can take following values :

Main : Album reviewed is from the artist
Mentioned : Artist is mentioned in review

Added fields	Description	Facultatively	Type	Restriction
link	Type of link between reviews and artists	no	'Main'/'Mentioned'	Unlimited

Example :
Gathers the artists associated with the reivew with the ID 1800
http://api.music-story.com/en/review/1800/artists

album

Displays the album concerned by the review

Example :
Fetches the album concerned by the review with the ID 1800
http://api.music-story.com/en/review/1800/album

releases

Releases associated to a review

Example :
Gathers the album versions concerned by the review with the ID 1800
http://api.music-story.com/en/review/1800/releases