fr
 

Differences from Musiclist2ApiFields:17 (red) to Musiclist2ApiFields:18 (green)

You can rollbackto Musiclist2ApiFields:17
**jamendo.get2** : [[Musiclist2Api|Home]] | [[Musiclist2ApiTutorial|Crash course]] | [[Musiclist2ApiUsefulQueries|Useful queries]] | [[Musiclist2ApiFormats|Formats]] | [[Musiclist2ApiParameters|Parameters]] | [[Musiclist2ApiFields|Fields]] | [[Musiclist2ApiOrders|Orders]] | [[Musiclist2ApiJoins|Joins]]

== Fields/Unit availability ==


|=Fields / Units|=album|=artist|=license|=playlist|=review|=tag|=track|=user|=location|
|=id|Y|Y|Y|Y|Y|Y|Y|Y|Y|
|=idstr|N|Y|N|N|N|Y|N|Y|N|
|=name|Y|Y|N|Y|Y|Y|Y|Y|N|
|=url|Y|Y|Y|Y|Y|Y|Y|Y|N|
|=image|Y|Y|Y|N|N|N|Y|Y|N|
|=dates|Y|Y|N|Y|Y|N|Y|Y|N|
|=text|N|N|N|N|Y|N|Y|N|N|
|=ahref|same as url|||||||||
|=ahrefidstr|same as url+idstr|||||||||
|=ahrefname|same as url+name|||||||||



=== **unit artist** ===
| **targets** | **description** | **examples** |
| id | numeric id of the artist | Both : 5, Madame Olga : 2464
| idstr | string id of the artist | Both : both, Madame Olga : madameolga
| name | Display name of the artist. different of idstr | "Both", "Madame Olga"
| image | link to the image of the artist | Both : {{{http://img.jamendo.com/artists/b/both.jpg}}}, Madame Olga : {{{http://img.jamendo.com/artists/m/madameolga.jpg}}}
| url | link to the page of the artist on Jamendo | Both : {{{http://www.jamendo.com/artist/both}}}
| mbgid | String id of the artist on MusicBrainz | Both : {{{0781a3f3-645c-45d1-a84f-76b4e4decf6d}}}
| mbid | Integer id of the artist on MusicBrainz | Both : 263632
| genre | Description of the artist (written by the artist) | "Both" : "Eclectick Rock", "Madame Olga" : "Fusion-Rock-Electro"

=== **unit album** ===
| **targets** | **description** | **examples** |
| id | numeric id of the album | "Simple Exercice" : 33
| name | name of the album | "Simple Exercice"
| image | link to the cover of the album | "Simple Exercice" : {{{http://img.jamendo.com/albums/33/covers/1.100.jpg}}}
| url | link to the page of the album on Jamendo | "Simple Exercice" : {{{http://www.jamendo.com/album/33}}}
| duration | Total length of the album (in seconds) | "Simple Exercice" : 1586 (seconds)
| genre | Description of the album (written by the artist) | "Simple Exercice" : "Rock éclectique"
| datedates | array of dates, contains date of publication (upload), date of validation, and date of release | "Simple Exercice" : "validation":"2005-05-20T12:36:20+01",\\ "release":"2004-12-28T18:46:23+01","public":"0000-00-00", "year":"2005"

=== **unit playlist** ===
| **targets** | **description** | **examples** |
| id | numeric id of the playlist | 32582
| name | name of the playlist | "Playlists2007_iLikeIt"
| duration | length of the playlist (in seconds) | "Playlists2007_iLikeIt" : 310 (seconds)


=== **unit track** ===
| **targets** | **description** | **examples** |
| id | numeric id of the track | "Tout se passera bien" : 108254
| name | name of the track | "Tout se passera bien"
| duration | length of the track (in seconds) | "Tout se passera bien" : 310 (seconds)

=== **unit tag** ===
| **targets** | **description** | **examples** |
| id | numeric id of the tag | "rock" : 23
| idstr | name of the tag | "rock"
| weight | weight of the tag. \\ **this target is available only if you use a tag-related relation \\ like artist_tag, album_tag,...** | number between 0 and 1


=== **unit License** ===
| **targets** | **description** | **examples** |
| id | numeric id of the license (according to our database) | "{{{http://creativecommons.org/licenses/by-nc-nd/2.0/fr/}}}" : 49
| class | class of the license | 4 possible values : "artlibre", "cc_standard", "cc_recombo", "multiple"
| url | url of the license | "{{{http://creativecommons.org/licenses/by-nc-nd/2.0/fr/}}}"



=== **unit user** ===
| **targets** | **description** | **examples** |
| id | numeric id of the user |
| idstr | string id of the user (its login) | "pierrotsmnrd"
| name | name of the user | "Pierre-Olivier"
| lang | lang of the user | "fr", "en", "sv",...
|image | url of the avatar of the user | {{{http://img.jamendo.com/avatars/89/4089.100.jpg}}}
| dates | array containing the date of inscription of the user | "pierrotsmnrd" : 2005-08-30T19:50:36+01

=== **unit review** ===
| **targets** | **description** | **examples** |
| id | numeric id of the review | 59231
| name | title of the review | "this album is wonderful !!"
| text | text of the review | "yes, really, this album is wonderful"
| rating | rating of the review | number between 0 and 10
| lang | lang the review is written in | "fr", "en", "sv",...
| dates | array containing the date when the review has been added, and when it has been updated for the last time | "2005-08-30T19:50:36+01"