API calls‎ > ‎

/reviews

Retrieve reviews of an artist, album or source

/reviews/{entity}.{format}?{parameters}
/reviews/{entity}/{mbid}.{format}?{parameters}
/reviews/sources/{name}.{format}?{parameters}


Explanation of the fields:

Field
 		Values
 		Description
 		Optional?
entity
artists, albums or sources
Get reviews of artists, albums or sources
n

mbid

[0-9a-z-]{36}

ID of the Artist or album from MusicBrainz. Only used when entity is artist and album

f.e. 0c751690-c784-4a4f-b1e4-c1de27d47581

y
name
[a-z0-9]+
The name of the source, url encoded
n
format
 		xml, json
 		This will be the returned format.
 		n
parameters
 		See below in Available parameters Parameters which can be added only through GET.
 		y


Available parameters:

Name Value Description
max [0-9]+ Maximum number of weblinks to display (default = 20)
callback [a-zA-z0-9_]+ Callback function which is used in JSONp
page
[0-9]+
What page number? (default = 1)
lang
[a-z,]+
The language of the reviews shown (nl,en,de,dk,...)
Multiple languages can be fetched by using them with comma separation (en,de). Default is all available languages


Examples of URLs:

All latest reviews:
http://api.cloudspeakers.com/2.0/reviews/artists.xml
All reviews of artist Coldplay in XML, only english reviews:
http://api.cloudspeakers.com/2.0/reviews/artists/cc197bad-dc9c-440d-a5b5-d52ba2e14234.xml?lang=en
All reviews of album of Coldplay: Viva la Vida or Death and All His Friends in XML, only dutch and english reviews:
http://api.cloudspeakers.com/2.0/reviews/albums/10c38900-3f35-4a09-a9cc-5c44ee2da0ed.xml?lang=en,nl
All reviews of source De:Bug in json:
http://api.cloudspeakers.com/2.0/reviews/sources/de-bug.json
Comments