Music-Story (2.0.0)

Music Story Technical Support: webmaster@music-story.com

This documentation doesn't provide a way to test our API. In order to facilitate testing, we recommend the following tools:

cURL (recommended, command-line)
ReqBIN (recommended, online)
Postman
Insomnia

Artists

All endpoints to get artists data

/api/artist

Search Music Story artist

Authorizations:

Bearer

query Parameters

query	string Name or ID of Artist to search
page	integer >= 1 Default: 1 Page number
isni	string ISNI to filter results
musicbrainz_id	string Musicbrainz ID to filter results
spotify_id	string Spotify ID to filter results
deezer_id	string Deezer ID to filter results
napster_id	string Napster ID to filter results
qobuz_id	string Qobuz ID to filter results
apple_id	string Apple Music ID to filter results
sevendigital_id	string 7Digital ID to filter results
wikidata_id	string Wikidata ID to filter results

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the artist

name

required

string

Dataset: Basic
Full name of the artist

isni

string

Dataset: Basic
ISNI of the artist

real_firstname_lastname

string

Dataset: Basic
Real name of the artist

type

required

string

Enum: "Person" "Band"

Dataset: Basic
Type of artist

gender

string

Enum: "Male" "Female"

Dataset: Basic
Gender of the artist

main_role

number

Deprecated

Dataset: Basic
ID of the main role of the artist

country_name

string

Dataset: Basic
Name of the artist’s country

country_code

string

Dataset: Basic
Two-letter code of the artist’s country, following the ISO 3166-1 alpha-2 standard

influence_country_name

string

Dataset: Basic
Name of the country that influenced the artist the most

influence_country_code

string

Dataset: Basic
Two-letter code of the country that influenced the artist the most, following the ISO 3166-1 alpha-2 standard

birth_date

string

Dataset: Bio
Artist’s date of birth, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

debut_date

string

Dataset: Bio
Artist’s debut date, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

birth_place

string

Dataset: Bio
Artist’s place of birth

Array of objects

Dataset: Bio
Array containing the artist’s activity periods

Array

start_date required	string Dataset: Bio Start date with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
end_date	string Dataset: Bio End date with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

death_date

string

Dataset: Bio
Artist’s date of death, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

death_place

string

Dataset: Bio
Artist’s place of death

Array of objects

Dataset: Basic (Main genre only) / Reco (Other genres)
Array containing the artist’s genres

Array

id_genre required	number Dataset: Basic (Main genre only) / Reco (Other genres) ID of the genre
name required	string Dataset: Basic (Main genre only) / Reco (Other genres) Name of the genre
link required	string Enum: "Main" "Principal" "Secondary" "Influence" Dataset: Basic (Main genre only) / Reco (Other genres) Relation type

Array of objects

Dataset: Basic (Main role only) / Reco (Other roles)
Array containing the artist’s roles

Array

id_role required	number Dataset: Basic (Main role only) / Reco (Other roles) ID of the role
name required	string Dataset: Basic (Main role only) / Reco (Other roles) Name of the role
link required	string Enum: "Main" "Other" Dataset: Basic (Main role only) / Reco (Other roles) Relation type

Array of objects

Dataset: Basic
Array containing the artist’s aliases

Array

alias required	string Dataset: Basic Alias
link required	string Enum: "Alias" "Nickname" Dataset: Basic Type of alias

Array of objects

Dataset: Basic
Array containing the artist’s translated names

Array

lang required	string Dataset: Basic Language of the translated name, following ISO-639 standard
name required	string Dataset: Basic Name of the artist in other languages

Array of objects

Dataset: Associate
Array containing the band members

Array

id_artist required	number Dataset: Associate ID of the band member
name_artist required	string Dataset: Associate Name of the band member
start_date	string Dataset: Associate Date at which the artist became a band member, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
end_date	string Dataset: Associate Date at which the artist stopped being a band member, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
id_role required	number Dataset: Associate ID of the band member’s role
name_role required	string Dataset: Associate Name of the band member’s role

Array of objects

Dataset: Reco
Array containing the related artists

Array

id_artist required	number Dataset: Reco ID of the related artist
name required	string Dataset: Reco Name of the related artist
link required	string Enum: "Related" "Successor" "Influence" Dataset: Reco Relation type

Array of objects

Dataset: Associate
Array containing the artist’s collaborators

Array

id_artist required	number Dataset: Associate ID of the collaborator
name_artist required	string Dataset: Associate Name of the collaborator
start_date	string Dataset: Associate Date of the start of the collaboration, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
end_date	string Dataset: Associate Date of the end of the collaboration, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
id_role required	number Dataset: Associate ID of the collaborator’s role
name_role required	string Dataset: Associate Name of the collaborator’s role

object

Dataset: Basic
Object containing external links related to the artist

tiktok	string Dataset: Basic Link to the artist’s Tiktok pages
twitter	string Dataset: Basic Link to the artist’s Twitter pages
website	Array of strings Dataset: Basic Array containing link to the artist’s websites
youtube	string Dataset: Basic Link to the artist’s Youtube channels
facebook	string Dataset: Basic Link to the artist’s Facebook pages
instagram	string Dataset: Basic Link to the artist’s Instagram pages
soundcloud	string Dataset: Basic Link to the artist’s Soundcloud pages

object

Dataset: Basic / External
Object containing the IDs of the artist in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz artist IDs
discogs	Array of numbers Dataset: Basic Array of Discogs artist IDs
spotify	Array of strings Dataset: External Array of Spotify artist IDs
deezer	Array of numbers Dataset: External Array of Deezer artist IDs
napster	Array of strings Dataset: External Array of Napster artist IDs
qobuz	Array of numbers Dataset: External Array of Qobuz artist IDs
apple	Array of numbers Dataset: External Array of Apple Music artist IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital artist IDs
linemusic	Array of strings Dataset: External Array of Linemusic artist IDs
wikidata	Array of strings Dataset: Basic Array of Wikidata artist IDs

famous_for

string

Dataset: Bio
Blurb describing why the artist is well known

awards

string

Dataset: Bio
Blurb listing the awards won by the artist

score

number

Score related to the search

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 23,
"name": "Paul McCartney",
"isni": "0000000121452530",
"real_firstname_lastname": "James Paul McCartney",
"type": "Person",
"gender": "Male",
"main_role": 13,
"country_name": "United Kingdom",
"country_code": "GB",
"influence_country_name": "United States",
"influence_country_code": "US",
"birth_date": "1942-06-18",
"debut_date": null,
"birth_place": "Liverpool,Mersey,England",
"activity_periods": [ ],
"death_date": null,
"death_place": null,
"genres": [{"id_genre": 1,
"name": "Rock",
"link": "Main"
}
],
"roles": [{"id_role": 1,
"name": "Songwriter",
"link": "Main"
}
],
"aliases": [{"alias": "Macca",
"link": "Nickname"
}
],
"translated": [{"lang": "AR",
"name": "بول مكارتني"
}
],
"band_members": [{"id_artist": 4746038,
"name_artist": "Paul & Linda McCartney",
"start_date": "1970-00-00",
"end_date": "1971-00-00",
"id_role": 13,
"name_role": "Singer"
}
],
"related_artists": [{"id_artist": 1,
"name": "George Harrison",
"link": "Related"
}
],
"collaborators": [{"id_artist": 4678361,
"name_artist": "John Wilson",
"start_date": "2011-00-00",
"end_date": "2011-00-00",
"id_role": 28,
"name_role": "Conductor"
}
],
"socials": {"tiktok": "https://www.tiktok.com/@paulmccartney",
"twitter": "https://twitter.com/PaulMcCartney",
"website": ["www.myspace.com/paulmccartney",
"www.paulmccartney.com",
"www.maccablog.com"
],
"youtube": "http://www.youtube.com/channel/UCvGnJy9RnXX0kGSnDPKCZzQ",
"facebook": "https://www.facebook.com/PaulMcCartney",
"instagram": "http://www.instagram.com/paulmccartney",
"soundcloud": "http://soundcloud.com/paulmccartney"
},
"externals": {"musicbrainz": ["ba550d0e-adac-4864-b88b-407cab5e76af"
],
"discogs": [35301,
995958,
3253856
],
"spotify": ["1UwUZoxDZNxM95ZpbJVUFO",
"1ZxqBJi6JF52YRDWAVJouM",
"2EAtt67svsoTgSFKdEOo3x",
"2RXViBJHDxEj0x6Mtxw1PI"
],
"deezer": [1446
],
"napster": ["956",
"35290773",
"267868678"
],
"qobuz": [35554
],
"apple": [1702764711,
1702764661,
524268715
],
"sevendigital": [803265
],
"linemusic": ["mi000000000006ae70",
"mi000000000016d1c7"
],
"wikidata": ["Q2599"
]
},
"famous_for": "As one quarter of The Beatles and for selling 100 million singles, making him the most successful composer and musician in popular music history",
"awards": "Academy Awards: Best Original Or Adaptation Score for 'Let It Be' with The Beatles (1971); BRIT Awards: British Album of the Year for 'Sgt. Peppers Lonely Hearts Club Band' with The Beatles (1977); British Group with The Beatles (1977); Outstanding Contribution to Music (1977; 1983; 2008); British Male Solo Artist (1983); Album of the Year for 'Ecce Cor Meum' (2007); Grammy Awards: Best New Artist with The Beatles (1965); Best Performance By a Vocal Group for 'A Hard Day's Night' with The Beatles (1965); Song of the Year for 'Michelle' with The Beatles (1967); Album of the Year for 'Sgt. Peppers Lonely Hearts Club Band' with The Beatles (1968); Best Historical Album for 'Band On the Run' (2012); Knighthood (1997)",
"score": "1"
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

/api/artist/{id}

Get Music Story artist

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Artist

Responses

Response Schema: application/json

required

number

Dataset: Basic
ID of the artist

name

required

string

Dataset: Basic
Full name of the artist

isni

string

Dataset: Basic
ISNI of the artist

real_firstname_lastname

string

Dataset: Basic
Real name of the artist

type

required

string

Enum: "Person" "Band"

Dataset: Basic
Type of artist

gender

string

Enum: "Male" "Female"

Dataset: Basic
Gender of the artist

main_role

number

Deprecated

Dataset: Basic
ID of the main role of the artist

country_name

string

Dataset: Basic
Name of the artist’s country

country_code

string

Dataset: Basic
Two-letter code of the artist’s country, following the ISO 3166-1 alpha-2 standard

influence_country_name

string

Dataset: Basic
Name of the country that influenced the artist the most

influence_country_code

string

Dataset: Basic
Two-letter code of the country that influenced the artist the most, following the ISO 3166-1 alpha-2 standard

birth_date

string

Dataset: Bio
Artist’s date of birth, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

debut_date

string

Dataset: Bio
Artist’s debut date, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

birth_place

string

Dataset: Bio
Artist’s place of birth

Array of objects

Dataset: Bio
Array containing the artist’s activity periods

Array

start_date required	string Dataset: Bio Start date with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
end_date	string Dataset: Bio End date with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

death_date

string

Dataset: Bio
Artist’s date of death, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

death_place

string

Dataset: Bio
Artist’s place of death

Array of objects

Dataset: Basic (Main genre only) / Reco (Other genres)
Array containing the artist’s genres

Array

id_genre required	number Dataset: Basic (Main genre only) / Reco (Other genres) ID of the genre
name required	string Dataset: Basic (Main genre only) / Reco (Other genres) Name of the genre
link required	string Enum: "Main" "Principal" "Secondary" "Influence" Dataset: Basic (Main genre only) / Reco (Other genres) Relation type

Array of objects

Dataset: Basic (Main role only) / Reco (Other roles)
Array containing the artist’s roles

Array

id_role required	number Dataset: Basic (Main role only) / Reco (Other roles) ID of the role
name required	string Dataset: Basic (Main role only) / Reco (Other roles) Name of the role
link required	string Enum: "Main" "Other" Dataset: Basic (Main role only) / Reco (Other roles) Relation type

Array of objects

Dataset: Basic
Array containing the artist’s aliases

Array

alias required	string Dataset: Basic Alias
link required	string Enum: "Alias" "Nickname" Dataset: Basic Type of alias

Array of objects

Dataset: Basic
Array containing the artist’s translated names

Array

lang required	string Dataset: Basic Language of the translated name, following ISO-639 standard
name required	string Dataset: Basic Name of the artist in other languages

Array of objects

Dataset: Associate
Array containing the band members

Array

id_artist required	number Dataset: Associate ID of the band member
name_artist required	string Dataset: Associate Name of the band member
start_date	string Dataset: Associate Date at which the artist became a band member, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
end_date	string Dataset: Associate Date at which the artist stopped being a band member, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
id_role required	number Dataset: Associate ID of the band member’s role
name_role required	string Dataset: Associate Name of the band member’s role

Array of objects

Dataset: Reco
Array containing the related artists

Array

id_artist required	number Dataset: Reco ID of the related artist
name required	string Dataset: Reco Name of the related artist
link required	string Enum: "Related" "Successor" "Influence" Dataset: Reco Relation type

Array of objects

Dataset: Associate
Array containing the artist’s collaborators

Array

id_artist required	number Dataset: Associate ID of the collaborator
name_artist required	string Dataset: Associate Name of the collaborator
start_date	string Dataset: Associate Date of the start of the collaboration, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
end_date	string Dataset: Associate Date of the end of the collaboration, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.
id_role required	number Dataset: Associate ID of the collaborator’s role
name_role required	string Dataset: Associate Name of the collaborator’s role

object

Dataset: Basic
Object containing external links related to the artist

tiktok	string Dataset: Basic Link to the artist’s Tiktok pages
twitter	string Dataset: Basic Link to the artist’s Twitter pages
website	Array of strings Dataset: Basic Array containing link to the artist’s websites
youtube	string Dataset: Basic Link to the artist’s Youtube channels
facebook	string Dataset: Basic Link to the artist’s Facebook pages
instagram	string Dataset: Basic Link to the artist’s Instagram pages
soundcloud	string Dataset: Basic Link to the artist’s Soundcloud pages

object

Dataset: Basic / External
Object containing the IDs of the artist in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz artist IDs
discogs	Array of numbers Dataset: Basic Array of Discogs artist IDs
spotify	Array of strings Dataset: External Array of Spotify artist IDs
deezer	Array of numbers Dataset: External Array of Deezer artist IDs
napster	Array of strings Dataset: External Array of Napster artist IDs
qobuz	Array of numbers Dataset: External Array of Qobuz artist IDs
apple	Array of numbers Dataset: External Array of Apple Music artist IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital artist IDs
linemusic	Array of strings Dataset: External Array of Linemusic artist IDs
wikidata	Array of strings Dataset: Basic Array of Wikidata artist IDs

famous_for

string

Dataset: Bio
Blurb describing why the artist is well known

awards

string

Dataset: Bio
Blurb listing the awards won by the artist

Response samples

Content type

application/json

{"id": 23,
"name": "Paul McCartney",
"isni": "0000000121452530",
"real_firstname_lastname": "James Paul McCartney",
"type": "Person",
"gender": "Male",
"main_role": 13,
"country_name": "United Kingdom",
"country_code": "GB",
"influence_country_name": "United States",
"influence_country_code": "US",
"birth_date": "1942-06-18",
"debut_date": null,
"birth_place": "Liverpool,Mersey,England",
"activity_periods": [ ],
"death_date": null,
"death_place": null,
"genres": [{"id_genre": 1,
"name": "Rock",
"link": "Main"
}
],
"roles": [{"id_role": 1,
"name": "Songwriter",
"link": "Main"
}
],
"aliases": [{"alias": "Macca",
"link": "Nickname"
}
],
"translated": [{"lang": "AR",
"name": "بول مكارتني"
}
],
"band_members": [{"id_artist": 4746038,
"name_artist": "Paul & Linda McCartney",
"start_date": "1970-00-00",
"end_date": "1971-00-00",
"id_role": 13,
"name_role": "Singer"
}
],
"related_artists": [{"id_artist": 1,
"name": "George Harrison",
"link": "Related"
}
],
"collaborators": [{"id_artist": 4678361,
"name_artist": "John Wilson",
"start_date": "2011-00-00",
"end_date": "2011-00-00",
"id_role": 28,
"name_role": "Conductor"
}
],
"socials": {"tiktok": "https://www.tiktok.com/@paulmccartney",
"twitter": "https://twitter.com/PaulMcCartney",
"website": ["www.myspace.com/paulmccartney",
"www.paulmccartney.com",
"www.maccablog.com"
],
"youtube": "http://www.youtube.com/channel/UCvGnJy9RnXX0kGSnDPKCZzQ",
"facebook": "https://www.facebook.com/PaulMcCartney",
"instagram": "http://www.instagram.com/paulmccartney",
"soundcloud": "http://soundcloud.com/paulmccartney"
},
"externals": {"musicbrainz": ["ba550d0e-adac-4864-b88b-407cab5e76af"
],
"discogs": [35301,
995958,
3253856
],
"spotify": ["1UwUZoxDZNxM95ZpbJVUFO",
"1ZxqBJi6JF52YRDWAVJouM",
"2EAtt67svsoTgSFKdEOo3x",
"2RXViBJHDxEj0x6Mtxw1PI"
],
"deezer": [1446
],
"napster": ["956",
"35290773",
"267868678"
],
"qobuz": [35554
],
"apple": [1702764711,
1702764661,
524268715
],
"sevendigital": [803265
],
"linemusic": ["mi000000000006ae70",
"mi000000000016d1c7"
],
"wikidata": ["Q2599"
]
},
"famous_for": "As one quarter of The Beatles and for selling 100 million singles, making him the most successful composer and musician in popular music history",
"awards": "Academy Awards: Best Original Or Adaptation Score for 'Let It Be' with The Beatles (1971); BRIT Awards: British Album of the Year for 'Sgt. Peppers Lonely Hearts Club Band' with The Beatles (1977); British Group with The Beatles (1977); Outstanding Contribution to Music (1977; 1983; 2008); British Male Solo Artist (1983); Album of the Year for 'Ecce Cor Meum' (2007); Grammy Awards: Best New Artist with The Beatles (1965); Best Performance By a Vocal Group for 'A Hard Day's Night' with The Beatles (1965); Song of the Year for 'Michelle' with The Beatles (1967); Album of the Year for 'Sgt. Peppers Lonely Hearts Club Band' with The Beatles (1968); Best Historical Album for 'Band On the Run' (2012); Knighthood (1997)"
}

/api/artist/{id}/biographies

Get Music Story artist biographies

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Artist

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

lang	string Enum: "FR" "EN" "DE" "JA" "PT" "ES" Dataset: Bio Language in which the biography is written
source	string Enum: "Music-Story" "CD Journal" Dataset: Bio Source of the biography
content	string Dataset: Bio Text of the biography
author	string Dataset: Bio Author of the biography
copyright	string Dataset: Bio Copyright of the biography

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"lang": "JA",
"source": "Music-Story",
"content": "<p>XG (エックスジー) は、韓国を拠点とする日本のHIPHOP / R&amp;Bガールズグループ。メンバーはJURIN、CHISA、HARVEY、HINATA、JURIA、MAYA、COCONAの7名で、2022年3月に全編英語のシングル「Tippy Toes」でデビューを飾った。自分達のサウンドをJ-POPでもK-POPでもない「X-POP」と定義し、全編英語歌詞の楽曲やダンスは大きな注目を集めた。2023年9月リリースの1stミニアルバム『NEW DNA』は、日本の音楽配信チャート上位にランクイン。11月には初の有観客単独ライブを日本で開催し、続けて12月にはシングル「WINTER WITHOUT YOU」を発表。グループ名は“Xtraordinary Girls”の略であり、“常識にとらわれない規格外なスタイルの音楽やパフォーマンスを通じ、世界中の様々な境遇の人達をエンパワーすること”、を標榜している。&nbsp;</p>",
"author": "Hidehiko Horiuchi",
"copyright": "©Copyright Music Story Hidehiko Horiuchi 2024"
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/artist/{id}/pictures

Get Music Story artist pictures

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Artist

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number
format	Array of strings Items Enum: "1:1" "16:9" "all" Comma separated list of formats. When using multiple formats, the same id_picture may appear more than once, so it’s better to use id_picture_version.

Responses

Response Schema: application/json

Array of objects

Array

id_picture

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
ID of the picture. Uniqueness is defined by the (id_picture, format) pair: multiple formats can share the same id_picture, but it is unique for the default format (1:1).

id_picture_version

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
ID of the picture version (unique)

name

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Path of the picture

source

string

Enum: "Getty" "Music-Story" "Label"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Source of the picture

format

string

Enum: "1:1" "16:9"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Format of the picture

width

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Width of the picture in pixels

height

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Height of the picture in pixels

mimetype

string

Value: "image/jpeg"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
MIME type of the picture

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Copyright of the picture

object

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Object containing the picture’s metadata

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label

quality_rank

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label

title

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

date_created

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

date_submitted

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

orientation

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

collection_name

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

credit_line

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

license_model

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

artist

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

editorial_segments

Array of strings

Dataset: Picture-Getty / Picture-Curation / Picture-Label

product_types

Array of strings

people

Array of strings

object

id	number Dataset: Picture-Getty / Picture-Curation / Picture-Label
name	string Dataset: Picture-Getty / Picture-Curation / Picture-Label

object

height	number Dataset: Picture-Getty / Picture-Curation / Picture-Label
width	number Dataset: Picture-Getty / Picture-Curation / Picture-Label

object

how_can_i_use_it	string Dataset: Picture-Getty / Picture-Curation / Picture-Label
release_info	string Dataset: Picture-Getty / Picture-Curation / Picture-Label
usage_restrictions	Array of strings Dataset: Picture-Getty / Picture-Curation / Picture-Label

Response samples

Content type

application/json

{"results": [{"id_picture": 22688,
"id_picture_version": 27190,
"name": "https://images.music-story.com/protected/pictures/XXX-YYY-UUID/XXX-YYY-UUID.jpg",
"source": "Getty",
"format": "1:1",
"width": 3799,
"height": 3799,
"mimetype": "image/jpeg",
"copyright": "Mark and Colleen Hayward / Redferns / Getty Images",
"metas": {"id": 453928681,
"quality_rank": 1,
"title": "George Harrison",
"date_created": "1965-01-01T00:00:00",
"date_submitted": "2013-12-04T11:04:39",
"orientation": "Vertical",
"collection_name": "Redferns",
"copyright": "1965 Mark and Colleen Hayward",
"credit_line": "Redferns",
"license_model": "rightsmanaged",
"artist": "Mark and Colleen Hayward",
"editorial_segments": ["archival",
"entertainment"
],
"product_types": ["premiumaccess"
],
"people": ["George Harrison"
],
"editorial_source": {"id": 22763,
"name": "Redferns"
},
"max_dimensions": {"height": 4206,
"width": 4179
},
"allowed_use": {"how_can_i_use_it": "Available for |Editorial uses|. |Learn more|",
"release_info": "Not released",
"usage_restrictions": ["Contact your |local office| for all commercial or promotional uses."
]
}
},
"tags": ["indoor",
"colour",
"2015-2020",
"high_quality"
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/artist/{id}/albums

Get Music Story artist albums

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Artist

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the album

title

required

string

Dataset: Basic
Title of the album

subtitle

string

Dataset: Basic
Subtitle of the album

label

string

Dataset: Basic
Label of the album

distributor

string

Dataset: Basic
Distributor of the album

type

required

string

Enum: "ORIGINAL" "LIVE" "COMPILATION" "KARAOKE" "RING" "OTHER"

Dataset: Basic
Type of the album

format

required

string

Enum: "ALBUM" "EP" "SINGLE" "MCD" "MIXTAPE"

Dataset: Basic
Format of the album

original_release_date

string

Dataset: Reco
Original release date of the album, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

rating

number

Dataset: Review
Rating of the album

Array of objects

Dataset: Basic
Array containing the album's translated titles

Array

lang required	string Dataset: Basic Language of the translated name, following ISO-639 standard
title required	string Dataset: Basic Name of the title in other languages
subtitle	string Dataset: Basic Name of the subtitle in other languages

object

Dataset: Basic
Object containing the IDs of the album in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz album IDs
discogs	Array of numbers Dataset: Basic Array of Discogs album IDs

object

id_genre required	number Dataset: Basic ID of the album’s genre
name required	string Dataset: Basic Name of the album’s genre

Array of objects

Dataset: Basic
Array of artists related to the album

Array

id_artist required	number Dataset: Basic ID of the artist
name required	string Dataset: Basic Name of the artist
link required	string Dataset: Basic Relation type

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 12946,
"title": "The Rhythm of the Saints",
"subtitle": null,
"label": "Warner Bros.",
"distributor": "Warner",
"type": "ORIGINAL",
"format": "ALBUM",
"original_release_date": "1990-10-16",
"rating": 3,
"translated": [{"lang": "ja",
"title": "リズム・オブ・ザ・セインツ",
"subtitle": null
}
],
"externals": {"musicbrainz": ["9c08260c-d558-391b-ae2b-aba11b9793d8"
],
"discogs": [113674
]
},
"genre": {"id_genre": 143,
"name": "Worldbeat"
},
"artists": [{"id_artist": 2278,
"name": "Paul Simon",
"link": "Main"
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/artist/{id}/popularity

Get Music Story artist popularity

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Artist

Responses

Response Schema: application/json

type

required

string

Enum: "catalog" "current"

Dataset: Popularity
The most representative type of popularity for an artist

peak

required

number

Dataset: Popularity
Most representative date in years

object

Dataset: Popularity
Object contains global info of popularity of the artist

score required	number [ 0 .. 100 ] Dataset: Popularity Global score in percent of the artist
rank	number Dataset: Popularity Global rank of the artist
recordings_in_charts	number Dataset: Popularity Total number of titles in charts

object

Dataset: Popularity
Object contains catalog info of popularity of the artist

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Catalog score in percent of the artist

rank

number

Dataset: Popularity
Catalog rank of the artist

recordings_in_charts

number

Dataset: Popularity
Total number of titles in charts

Array of objects

Dataset: Popularity
Array containing all details of catalog popularity per year

Array

year

required

number

Dataset: Popularity
Year of popularity

charts_used

required

number

Dataset: Popularity
Number of charts used to calculate the popularity

rank

required

number

Dataset: Popularity
Rank of the artist

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Score of the artist

object

Dataset: Popularity
Object contains the best recording of the artist

id required	number Dataset: Popularity Most popular recording id
title required	string Dataset: Popularity Most popular recording title
best_rank required	number Dataset: Popularity Best rank of the recording in charts
best_country_code required	string Dataset: Popularity Two-letter code of the country where the recording reached its best rank, following the ISO 3166-1 alpha-2 standard, or null if the rank was reached in multiple countries (string, optional)
best_country_name required	string Dataset: Popularity Name of the country where the recording reached its best rank, or “International” if the rank was reached in multiple countries

Array of objects

Dataset: Popularity
Array containing all details of catalog popularity by country

Array

code

required

string

Dataset: Popularity
Two-letter code of country, following the ISO 3166-1 alpha-2 standard

name

required

string

Dataset: Popularity
Name of the country

charts_used

required

number

Dataset: Popularity
Number of charts used to calculate the popularity

rank

required

number

Dataset: Popularity
Rank of the artist

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Score of the artist

object

Dataset: Popularity
Object contains the best recording of the artist

id required	number Dataset: Popularity Most popular recording id
title required	string Dataset: Popularity Most popular recording title
best_rank required	number Dataset: Popularity Best rank of the recording in charts
best_month required	string Dataset: Popularity Best month of the recording
weeks_in_charts required	number Dataset: Popularity Number of weeks in charts of the recording

object

Dataset: Popularity
Object contains current info of popularity of the artist

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Current score in percent of the artist

rank

number

Dataset: Popularity
Current rank of the artist

recordings_in_charts

number

Dataset: Popularity
Total number of titles in charts

Array of objects

Dataset: Popularity
Object table contains all details of current popularity per month

Array

month

required

string

Dataset: Popularity
Month of popularity formatted as “YYYY-MM”

charts_used

required

number

Dataset: Popularity
Number of charts used to calculate the popularity

rank

required

number

Dataset: Popularity
Rank of the artist

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Score of the artist

object

Dataset: Popularity
Object contains the best recording of the artist

id required	number Dataset: Popularity Most popular recording id
title required	string Most popular recording title
best_rank required	number Dataset: Popularity Best rank of the recording in charts
best_country_code required	string Dataset: Popularity Two-letter code of the country where the recording reached its best rank, following the ISO 3166-1 alpha-2 standard, or null if the rank was reached in multiple countries (string, optional)
best_country_name required	string Dataset: Popularity Name of the country where the recording reached its best rank, or “International” if the rank was reached in multiple countries

Array of objects

Dataset: Popularity
Array containing all details of current popularity per country

Array

code

required

string

Dataset: Popularity
Two-letter code of country, following the ISO 3166-1 alpha-2 standard

name

required

string

Dataset: Popularity
Name of the country

charts_used

required

number

Dataset: Popularity
Number of charts used to calculate the popularity

rank

required

number

Dataset: Popularity
Rank of the artist

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Score of the artist

object

Dataset: Popularity
Object contains the best recording of the artist

id required	number Dataset: Popularity Most popular recording id
title required	string Dataset: Popularity Most popular recording title
best_rank required	number Dataset: Popularity Best rank of the recording in charts
best_month required	string Dataset: Popularity Best month of the recording
weeks_in_charts required	number Dataset: Popularity Number of weeks in charts of the recording

Response samples

Content type

application/json

{"type": "catalog",
"peak": 2016,
"global": {"score": 100,
"rank": 1,
"recordings_in_charts": 237
},
"catalog": {"score": 100,
"rank": 1,
"recordings_in_charts": 229,
"details_by_year": [{"year": 2009,
"charts_used": 2,
"rank": 42,
"score": 51.2487091291627,
"best_recording": {"id": 1473483,
"title": "Best I Ever Had",
"best_rank": 2,
"best_country_code": "US",
"best_country_name": "United States of America"
}
}
],
"details_by_country": [{"code": "GB",
"name": "United Kingdom",
"charts_used": 1,
"rank": 3,
"score": 84.57218339095239,
"best_recording": {"id": 17184093,
"title": "One Dance",
"best_rank": 1,
"best_month": "2016-04-01",
"weeks_in_charts": 65
}
}
]
},
"current": {"score": 64.47778260642683,
"rank": 14,
"recordings_in_charts": 108,
"details_by_month": [{"month": "2020-01",
"charts_used": 48,
"rank": 948,
"score": 6.004772098820925,
"best_recording": {"id": 19857860,
"title": "Money In The Grave",
"best_rank": 43,
"best_country_code": "US",
"best_country_name": "United States of America"
}
}
],
"details_by_country": [{"code": "AR",
"name": "Argentina",
"charts_used": 4,
"rank": 289,
"score": 23.925558356879662,
"best_recording": {"id": 20773631,
"title": "Laugh Now Cry Later",
"best_rank": 48,
"best_month": "2023-02-01",
"weeks_in_charts": 1
}
}
]
}
}

Albums

All endpoints to get albums data

/api/album

Search Music Story album

Authorizations:

Bearer

query Parameters

query required	string Name or ID of Album to search
page	integer >= 1 Default: 1 Page number
release_date	string Release date to filter results
artist	string Artist name to filter results

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the album

title

required

string

Dataset: Basic
Title of the album

subtitle

string

Dataset: Basic
Subtitle of the album

label

string

Dataset: Basic
Label of the album

distributor

string

Dataset: Basic
Distributor of the album

type

required

string

Enum: "ORIGINAL" "LIVE" "COMPILATION" "KARAOKE" "RING" "OTHER"

Dataset: Basic
Type of the album

format

required

string

Enum: "ALBUM" "EP" "SINGLE" "MCD" "MIXTAPE"

Dataset: Basic
Format of the album

original_release_date

string

Dataset: Reco
Original release date of the album, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

rating

number

Dataset: Review
Rating of the album

Array of objects

Dataset: Basic
Array containing the album's translated titles

Array

lang required	string Dataset: Basic Language of the translated name, following ISO-639 standard
title required	string Dataset: Basic Name of the title in other languages
subtitle	string Dataset: Basic Name of the subtitle in other languages

object

Dataset: Basic
Object containing the IDs of the album in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz album IDs
discogs	Array of numbers Dataset: Basic Array of Discogs album IDs

object

id_genre required	number Dataset: Basic ID of the album’s genre
name required	string Dataset: Basic Name of the album’s genre

Array of objects

Dataset: Basic
Array of artists related to the album

Array

id_artist required	number Dataset: Basic ID of the artist
name required	string Dataset: Basic Name of the artist
link required	string Dataset: Basic Relation type

score

number

Score related to the search

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 12946,
"title": "The Rhythm of the Saints",
"subtitle": null,
"label": "Warner Bros.",
"distributor": "Warner",
"type": "ORIGINAL",
"format": "ALBUM",
"original_release_date": "1990-10-16",
"rating": 3,
"translated": [{"lang": "ja",
"title": "リズム・オブ・ザ・セインツ",
"subtitle": null
}
],
"externals": {"musicbrainz": ["9c08260c-d558-391b-ae2b-aba11b9793d8"
],
"discogs": [113674
]
},
"genre": {"id_genre": 143,
"name": "Worldbeat"
},
"artists": [{"id_artist": 2278,
"name": "Paul Simon",
"link": "Main"
}
],
"score": "1"
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

/api/album/{id}

Get Music Story album

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Album

Responses

Response Schema: application/json

required

number

Dataset: Basic
ID of the album

title

required

string

Dataset: Basic
Title of the album

subtitle

string

Dataset: Basic
Subtitle of the album

label

string

Dataset: Basic
Label of the album

distributor

string

Dataset: Basic
Distributor of the album

type

required

string

Enum: "ORIGINAL" "LIVE" "COMPILATION" "KARAOKE" "RING" "OTHER"

Dataset: Basic
Type of the album

format

required

string

Enum: "ALBUM" "EP" "SINGLE" "MCD" "MIXTAPE"

Dataset: Basic
Format of the album

original_release_date

string

Dataset: Reco
Original release date of the album, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

rating

number

Dataset: Review
Rating of the album

Array of objects

Dataset: Basic
Array containing the album's translated titles

Array

lang required	string Dataset: Basic Language of the translated name, following ISO-639 standard
title required	string Dataset: Basic Name of the title in other languages
subtitle	string Dataset: Basic Name of the subtitle in other languages

object

Dataset: Basic
Object containing the IDs of the album in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz album IDs
discogs	Array of numbers Dataset: Basic Array of Discogs album IDs

object

id_genre required	number Dataset: Basic ID of the album’s genre
name required	string Dataset: Basic Name of the album’s genre

Array of objects

Dataset: Basic
Array of artists related to the album

Array

id_artist required	number Dataset: Basic ID of the artist
name required	string Dataset: Basic Name of the artist
link required	string Dataset: Basic Relation type

Response samples

Content type

application/json

{"id": 12946,
"title": "The Rhythm of the Saints",
"subtitle": null,
"label": "Warner Bros.",
"distributor": "Warner",
"type": "ORIGINAL",
"format": "ALBUM",
"original_release_date": "1990-10-16",
"rating": 3,
"translated": [{"lang": "ja",
"title": "リズム・オブ・ザ・セインツ",
"subtitle": null
}
],
"externals": {"musicbrainz": ["9c08260c-d558-391b-ae2b-aba11b9793d8"
],
"discogs": [113674
]
},
"genre": {"id_genre": 143,
"name": "Worldbeat"
},
"artists": [{"id_artist": 2278,
"name": "Paul Simon",
"link": "Main"
}
]
}

/api/album/{id}/coverart

Get Music Story album coverart

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Album

Responses

Response Schema: application/json

path required	string Dataset: Artwork Path of the cover art in the pictures delivery
path_400	string Dataset: Artwork Path of the cover art (400x400) in the pictures delivery
width	number Dataset: Artwork Width of the cover art in pixels
height	number Dataset: Artwork Height of the cover art in pixels
source required	number Dataset: Artwork Source of the cover art
copyright	number Dataset: Artwork Copyright of the cover art

Response samples

Content type

application/json

{"path": "https://images.fr.music-story.com/download/cover_art/curation/original/f/c/7/7/XXX-YYY-UUID.jpg",
"path_400": "https://images.fr.music-story.com/download/cover_art/curation/400/f/c/7/7/XXX-YYY-UUID.jpg",
"width": 1500,
"height": 1500,
"source": "Music-Story",
"copyright": "©Copyright Music Story"
}

/api/album/{id}/audiodescriptions

Descriptors calculated on audio files

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Album

Responses

Response Schema: application/json

arousal	number Dataset: Audio Perceptual measure related to intensity, energy and activity. High value usually corresponds to high energy track (hard rock, metal). Low value is given to calm tracks (slow, ballad)
danceability	number Dataset: Audio Indicates if a track is likely to be considered for dancing (perception of tempo and rhythm, stability and regularity). High value corresponds to more danceable tracks. Low value is related to tracks without any perceptual rhythm.
dissonance	number Dataset: Audio Indicates how dissonant is a track. High value corresponds to tracks without clear harmony, noisy timbre for example, or with very complex harmonies (dissonant intervals such as tritones, seconds, etc). Low value corresponds to tracks with simple harmony, clear melody, consonant harmonies (simple piano melodies for example).
electric_acoustic	number Dataset: Audio Indicates whether the track contains acoustic content. High value corresponds to acoustic tracks (acoustic guitar/piano, voice, classical music). Low value indicates tracks with electric content (electronic, distortion, audio effects).
melodicity	number Dataset: Audio Indicates whether a track contains or not a clearly audible melody. High value corresponds to pleasant, harmonic tracks, to which you feel like singing along. Low value is more related to noises, soundscapes or tracks with complex harmonies or melodies (classical, jazz, etc).
music_speech	number Dataset: Audio Indicates speech content in a track. High value is related to the presence of spoken words (interview, audio book, poetry, commentary). Low value probably corresponds to music, eventually with vocals (singing tracks), but without speech parts.
studio_live	number Dataset: Audio Indicates the probability that the track has been performed live. High value corresponds to live tracks. Low value is more probably related to studio recordings.
valence	number Dataset: Audio Perceptual measure of mood, related to positive or negative feelings, for example joy/sadness. High value corresponds to track with positive feelings. Low value refers to sad tracks.
vocal_instrumental	number Dataset: Audio Indicates whether a track contains or not vocals. High value indicates that the track probably contains no vocal sounds (instrumental) Low value probably corresponds to track with vocal content (singing words, rap, slam or speech for example).

Response samples

Content type

application/json

{"arousal": 0.6090944588744586,
"danceability": 0.42260865800865793,
"dissonance": 0.4210159740259739,
"electric_acoustic": 0.3986565800865799,
"melodicity": 0.6357076190476186,
"music_speech": 0.08721415584415596,
"studio_live": 0.294824155844156,
"valence": 0.4137444588744586,
"vocal_instrumental": 0.06088199134199131
}

/api/album/{id}/releases

Get Music Story album releases

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Album

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the release

release_date

string

Dataset: Basic
Release date of the release, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

distributor

string

Dataset: Basic
Distributor of the release

barcode

string

Dataset: Basic
Barcode (EAN or UPC) of the release

support

string

Enum: "2CD" "CD" "DVD" "EP" "K7" "LP" "NUM"

Dataset: Basic
Medium of the release

object

Dataset: Basic / External
Object containing the IDs of the release in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz release IDs
discogs	Array of numbers Dataset: Basic Array of Discogs release IDs
spotify	Array of strings Dataset: External Array of Spotify release IDs
deezer	Array of numbers Dataset: External Array of Deezer release IDs
napster	Array of strings Dataset: External Array of Napster release IDs
qobuz	Array of numbers Dataset: External Array of Qobuz release IDs
apple	Array of numbers Dataset: External Array of Apple Music release IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital release IDs
linemusic	Array of strings Dataset: External Array of Linemusic release IDs

object

Dataset: Basic
Object containing the album information

id required	number Dataset: Basic ID of the album
title required	string Dataset: Basic Title of the album

Array of objects

Dataset: Basic
Object containing the artists information

Array

id required	number Dataset: Basic ID of the artist
name required	string Dataset: Basic Name of the artist

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 446,
"release_date": "2001-00-00",
"distributor": "RCA",
"barcode": "0744659975226",
"support": "LP",
"externals": {"musicbrainz": ["2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
"9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
],
"discogs": ["534523,",
5373901,
1177873,
8897565,
437305
],
"spotify": ["1gsqQnSVIeP0CIFAclYRUB",
"1KcGZXb6VBAxn8Jd9RVyc2",
"2A2w7NSKKyAfDvwx6GEHEg",
"5gtctm9OmVchYegE7PBOgc"
],
"deezer": [107745
],
"napster": ["396274334",
"189177"
],
"qobuz": [183245
],
"apple": [254339508
],
"sevendigital": [293792
],
"linemusic": ["mb00000000000cba83"
]
},
"album": {"id": 110,
"title": "Metal Machine Music"
},
"artists": [{"id": 16,
"name": "Lou Reed"
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/album/{id}/credits

Get album credits

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Album

Responses

Response Schema: application/json

required

number

Dataset: Credit
ID of the album

Array of objects

Dataset: Credit
Table of object containing the credits information

Array

parent_credit_name

string

Dataset: Credit
Name of parent credit

Array of objects

Dataset: Credit
Table of object child credits contains all childs credits

Array

credit_child_name

string

Dataset: Credit
Name of the child credit

Array of objects

Dataset: Credit
Table of object childs credits

Array

name	string Dataset: Credit Artist name of the credit
id_artist	number Dataset: Credit ID of the artist from the Music Story catalog

Response samples

Content type

application/json

{"id": 696211,
"data": [{"parent_credit_name": "Engineer",
"parent_credit": [{"credit_child_name": "Assistant Engineer",
"credit_child": [{"name": "David Gleeson",
"id_artist": 4754188
}
]
}
]
}
]
}

/api/album/{id}/reviews

Get Music Story album reviews

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Album

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

lang required	string Enum: "FR" "EN" "DE" "JA" "PT" "ES" Dataset: Review Language in which the review is written
source required	string Dataset: Review Copyright of the cover art
content required	string Dataset: Review Copyright of the cover art
author	string Dataset: Review Copyright of the cover art
copyright	string Dataset: Review Copyright of the cover art

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"lang": "EN",
"source": "Music-Story",
"content": "Released almost a year after it was finished, it is THE Velvet Underground album, an avant-garde album that establishes the Velvet's identity and favorite themes, and upsets the standards of society at the time. Produced by Andy Warhol, it bears his strong imprint and influence, lending the Velvet the voice of one of his muses, Nico. This album, so disturbing and out of the ordinary, received almost no airplay on commercial radio, not only because of the music's non-conformism, but perhaps also, paradoxically, because of Warhol's stranglehold on the group, which almost automatically attached the \"arty\" label to it, frightening the general public.",
"author": "Music Story",
"copyright": "©Copyright Music Story Music Story 2024"
}
],
"offset": 0,
"limit": 20,
"total": 45
}

Pictures

All endpoints to get pictures data

/api/picture/log

Get Music Story picture logs

Authorizations:

Bearer

query Parameters

limit	integer >= 0 Default: 1000 Limit number
start_after	integer Default: null ID of the last log processed

Responses

Response Schema: application/json

Array of objects

Array

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
ID of the log

id_picture

number

id_picture_version

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
ID of the picture version (unique)

name

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Path of the picture

width

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Width of the picture in pixels

height

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Height of the picture in pixels

mimetype

string

Value: "image/jpeg"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
MIME type of the picture

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Copyright of the picture

source

string

Enum: "Getty" "Music-Story" "Label"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Source of the picture

format

string

Enum: "1:1" "16:9"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Format of the picture

action

string

Enum: "update" "delete"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Action taken on the picture

object

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Object containing the picture’s metadata

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label

quality_rank

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label

title

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

date_created

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

date_submitted

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

orientation

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

collection_name

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

credit_line

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

license_model

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

artist

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

editorial_segments

Array of strings

Dataset: Picture-Getty / Picture-Curation / Picture-Label

product_types

Array of strings

people

Array of strings

object

id	number Dataset: Picture-Getty / Picture-Curation / Picture-Label
name	string Dataset: Picture-Getty / Picture-Curation / Picture-Label

object

height	number Dataset: Picture-Getty / Picture-Curation / Picture-Label
width	number Dataset: Picture-Getty / Picture-Curation / Picture-Label

object

how_can_i_use_it	string Dataset: Picture-Getty / Picture-Curation / Picture-Label
release_info	string Dataset: Picture-Getty / Picture-Curation / Picture-Label
usage_restrictions	Array of strings Dataset: Picture-Getty / Picture-Curation / Picture-Label

Response samples

Content type

application/json

{"results": [{"id": 1025,
"id_picture": 194784,
"id_picture_version": 413353,
"name": "https://images.music-story.com/protected/pictures/XXX-YYY-UUID/XXX-YYY-UUID.jpg",
"width": 3799,
"height": 3799,
"mimetype": "image/jpeg",
"copyright": "Mark and Colleen Hayward / Redferns / Getty Images",
"source": "Getty",
"format": "1:1",
"action": "delete",
"metas": {"id": 453928681,
"quality_rank": 1,
"title": "George Harrison",
"date_created": "1965-01-01T00:00:00",
"date_submitted": "2013-12-04T11:04:39",
"orientation": "Vertical",
"collection_name": "Redferns",
"copyright": "1965 Mark and Colleen Hayward",
"credit_line": "Redferns",
"license_model": "rightsmanaged",
"artist": "Mark and Colleen Hayward",
"editorial_segments": ["archival",
"entertainment"
],
"product_types": ["premiumaccess"
],
"people": ["George Harrison"
],
"editorial_source": {"id": 22763,
"name": "Redferns"
},
"max_dimensions": {"height": 4206,
"width": 4179
},
"allowed_use": {"how_can_i_use_it": "Available for |Editorial uses|. |Learn more|",
"release_info": "Not released",
"usage_restrictions": ["Contact your |local office| for all commercial or promotional uses."
]
}
},
"tags": ["indoor",
"colour",
"2015-2020",
"high_quality"
],
"date": "2025-10-27 06:01:49.528"
}
]
}

Releases

All endpoints to get releases data

/api/release

Search Music Story release

Authorizations:

Bearer

query Parameters

query	string Name of album or ID of Release to search
page	integer >= 1 Default: 1 Page number
barcode	string Barcode to filter results
release_date	string Release date to filter results
musicbrainz_id	string Musicbrainz ID to filter results
spotify_id	string Spotify ID to filter results
deezer_id	string Deezer ID to filter results
napster_id	string Napster ID to filter results
qobuz_id	string Qobuz ID to filter results
apple_id	string Apple Music ID to filter results
sevendigital_id	string 7Digital ID to filter results
discogs_id	string Discogs ID to filter results

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the release

release_date

string

Dataset: Basic
Release date of the release, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

distributor

string

Dataset: Basic
Distributor of the release

barcode

string

Dataset: Basic
Barcode (EAN or UPC) of the release

support

string

Enum: "2CD" "CD" "DVD" "EP" "K7" "LP" "NUM"

Dataset: Basic
Medium of the release

object

Dataset: Basic / External
Object containing the IDs of the release in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz release IDs
discogs	Array of numbers Dataset: Basic Array of Discogs release IDs
spotify	Array of strings Dataset: External Array of Spotify release IDs
deezer	Array of numbers Dataset: External Array of Deezer release IDs
napster	Array of strings Dataset: External Array of Napster release IDs
qobuz	Array of numbers Dataset: External Array of Qobuz release IDs
apple	Array of numbers Dataset: External Array of Apple Music release IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital release IDs
linemusic	Array of strings Dataset: External Array of Linemusic release IDs

object

Dataset: Basic
Object containing the album information

id required	number Dataset: Basic ID of the album
title required	string Dataset: Basic Title of the album

Array of objects

Dataset: Basic
Object containing the artists information

Array

id required	number Dataset: Basic ID of the artist
name required	string Dataset: Basic Name of the artist

score

number

Score related to the search

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 446,
"release_date": "2001-00-00",
"distributor": "RCA",
"barcode": "0744659975226",
"support": "LP",
"externals": {"musicbrainz": ["2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
"9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
],
"discogs": ["534523,",
5373901,
1177873,
8897565,
437305
],
"spotify": ["1gsqQnSVIeP0CIFAclYRUB",
"1KcGZXb6VBAxn8Jd9RVyc2",
"2A2w7NSKKyAfDvwx6GEHEg",
"5gtctm9OmVchYegE7PBOgc"
],
"deezer": [107745
],
"napster": ["396274334",
"189177"
],
"qobuz": [183245
],
"apple": [254339508
],
"sevendigital": [293792
],
"linemusic": ["mb00000000000cba83"
]
},
"album": {"id": 110,
"title": "Metal Machine Music"
},
"artists": [{"id": 16,
"name": "Lou Reed"
}
],
"score": "1"
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

/api/release/toc

Search Music Story release by Table of Content

Authorizations:

Bearer

query Parameters

toc required	string Example: toc=1 4 289150 150 72965 144450 217485 A CD's TOC (Table of Content) in MusicBrainz's 'Full TOC' format, consisting of the following values separated by spaces or `+`: First track number (always 1) Last track number Sector offset of the leadout track (end of the disc) Sector offset of each track, beginning with track 1
page	integer >= 1 Default: 1 Page number

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the release

release_date

string

Dataset: Basic
Release date of the release, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

distributor

string

Dataset: Basic
Distributor of the release

barcode

string

Dataset: Basic
Barcode (EAN or UPC) of the release

support

string

Enum: "2CD" "CD" "DVD" "EP" "K7" "LP" "NUM"

Dataset: Basic
Medium of the release

object

Dataset: Basic / External
Object containing the IDs of the release in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz release IDs
discogs	Array of numbers Dataset: Basic Array of Discogs release IDs
spotify	Array of strings Dataset: External Array of Spotify release IDs
deezer	Array of numbers Dataset: External Array of Deezer release IDs
napster	Array of strings Dataset: External Array of Napster release IDs
qobuz	Array of numbers Dataset: External Array of Qobuz release IDs
apple	Array of numbers Dataset: External Array of Apple Music release IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital release IDs
linemusic	Array of strings Dataset: External Array of Linemusic release IDs

object

Dataset: Basic
Object containing the album information

id required	number Dataset: Basic ID of the album
title required	string Dataset: Basic Title of the album

Array of objects

Dataset: Basic
Object containing the artists information

Array

id required	number Dataset: Basic ID of the artist
name required	string Dataset: Basic Name of the artist

score

number

Score related to the search

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 446,
"release_date": "2001-00-00",
"distributor": "RCA",
"barcode": "0744659975226",
"support": "LP",
"externals": {"musicbrainz": ["2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
"9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
],
"discogs": ["534523,",
5373901,
1177873,
8897565,
437305
],
"spotify": ["1gsqQnSVIeP0CIFAclYRUB",
"1KcGZXb6VBAxn8Jd9RVyc2",
"2A2w7NSKKyAfDvwx6GEHEg",
"5gtctm9OmVchYegE7PBOgc"
],
"deezer": [107745
],
"napster": ["396274334",
"189177"
],
"qobuz": [183245
],
"apple": [254339508
],
"sevendigital": [293792
],
"linemusic": ["mb00000000000cba83"
]
},
"album": {"id": 110,
"title": "Metal Machine Music"
},
"artists": [{"id": 16,
"name": "Lou Reed"
}
],
"score": "1"
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

/api/release/{id}

Get Music Story release

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Release

Responses

Response Schema: application/json

required

number

Dataset: Basic
ID of the release

release_date

string

Dataset: Basic
Release date of the release, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

distributor

string

Dataset: Basic
Distributor of the release

barcode

string

Dataset: Basic
Barcode (EAN or UPC) of the release

support

string

Enum: "2CD" "CD" "DVD" "EP" "K7" "LP" "NUM"

Dataset: Basic
Medium of the release

object

Dataset: Basic / External
Object containing the IDs of the release in external databases and platforms

musicbrainz	Array of strings Dataset: Basic Array of MusicBrainz release IDs
discogs	Array of numbers Dataset: Basic Array of Discogs release IDs
spotify	Array of strings Dataset: External Array of Spotify release IDs
deezer	Array of numbers Dataset: External Array of Deezer release IDs
napster	Array of strings Dataset: External Array of Napster release IDs
qobuz	Array of numbers Dataset: External Array of Qobuz release IDs
apple	Array of numbers Dataset: External Array of Apple Music release IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital release IDs
linemusic	Array of strings Dataset: External Array of Linemusic release IDs

object

Dataset: Basic
Object containing the album information

id required	number Dataset: Basic ID of the album
title required	string Dataset: Basic Title of the album

Array of objects

Dataset: Basic
Object containing the artists information

Array

id required	number Dataset: Basic ID of the artist
name required	string Dataset: Basic Name of the artist

Response samples

Content type

application/json

{"id": 446,
"release_date": "2001-00-00",
"distributor": "RCA",
"barcode": "0744659975226",
"support": "LP",
"externals": {"musicbrainz": ["2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
"9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
],
"discogs": ["534523,",
5373901,
1177873,
8897565,
437305
],
"spotify": ["1gsqQnSVIeP0CIFAclYRUB",
"1KcGZXb6VBAxn8Jd9RVyc2",
"2A2w7NSKKyAfDvwx6GEHEg",
"5gtctm9OmVchYegE7PBOgc"
],
"deezer": [107745
],
"napster": ["396274334",
"189177"
],
"qobuz": [183245
],
"apple": [254339508
],
"sevendigital": [293792
],
"linemusic": ["mb00000000000cba83"
]
},
"album": {"id": 110,
"title": "Metal Machine Music"
},
"artists": [{"id": 16,
"name": "Lou Reed"
}
]
}

/api/release/{id}/tracks

Get Music Story release tracks

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Release

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

number

Dataset: Basic
ID of the track

disc_number

number

Dataset: Basic
Disc number

track_number

number

Dataset: Basic
Track number

object

Dataset: Basic
Object containing the recording information

id	number Dataset: Basic ID of the recording
title	string Dataset: Basic Title of the recording
subtitle	string Dataset: Basic Subtitle of the recording
duration	string Dataset: Basic Duration of the recording, with format “HH:MM:SS

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 23096375614016624,
"disc_number": 1,
"track_number": 1,
"recording": {"id": 5377544,
"title": "The Rhythm Of The Night",
"subtitle": null,
"duration": "00:04:39"
}
}
],
"offset": 0,
"limit": 20,
"total": 45
}

Recordings

All endpoints to get recordings data

/api/recording

Search Music Story recording

Authorizations:

Bearer

query Parameters

query	string Name or ID of Recording to search
page	integer >= 1 Default: 1 Page number
isrc	string ISRC to filter results
musicbrainz_id	string Musicbrainz ID to filter results
spotify_id	string Spotify ID to filter results
deezer_id	string Deezer ID to filter results
napster_id	string Napster ID to filter results
qobuz_id	string Qobuz ID to filter results
apple_id	string Apple Music ID to filter results
sevendigital_id	string 7Digital ID to filter results
lyricfind_id	string Lyricfind ID to filter results

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the recording

title

required

string

Dataset: Basic
Title of the recording

subtitle

string

Dataset: Basic
Subtitle of the recording

duration

string

Dataset: Basic
Duration of the recording, with format “HH:MM:SS”

isrc

string

Dataset: Basic
ISRC of the recording

hit

number

Dataset: Basic
Rating if the recording has been in the charts

editors_pick

number

Dataset: Basic
Rating if the recording is recommended by the Music Story editorial team

object

Dataset: Basic
Object containing the IDs of the recording in external databases and platforms

musicbrainz	Array of numbers Dataset: Basic Array of MusicBrainz recording IDs
lyricfind	Array of numbers Dataset: Lyrics Array of LyricFind recording IDs
spotify	Array of strings Dataset: External Array of Spotify recording IDs
deezer	Array of numbers Dataset: External Array of Deezer recording IDs
napster	Array of strings Dataset: External Array of Napster recording IDs
qobuz	Array of numbers Dataset: External Array of Qobuz recording IDs
apple	Array of numbers Dataset: External Array of Apple Music recording IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital recording IDs
linemusic	Array of strings Dataset: External Array of Linemusic recording IDs

Array of objects

Dataset: Basic
Array containing the recording translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
title	string Dataset: Basic Title of the recording in other languages
subtitle	string Dataset: Basic Subtitle of the recording in other languages

related_isrcs

Array of strings

Dataset: Basic
Array of related isrcs

object

Dataset: Basic
Object containing the genre of the recording

id_genre required	number Dataset: Basic ID of the recording genre
name required	string Dataset: Basic Name of the recording genre

Array of objects

Dataset: Basic
Object containing the artists information

Array

required

number

Dataset: Basic
ID of the artist

name

required

string

Dataset: Basic
Name of the artist

type

required

string

Enum: "MAIN" "OTHER"

Dataset: Basic
Type of the artist

Array of objects

Dataset: Basic
The roles of the artist on this recording

Array

id	number Dataset: Basic ID of the role
name	string Dataset: Basic Name of the role in english

score

number

Score related to the search

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 49846,
"title": "Thunderstruck",
"subtitle": null,
"duration": "00:06:34",
"isrc": "AUAP09200021",
"hit": null,
"editors_pick": null,
"externals": {"musicbrainz": [464398
],
"lyricfind": [194658,
5244802
],
"spotify": ["1DstlcbjaI2vjyJNNW7leT",
"1DstlcbjaI2vjyJNNW7leT"
],
"deezer": [92722920,
92720126
],
"napster": ["613f6c61b98e619b681d0f28",
"613f801ab98e619b68c841bf",
"610034875",
"609221422",
"190835078",
"190834549"
],
"qobuz": [19912668,
19907823,
19907940
],
"apple": [575992085,
575997835,
579533232
],
"sevendigital": [40266621,
40267569
],
"linemusic": ["mt000000000074338d",
"mt00000000007431eb"
]
},
"translated": [{"lang": "ja",
"title": "サンダーストラック",
"subtitle": null
}
],
"related_isrcs": null,
"genre": {"id_genre": 32,
"name": "Hard rock"
},
"artists": [{"id": 100115,
"name": "AC/DC",
"type": "MAIN",
"roles": [{"id": 123,
"name": "Singer"
}
]
}
],
"score": "1"
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

/api/recording/{id}

Get Music Story recording

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Recording

Responses

Response Schema: application/json

required

number

Dataset: Basic
ID of the recording

title

required

string

Dataset: Basic
Title of the recording

subtitle

string

Dataset: Basic
Subtitle of the recording

duration

string

Dataset: Basic
Duration of the recording, with format “HH:MM:SS”

isrc

string

Dataset: Basic
ISRC of the recording

hit

number

Dataset: Basic
Rating if the recording has been in the charts

editors_pick

number

Dataset: Basic
Rating if the recording is recommended by the Music Story editorial team

object

Dataset: Basic
Object containing the IDs of the recording in external databases and platforms

musicbrainz	Array of numbers Dataset: Basic Array of MusicBrainz recording IDs
lyricfind	Array of numbers Dataset: Lyrics Array of LyricFind recording IDs
spotify	Array of strings Dataset: External Array of Spotify recording IDs
deezer	Array of numbers Dataset: External Array of Deezer recording IDs
napster	Array of strings Dataset: External Array of Napster recording IDs
qobuz	Array of numbers Dataset: External Array of Qobuz recording IDs
apple	Array of numbers Dataset: External Array of Apple Music recording IDs
sevendigital	Array of numbers Dataset: External Array of Sevendigital recording IDs
linemusic	Array of strings Dataset: External Array of Linemusic recording IDs

Array of objects

Dataset: Basic
Array containing the recording translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
title	string Dataset: Basic Title of the recording in other languages
subtitle	string Dataset: Basic Subtitle of the recording in other languages

related_isrcs

Array of strings

Dataset: Basic
Array of related isrcs

object

Dataset: Basic
Object containing the genre of the recording

id_genre required	number Dataset: Basic ID of the recording genre
name required	string Dataset: Basic Name of the recording genre

Array of objects

Dataset: Basic
Object containing the artists information

Array

required

number

Dataset: Basic
ID of the artist

name

required

string

Dataset: Basic
Name of the artist

type

required

string

Enum: "MAIN" "OTHER"

Dataset: Basic
Type of the artist

Array of objects

Dataset: Basic
The roles of the artist on this recording

Array

id	number Dataset: Basic ID of the role
name	string Dataset: Basic Name of the role in english

Response samples

Content type

application/json

{"id": 49846,
"title": "Thunderstruck",
"subtitle": null,
"duration": "00:06:34",
"isrc": "AUAP09200021",
"hit": null,
"editors_pick": null,
"externals": {"musicbrainz": [464398
],
"lyricfind": [194658,
5244802
],
"spotify": ["1DstlcbjaI2vjyJNNW7leT",
"1DstlcbjaI2vjyJNNW7leT"
],
"deezer": [92722920,
92720126
],
"napster": ["613f6c61b98e619b681d0f28",
"613f801ab98e619b68c841bf",
"610034875",
"609221422",
"190835078",
"190834549"
],
"qobuz": [19912668,
19907823,
19907940
],
"apple": [575992085,
575997835,
579533232
],
"sevendigital": [40266621,
40267569
],
"linemusic": ["mt000000000074338d",
"mt00000000007431eb"
]
},
"translated": [{"lang": "ja",
"title": "サンダーストラック",
"subtitle": null
}
],
"related_isrcs": null,
"genre": {"id_genre": 32,
"name": "Hard rock"
},
"artists": [{"id": 100115,
"name": "AC/DC",
"type": "MAIN",
"roles": [{"id": 123,
"name": "Singer"
}
]
}
]
}

/api/recording/{id}/audiodescriptions

Descriptors calculated with Simbals technology

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Recording

Responses

Response Schema: application/json

absolute_loudness

number

Dataset: Audio
Related to the perceived intensity of the audio signal

arousal

number

Dataset: Audio
Perceptual measure related to intensity, energy and activity. High value usually corresponds to high energy track (hard rock, metal). Low value is given to calm tracks (slow, ballad).

articulation

number

Dataset: Audio
Indicates whether a track contains sounds with staccato articulation. High value corresponds to tracks with a lot of fast notes, arpeggiators for example. Low value is related to relaxed tracks with long sustained notes, electronic textures for example.

binary

number

Dataset: Audio
Rhythmic property of the track. Do listeners perceive the rhythm of the track binary or not (ternary for example) The higher the value, the higher the probability for the track to be binary.

bpm

number

Dataset: Audio
BPM of the recording

brightness

number

Dataset: Audio
The impression of brightness of a sound/music.

centroid

number

Dataset: Audio
Indicates where the center of mass of the spectrum is located.

chroma01

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma02

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma03

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma04

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma05

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma06

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma08

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma09

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma10

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma11

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

chroma12

number

Dataset: Audio
The chroma coefficients are the energy of the spectrum projected onto 12 bins representing the 12 distinct semitones of the musical octave.

complexity

number

Dataset: Audio
Rhythmic complexity of the track, i.e. the difficulty to repeat by tapping or to find the meter. The higher the value, the more complex the perceived rhythm is.

complexity_chroma

number

Dataset: Audio
Related to the noisiness of the chroma representation. A high value indicates a track with complex tonal properties, while a low value indicates simple tonal properties.

danceability

number

Dataset: Audio
Indicates if a track is likely to be considered for dancing (perception of tempo and rhythm, stability and regularity). High value corresponds to more danceable tracks. Low value is related to tracks without any perceptual rhythm.

dissonance

number

Dataset: Audio
Indicates how dissonant is a track. High value corresponds to tracks without clear harmony, noisy timbre for example, or with very complex harmonies (dissonant intervals such as tritones, seconds, etc). Low value corresponds to tracks with simple harmony, clear melody, consonant harmonies (simple piano melodies for example).

electric_acoustic

number

Dataset: Audio
Indicates whether the track contains acoustic content. High value corresponds to acoustic tracks (acoustic guitar/piano, voice, classical music). Low value indicates tracks with electric content (electronic, distortion, audio effects).

event_density

number

Dataset: Audio
Number of percussive events per time unit, i.e. the speed of the track. A track with a high event density contains fast musical events (notes or percussion) A track with low event density is generally made of slow/sustained notes.

flatness

number

Dataset: Audio
Provides a way to quantify how tone-like a sound is, as opposed to being noise-like. Tonal signals tend to have a small value, while noisy signals tend to have a high value.

intensity

number

Dataset: Audio
Related to the intensity of the audio signal.

loudness

number

Dataset: Audio
Related to the normalized perceived intensity of the audio signal.

loudness_range

number

Dataset: Audio
Related to the dynamic range of the audio signal.

melodicity

number

Dataset: Audio
Indicates whether a track contains or not a clearly audible melody. High value corresponds to pleasant, harmonic tracks, to which you feel like singing along.

Low value is more related to noises, soundscapes or tracks with complex harmonies or melodies (classical, jazz, etc).

mfcc01

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc02

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc03

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc04

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc05

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc06

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc07

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc08

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc09

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc10

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc11

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc12

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

mfcc13

number

Dataset: Audio
The MFCC represents the shape of the spectrum with very few coefficients.

Array of objects

Dataset: Audio
Array of object contains all moods of the recording

Array

name	string Dataset: Audio Name of the mood of the recording
value	number Dataset: Audio Weight of the mood of the recording

music_speech

number

Dataset: Audio
Indicates speech content in a track. High value is related to the presence of spoken words (interview, audio book, poetry, commentary). Low value probably corresponds to music, eventually with vocals (singing tracks), but without speech parts.

pulse_clarity

number

Dataset: Audio
Perception of tempo. If the tempo is clear and very stable, the value is high. Low value indicates a track without rhythm or with unstable tempo.

rhythmic_stability

number

Dataset: Audio
Perception of tempo. If the tempo is clear and very stable, the value is high. Low value indicates a track without rhythm or with unstable tempo.

roll_off

number

Dataset: Audio
Defined as the frequency under which 85% of the total energy of the spectrum is contained. It is correlated somehow to the harmonic/noise cutting frequency.

spread

number

Dataset: Audio
Defined as the spread of the spectrum around its mean value.

studio_live

number

Dataset: Audio
Indicates the probability that the track has been performed live. High value corresponds to live tracks. Low value is more probably related to studio recordings.

themes

Array of strings

Dataset: Audio
String table contains all themes of the recording

timbres

Array of strings

Dataset: Audio
String table contains all timbres of the recording

valence

number

Dataset: Audio
Perceptual measure of mood, related to positive or negative feelings, for example joy/sadness. High value corresponds to track with positive feelings. Low value refers to sad tracks.

vocal_instrumental

number

Dataset: Audio
Indicates whether a track contains or not vocals. High value indicates that the track probably contains no vocal sounds (instrumental) Low value probably corresponds to track with vocal content (singing words, rap, slam or speech for example).

zero_cross_rate

number

Dataset: Audio
Number of times the signal value crosses the zero axe. Noisy sounds tend to have a high value, whereas periodic sounds tend to have a small value.

Response samples

Content type

application/json

{"absolute_loudness": -17.017862,
"arousal": 0.37747,
"articulation": 0.35062,
"binary": 0.868598,
"bpm": 146,
"brightness": 0.158628,
"centroid": 2778.38969,
"chroma01": 8658,
"chroma02": 3481,
"chroma03": 10443,
"chroma04": 3288,
"chroma05": 2751,
"chroma06": 9074,
"chroma08": 6639,
"chroma09": 2315,
"chroma10": 10069,
"chroma11": 6586,
"chroma12": 1820,
"complexity": 0.535129,
"complexity_chroma": 0.272727,
"danceability": 0.30291,
"dissonance": 0.41116,
"electric_acoustic": 0.29396,
"event_density": 0.054121,
"flatness": 0.178921,
"intensity": 0.112553,
"loudness": -17.55953,
"loudness_range": 13.602145,
"melodicity": 0.6386,
"mfcc01": -9.155933,
"mfcc02": 3.140339,
"mfcc03": -0.973053,
"mfcc04": 0.531556,
"mfcc05": -0.206241,
"mfcc06": -0.383538,
"mfcc07": -0.100084,
"mfcc08": -0.1996,
"mfcc09": -0.526851,
"mfcc10": -0.162105,
"mfcc11": -0.491767,
"mfcc12": -0.176531,
"mfcc13": -0.180867,
"moods": [{"name": "Sad",
"value": 0.88
}
],
"music_speech": 0.06266,
"pulse_clarity": 0.109689,
"rhythmic_stability": 0.42617,
"roll_off": 1507.72772,
"spread": 3330.485295,
"studio_live": 0.19556,
"themes": ["Teen"
],
"timbres": ["Vocal",
"Electric"
],
"valence": 0.12499,
"vocal_instrumental": 0.07184,
"zero_cross_rate": 0.057647
}

/api/recording/{id}/lyric

Get Lyric of the recording

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Recording

Responses

Response Schema: application/json

id_recording

required

number

Dataset: Lyrics
ID of the recording

lfid

required

string

Dataset: Lyrics
Lyricfind ID

title

string

Dataset: Lyrics
Title of the recording

hfa_code

string

Dataset: Lyrics
Harry Fox Agency code

publisher_credit

Array of strings

Dataset: Lyrics
String table of publisher

territories

required

Array of strings

Dataset: Lyrics
Sting table of country in two-letter code, following the ISO 3166-1 alpha-2 standard

language

string

Dataset: Lyrics
Language of lyrics

language_code

string

Dataset: Lyrics
Language code of lyrics, following ISO-639 standard

lyric

string

Dataset: Lyrics
Lyrics of the recording

Array of objects

Object table contains lyrics synchronization

Array

line	string Dataset: Lyrics Part of lyrics
duration	string Dataset: Lyrics Duration in milliseconds of part of lyrics
milliseconds	string Dataset: Lyrics Position in milliseconds of part of lyrics
lrc_timestamp	string Dataset: Lyrics Position in time format HH:MM:SS

Array of objects

Dataset: Lyrics
Object table contains translations

Array

Array of objects

Dataset: Lyrics
Object table contains translation lyrics synchronization

Array

line	string Dataset: Lyrics Part of translation
duration	string Dataset: Lyrics Duration in milliseconds of part of translation
milliseconds	string Dataset: Lyrics Position in milliseconds of part of translation
lrc_timestamp	string Dataset: Lyrics Position in time format HH:MM:SS

lyric

string

Dataset: Lyrics
Lyrics of translation

language

string

Dataset: Lyrics
Language of translation

Response samples

Content type

application/json

{"id_recording": 5315027,
"lfid": "002-19",
"title": "Brother",
"hfa_code": "B7605R",
"publisher_credit": ["BMG Rights Management"
],
"territories": ["UG",
"DZ"
],
"language": "English",
"language_code": "EN",
"lyric": "Ooh ooh ooh oh\r\nOoh ooh ooh\r\n\r\nSleep now under my skin\r\nMake sure you'll try to\r\nConjure the wind\r\nAnd ease my mind\r\n\r\nOoh ooh ooh oh\r\nOoh ooh ooh\r\n\r\nSomebody call out to your brother\r\nHe's calling out your name\r\nOh oh oh\r\nHiding under the covers\r\nWith no one else to blame\r\nOh oh oh\r\nYou couldn't help out your own neighbor\r\nYou couldn't tell it to his face\r\nYou were fucked up by the blame\r\n\r\nYou cower in the corner\r\nConfide in your father\r\nLet it out and say\r\nLet it pass away\r\n\r\nSleep now under my skin\r\nMake sure you try to\r\nConjure the wind\r\nAnd ease my mind\r\n\r\nAnd I said\r\nOoh ooh ooh oh\r\nOoh ooh ooh\r\n\r\nSomebody call out to your brother\r\nHe's calling out your name\r\nOh oh oh\r\nHiding under the covers\r\nWith no one else to blame\r\nOh oh oh\r\nYou couldn't help out your own neighbor\r\nYou couldn't tell it to his face\r\nYou were fucked up by the blame\r\n\r\nYou cower in the corner\r\nConfide in your father\r\nLet it out and say\r\n\r\nYou cower in the corner\r\nConfide in your father\r\nLet it break your day\r\nLet it out and say\r\n\r\nWait there\r\nPull yourself out of this state dear\r\nAcknowledge you were a fake here\r\nFrom there on you might just grow\r\nOh oh oh\r\n\r\nSomebody call out to your brother\r\nHe's calling out your name\r\nOh oh oh\r\nHiding under the covers\r\nWith no one else to blame\r\nOh oh oh\r\nOh, you couldn't help out your own neighbor\r\nYou couldn't tell it to his face\r\nYou were fucked up by the blame",
"lrc": [{"line": "Ooh ooh ooh oh",
"duration": "9010",
"milliseconds": "10",
"lrc_timestamp": "[00:00.01]"
}
],
"translations": [{"lrc": [{"line": "Ooh ooh ooh oh",
"duration": "9010",
"milliseconds": "10",
"lrc_timestamp": "[00:00.01]"
}
],
"lyric": "Ooh ooh ooh oh\nOoh ooh ooh\n\nDors maintenant sous ma peau\nAssure-toi d'essayer de\nConjurer le vent\nEt apaiser mon esprit\n\nOoh ooh ooh oh\nOoh ooh ooh\n\nQuelqu'un appelle ton frère\nIl appelle ton nom\nOh oh oh\nSe cachant sous les couvertures\nAvec personne d'autre à blâmer\nOh oh oh\nTu n'as pas pu aider ton propre voisin\nTu ne pouvais pas le lui dire en face\nTu étais foutu par le blâme\n\nTu te blottis dans le coin\nConfie-toi à ton père\nLaisse sortir et dis\nLaisse passer\n\nDors maintenant sous ma peau\nAssure-toi d'essayer de\nConjurer le vent\nEt apaiser mon esprit\n\nEt j'ai dit\nOoh ooh ooh oh\nOoh ooh ooh\n\nQuelqu'un appelle ton frère\nIl appelle ton nom\nOh oh oh\nSe cachant sous les couvertures\nAvec personne d'autre à blâmer\nOh oh oh\nTu n'as pas pu aider ton propre voisin\nTu ne pouvais pas le lui dire en face\nTu étais foutu par le blâme\n\nTu te blottis dans le coin\nConfie-toi à ton père\nLaisse sortir et dis\n\nTu te blottis dans le coin\nConfie-toi à ton père\nLaisse briser ta journée\nLaisse sortir et dis\n\nAttends là\nSors-toi de cet état cher\nReconnais que tu étais un faux ici\nA partir de là, tu pourrais juste grandir\nOh oh oh\n\nQuelqu'un appelle ton frère\nIl appelle ton nom\nOh oh oh\nSe cachant sous les couvertures\nAvec personne d'autre à blâmer\nOh oh oh\nOh, tu n'as pas pu aider ton propre voisin\nTu ne pouvais pas le lui dire en face\nTu étais foutu par le blâme",
"language": "French"
}
]
}

/api/recording/{id}/popularity

Get Music Story recording popularity

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Recording

Responses

Response Schema: application/json

type

required

string

Dataset: Popularity
The most representative type of popularity for a recording

peak

required

number

Dataset: Popularity
Most representative date in years

object

Dataset: Popularity
Object contains global info of popularity of the recording

score required	number [ 0 .. 100 ] Dataset: Popularity Global score in percent of the recording
rank	number Dataset: Popularity Global rank of the recording

object

Dataset: Popularity
Object contains catalog info of popularity of the recording

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Score in percent of the recording

rank

number

Dataset: Popularity
Catalog rank of the recording

Array of objects

Dataset: Popularity
Object table contains all details of catalog popularity per year

Array

year	number Dataset: Popularity Year of popularity
charts_used	number Dataset: Popularity Number of charts used to calculate popularity
rank	number Dataset: Popularity Rank of the recording
score	number [ 0 .. 100 ] Dataset: Popularity Score in percent of the recording
best_rank	number Dataset: Popularity Best rank of the recording in charts
best_country_code	string Dataset: Popularity Two-letter code of the country where the recording reached its best rank, following the ISO 3166-1 alpha-2 standard, or null if the rank was reached in multiple countries
best_country_name	string Dataset: Popularity Name of the country where the recording reached its best rank, or “International” if the rank was reached in multiple countries

Array of objects

Dataset: Popularity
Object table contains all details of catalog popularity by country

Array

code	string Dataset: Popularity Two-letter code of country, following the ISO 3166-1 alpha-2 standard
name	string Dataset: Popularity Name of the country
charts_used	number Dataset: Popularity Number of charts used to calculate popularity
rank	number Dataset: Popularity Rank of the recording
score	number [ 0 .. 100 ] Dataset: Popularity Score in percent of the recording
best_rank	number Dataset: Popularity Best rank of the recording
best_month	string Dataset: Popularity Best month of the recording
weeks_in_charts	number Dataset: Popularity Number of weeks in charts of the recording

object

Dataset: Popularity
Object contains current info of popularity of the recording

score

required

number [ 0 .. 100 ]

Dataset: Popularity
Score in percent of the recording

rank

number

Dataset: Popularity
Current rank of the recording

Array of objects

Dataset: Popularity
Object table contains all details of current popularity per month

Array

month	string Dataset: Popularity Month of popularity formatted as “YYYY-MM”
charts_used	number Dataset: Popularity Number of charts used to calculate popularity
rank	number Dataset: Popularity Rank of the recording
score	number [ 0 .. 100 ] Dataset: Popularity Score in percent of the recording
best_rank	number Dataset: Popularity Best rank of the recording in charts
best_country_code	string Dataset: Popularity Two-letter code of the country where the recording reached its best rank, following the ISO 3166-1 alpha-2 standard, or null if the rank was reached in multiple countries
best_country_name	string Dataset: Popularity Name of the country where the recording reached its best rank, or “International” if the rank was reached in multiple countries

Array of objects

Dataset: Popularity
Object table contains all details of current popularity by country

Array

code	string Dataset: Popularity Two-letter code of country, following the ISO 3166-1 alpha-2 standard
name	string Dataset: Popularity Name of the country
charts_used	number Dataset: Popularity Number of charts used to calculate popularity
rank	number Dataset: Popularity Rank of the recording
score	number [ 0 .. 100 ] Dataset: Popularity Score in percent of the recording
best_rank	number Dataset: Popularity Best rank of the recording
best_month	string Dataset: Popularity Best month of the recording
weeks_in_charts	number Dataset: Popularity Number of weeks in charts of the recording

Response samples

Content type

application/json

{"type": "gold",
"peak": 2020,
"global": {"score": 100,
"rank": 12
},
"catalog": {"score": 91.82650292692416,
"rank": 21,
"details_by_year": [{"year": 2019,
"charts_used": 2,
"rank": 1188,
"score": 41.8099044905603,
"best_rank": 11,
"best_country_code": "US",
"best_country_name": "United States of America"
}
],
"details_by_country": [{"code": "GB",
"name": "United Kingdom",
"charts_used": 1,
"rank": 17,
"score": 80.8438739278431,
"best_rank": 1,
"best_month": "2020-02-01",
"weeks_in_charts": 126
}
]
},
"current": {"score": 100,
"rank": 4,
"details_by_month": [{"month": "2020-01",
"charts_used": 51,
"rank": 24,
"score": 90.93492145471068,
"best_rank": 1,
"best_country_code": null,
"best_country_name": "International"
}
],
"details_by_country": [{"code": "AR",
"name": "Argentina",
"charts_used": 4,
"rank": 11,
"score": 100,
"best_rank": 6,
"best_month": "2021-06-01",
"weeks_in_charts": 71
}
]
}
}

/api/recording/{id}/charts

Get summary of a recording's appearances in charts

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Recording

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 500 Limit number

Responses

Response Schema: application/json

Array of objects

Array of object contains all charts of the recording

Array

Array of objects

Dataset: Chart
Array of object contains all charts of the recording

Array

id_charts	number Dataset: Chart Array of object contains all charts of the recording
name	string Dataset: Chart Array of object contains all charts of the recording
best_rank	number Dataset: Chart Array of object contains all charts of the recording
entry_date	string Dataset: Chart Array of object contains all charts of the recording

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"results": [{"id_charts": 5,
"name": "Top 100 Deezer - France",
"best_rank": 2,
"entry_date": "2022-04-02"
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/recording/{idRecording}/charts/{idCharts}

Get details of a recording's appearances in charts

Authorizations:

Bearer

path Parameters

idRecording required	integer >= 0 ID of recording
idCharts required	integer >= 0 ID of charts

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 500 Limit number

Responses

Response Schema: application/json

Array of objects

Array of object contains all date with rank of this charts

Array

Array of objects

Dataset: Chart
Array of object contains all date with rank of this charts

Array

date	string Dataset: Chart Date of the chart for this recording
rank	number Dataset: Chart Rank of this recording on the chart

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"results": [{"date": "2023-11-10",
"rank": 90
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/recording/{id}/credits

Get credits of recording

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Recording

Responses

Response Schema: application/json

number

Dataset: Credit
ID of the recording

Array of objects

Dataset: Credit
Table of object containing the credits information

Array

parent_credit_name

string

Dataset: Credit
Name of parent credit

Array of objects

Dataset: Credit
Table of object child credits contains all childs credits

Array

credit_child_name

string

Dataset: Credit
Name of the child credit

Array of objects

Dataset: Credit
Table of object childs credits

Array

name	string Dataset: Credit Artist name of the credit
id_artist	number Dataset: Credit ID of the artist from the Music Story catalog

Response samples

Content type

application/json

{"id": 696211,
"data": [{"parent_credit_name": "Engineer",
"parent_credit": [{"credit_child_name": "Assistant Engineer",
"credit_child": [{"name": "David Gleeson",
"id_artist": 4754188
}
]
}
]
}
]
}

Shows

All endpoints to get shows data

/api/show

Search Music Story Shows

Authorizations:

Bearer

query Parameters

query required	string Name or ID of Show to search
type	integer Show-Type ID to filter results
artist	string Artist name to filter results
page	integer >= 1 Default: 1 Page number

Responses

Response Schema: application/json

Array of objects

Array

number

Dataset: Show
ID of the show

name

string

Dataset: Show
Title of the show

subtitle

string

Dataset: Show
Subtitle of the show

object

Dataset: Show
Type of the show

id	number Dataset: Show ID of the show's type
name	string Dataset: Show Name of the show's type

object

Dataset: Show
Album related to the show

id	number Dataset: Show ID of the show's related album
title	string Dataset: Show Title of the show's related album

Array of objects

Dataset: Show
Array of artists related to the album

Array

id	number Dataset: Show ID of the artist
name	string Dataset: Show Name of the artist

year

number

Dataset: Show
Year of the show

country

string

Dataset: Show
Country of representation of the show

area

string

Dataset: Show
Area of the show

description

string

Dataset: Show
Description of the show

score

number

Score related to the search

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 745,
"name": "Cats",
"subtitle": "2024 Paris Edition",
"type": {"id": 3,
"name": "Tour"
},
"album": {"id": 12345,
"title": "Cats 2024"
},
"artists": [{"id": 2278,
"name": "Paul Simon"
}
],
"year": 2024,
"country": "France",
"area": "Paris",
"description": "20th anniversary of Cats",
"score": "1"
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

/api/show/{id}

Get Music Story Show

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Show

Responses

Response Schema: application/json

number

Dataset: Show
ID of the show

name

string

Dataset: Show
Title of the show

subtitle

string

Dataset: Show
Subtitle of the show

object

Dataset: Show
Type of the show

id	number Dataset: Show ID of the show's type
name	string Dataset: Show Name of the show's type

object

Dataset: Show
Album related to the show

id	number Dataset: Show ID of the show's related album
title	string Dataset: Show Title of the show's related album

Array of objects

Dataset: Show
Array of artists related to the album

Array

id	number Dataset: Show ID of the artist
name	string Dataset: Show Name of the artist

year

number

Dataset: Show
Year of the show

country

string

Dataset: Show
Country of representation of the show

area

string

Dataset: Show
Area of the show

description

string

Dataset: Show
Description of the show

Response samples

Content type

application/json

{"id": 745,
"name": "Cats",
"subtitle": "2024 Paris Edition",
"type": {"id": 3,
"name": "Tour"
},
"album": {"id": 12345,
"title": "Cats 2024"
},
"artists": [{"id": 2278,
"name": "Paul Simon"
}
],
"year": 2024,
"country": "France",
"area": "Paris",
"description": "20th anniversary of Cats"
}

/api/show/{id}/pictures

Get Music Story Show Pictures

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Show

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number
format	Array of strings Items Enum: "1:1" "16:9" "all" Comma separated list of formats. When using multiple formats, the same id_picture may appear more than once, so it’s better to use id_picture_version.

Responses

Response Schema: application/json

Array of objects

Array

id_picture

number

id_picture_version

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
ID of the picture version (unique)

name

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Path of the picture

source

string

Enum: "Getty" "Music-Story" "Label"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Source of the picture

format

string

Enum: "1:1" "16:9"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Format of the picture

width

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Width of the picture in pixels

height

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Height of the picture in pixels

mimetype

string

Value: "image/jpeg"

Dataset: Picture-Getty / Picture-Curation / Picture-Label
MIME type of the picture

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Copyright of the picture

object

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Object containing the picture’s metadata

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label

quality_rank

number

Dataset: Picture-Getty / Picture-Curation / Picture-Label

title

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

date_created

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

date_submitted

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

orientation

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

collection_name

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

credit_line

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

license_model

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

artist

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label

editorial_segments

Array of strings

Dataset: Picture-Getty / Picture-Curation / Picture-Label

product_types

Array of strings

people

Array of strings

object

id	number Dataset: Picture-Getty / Picture-Curation / Picture-Label
name	string Dataset: Picture-Getty / Picture-Curation / Picture-Label

object

height	number Dataset: Picture-Getty / Picture-Curation / Picture-Label
width	number Dataset: Picture-Getty / Picture-Curation / Picture-Label

object

how_can_i_use_it	string Dataset: Picture-Getty / Picture-Curation / Picture-Label
release_info	string Dataset: Picture-Getty / Picture-Curation / Picture-Label
usage_restrictions	Array of strings Dataset: Picture-Getty / Picture-Curation / Picture-Label

Response samples

Content type

application/json

{"results": [{"id_picture": 22688,
"id_picture_version": 27190,
"name": "https://images.music-story.com/protected/pictures/XXX-YYY-UUID/XXX-YYY-UUID.jpg",
"source": "Getty",
"format": "1:1",
"width": 3799,
"height": 3799,
"mimetype": "image/jpeg",
"copyright": "Mark and Colleen Hayward / Redferns / Getty Images",
"metas": {"id": 453928681,
"quality_rank": 1,
"title": "George Harrison",
"date_created": "1965-01-01T00:00:00",
"date_submitted": "2013-12-04T11:04:39",
"orientation": "Vertical",
"collection_name": "Redferns",
"copyright": "1965 Mark and Colleen Hayward",
"credit_line": "Redferns",
"license_model": "rightsmanaged",
"artist": "Mark and Colleen Hayward",
"editorial_segments": ["archival",
"entertainment"
],
"product_types": ["premiumaccess"
],
"people": ["George Harrison"
],
"editorial_source": {"id": 22763,
"name": "Redferns"
},
"max_dimensions": {"height": 4206,
"width": 4179
},
"allowed_use": {"how_can_i_use_it": "Available for |Editorial uses|. |Learn more|",
"release_info": "Not released",
"usage_restrictions": ["Contact your |local office| for all commercial or promotional uses."
]
}
},
"tags": ["indoor",
"colour",
"2015-2020",
"high_quality"
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

Works

All endpoints to get works data

/api/work

Search Music Story work

Authorizations:

Bearer

query Parameters

query required	string Name of Work to search
iswc	string ISWC to filter results
ipi	string IPI to filter results
rightOwner	string Right Owner to filter results

Responses

Response Schema: application/json

Array of objects

Array

number

Dataset: Work
ID of the work

title

string

Dataset: Work
Title of the work

iswc

string

Dataset: Work
ISWC code of the work

hfa_code

string

Dataset: Work
HFA code of the work

Array of objects

Dataset: Work
Array of shares of the work

Array

number

Dataset: Work
ID of the share

ipi

number

Dataset: Work
IPI code of the share

name

string

Dataset: Work
Name of the share

role

string

Dataset: Work
Role of the share

number

Dataset: Work
Share of the work

Array of objects

Dataset: Work
Array of parent shares of the work

Array

id	number Dataset: Work ID of the share
ipi	number Dataset: Work IPI code of the share
name	string Dataset: Work Name of the share

isrcs

Array of strings

Dataset: Work
Array of ISRCs related to the work

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 124,
"title": "Let It Be",
"iswc": "T1234567890",
"hfa_code": "B12345",
"shares": [{"id": 16,
"ipi": 123456,
"name": "WC MUSIC CORP",
"role": "OriginalPublisher",
"share": 50,
"parent": [{"id": 16,
"ipi": 123456,
"name": "WC MUSIC CORP"
}
]
}
],
"isrcs": ["USUM70500758",
"USUM70500759"
]
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

Lyrics

All endpoints to get lyrics data

/api/lyrics

Get lyrics

Authorizations:

Bearer

query Parameters

query required	string Lyricfind ID or Title or Harry Fox Agency code of Lyric to search
page	integer >= 1 Default: 1 Page number

Responses

Response Schema: application/json

Array of objects

Array

id_recording

required

number

Dataset: Lyrics
ID of the recording

lfid

required

string

Dataset: Lyrics
Lyricfind ID

title

string

Dataset: Lyrics
Title of the recording

hfa_code

string

Dataset: Lyrics
Harry Fox Agency code

publisher_credit

Array of strings

Dataset: Lyrics
String table of publisher

territories

required

Array of strings

Dataset: Lyrics
Sting table of country in two-letter code, following the ISO 3166-1 alpha-2 standard

language

string

Dataset: Lyrics
Language of lyrics

language_code

string

Dataset: Lyrics
Language code of lyrics, following ISO-639 standard

lyric

string

Dataset: Lyrics
Lyrics of the recording

Array of objects

Object table contains lyrics synchronization

Array

line	string Dataset: Lyrics Part of lyrics
duration	string Dataset: Lyrics Duration in milliseconds of part of lyrics
milliseconds	string Dataset: Lyrics Position in milliseconds of part of lyrics
lrc_timestamp	string Dataset: Lyrics Position in time format HH:MM:SS

Array of objects

Dataset: Lyrics
Object table contains translations

Array

Array of objects

Dataset: Lyrics
Object table contains translation lyrics synchronization

Array

line	string Dataset: Lyrics Part of translation
duration	string Dataset: Lyrics Duration in milliseconds of part of translation
milliseconds	string Dataset: Lyrics Position in milliseconds of part of translation
lrc_timestamp	string Dataset: Lyrics Position in time format HH:MM:SS

lyric

string

Dataset: Lyrics
Lyrics of translation

language

string

Dataset: Lyrics
Language of translation

score

number

Score related to the search

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id_recording": 5315027,
"lfid": "002-19",
"title": "Brother",
"hfa_code": "B7605R",
"publisher_credit": ["BMG Rights Management"
],
"territories": ["UG",
"DZ"
],
"language": "English",
"language_code": "EN",
"lyric": "Ooh ooh ooh oh\r\nOoh ooh ooh\r\n\r\nSleep now under my skin\r\nMake sure you'll try to\r\nConjure the wind\r\nAnd ease my mind\r\n\r\nOoh ooh ooh oh\r\nOoh ooh ooh\r\n\r\nSomebody call out to your brother\r\nHe's calling out your name\r\nOh oh oh\r\nHiding under the covers\r\nWith no one else to blame\r\nOh oh oh\r\nYou couldn't help out your own neighbor\r\nYou couldn't tell it to his face\r\nYou were fucked up by the blame\r\n\r\nYou cower in the corner\r\nConfide in your father\r\nLet it out and say\r\nLet it pass away\r\n\r\nSleep now under my skin\r\nMake sure you try to\r\nConjure the wind\r\nAnd ease my mind\r\n\r\nAnd I said\r\nOoh ooh ooh oh\r\nOoh ooh ooh\r\n\r\nSomebody call out to your brother\r\nHe's calling out your name\r\nOh oh oh\r\nHiding under the covers\r\nWith no one else to blame\r\nOh oh oh\r\nYou couldn't help out your own neighbor\r\nYou couldn't tell it to his face\r\nYou were fucked up by the blame\r\n\r\nYou cower in the corner\r\nConfide in your father\r\nLet it out and say\r\n\r\nYou cower in the corner\r\nConfide in your father\r\nLet it break your day\r\nLet it out and say\r\n\r\nWait there\r\nPull yourself out of this state dear\r\nAcknowledge you were a fake here\r\nFrom there on you might just grow\r\nOh oh oh\r\n\r\nSomebody call out to your brother\r\nHe's calling out your name\r\nOh oh oh\r\nHiding under the covers\r\nWith no one else to blame\r\nOh oh oh\r\nOh, you couldn't help out your own neighbor\r\nYou couldn't tell it to his face\r\nYou were fucked up by the blame",
"lrc": [{"line": "Ooh ooh ooh oh",
"duration": "9010",
"milliseconds": "10",
"lrc_timestamp": "[00:00.01]"
}
],
"translations": [{"lrc": [{"line": "Ooh ooh ooh oh",
"duration": "9010",
"milliseconds": "10",
"lrc_timestamp": "[00:00.01]"
}
],
"lyric": "Ooh ooh ooh oh\nOoh ooh ooh\n\nDors maintenant sous ma peau\nAssure-toi d'essayer de\nConjurer le vent\nEt apaiser mon esprit\n\nOoh ooh ooh oh\nOoh ooh ooh\n\nQuelqu'un appelle ton frère\nIl appelle ton nom\nOh oh oh\nSe cachant sous les couvertures\nAvec personne d'autre à blâmer\nOh oh oh\nTu n'as pas pu aider ton propre voisin\nTu ne pouvais pas le lui dire en face\nTu étais foutu par le blâme\n\nTu te blottis dans le coin\nConfie-toi à ton père\nLaisse sortir et dis\nLaisse passer\n\nDors maintenant sous ma peau\nAssure-toi d'essayer de\nConjurer le vent\nEt apaiser mon esprit\n\nEt j'ai dit\nOoh ooh ooh oh\nOoh ooh ooh\n\nQuelqu'un appelle ton frère\nIl appelle ton nom\nOh oh oh\nSe cachant sous les couvertures\nAvec personne d'autre à blâmer\nOh oh oh\nTu n'as pas pu aider ton propre voisin\nTu ne pouvais pas le lui dire en face\nTu étais foutu par le blâme\n\nTu te blottis dans le coin\nConfie-toi à ton père\nLaisse sortir et dis\n\nTu te blottis dans le coin\nConfie-toi à ton père\nLaisse briser ta journée\nLaisse sortir et dis\n\nAttends là\nSors-toi de cet état cher\nReconnais que tu étais un faux ici\nA partir de là, tu pourrais juste grandir\nOh oh oh\n\nQuelqu'un appelle ton frère\nIl appelle ton nom\nOh oh oh\nSe cachant sous les couvertures\nAvec personne d'autre à blâmer\nOh oh oh\nOh, tu n'as pas pu aider ton propre voisin\nTu ne pouvais pas le lui dire en face\nTu étais foutu par le blâme",
"language": "French"
}
],
"score": "1"
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

Popularity

All endpoints to get popularity data

/api/popularity/artist

Get Music Story popularity recording

Authorizations:

Bearer

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number
id_genre	integer[1-9][0-9]* ID of Genre
month	string[1-9][0-9]{1,3}-[0-9]{2} Month of the year
year	integer[1-9][0-9]{1,3} Year
country_code	string[A-Z]{2} Country code

Responses

Response Schema: application/json

Array of objects

Array

object

id	number Dataset: Popularity ID of the artist
name	string Dataset: Popularity Name of the artist

genres

Array of any

Dataset: Popularity
Array containing the artist's genres

month

string

Dataset: Popularity
Month of popularity formatted as “YYYY-MM”

year

number

Dataset: Popularity
Year of popularity formatted as “YYYY”

country_code

string

Dataset: Popularity
Two-letter code of the artist’s country, following the ISO 3166-1 alpha-2 standard

popularity

number

Dataset: Popularity
Global score in percent of the artist

rank

number

Dataset: Popularity
Global rank of the artist

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"artist": {"id": 16,
"name": "Lou Reed"
},
"genres": [null
],
"month": "2020-01",
"year": "2020",
"country_code": "FR",
"popularity": 100,
"rank": 1
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/popularity/recording

Get Music Story popularity recording

Authorizations:

Bearer

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number
id_genre	integer[1-9][0-9]* ID of Genre
month	string[1-9][0-9]{1,3}-[0-9]{2} Month of the year
year	integer[1-9][0-9]{1,3} Year
country_code	string[A-Z]{2} Country code

Responses

Response Schema: application/json

Array of objects

Array

Array of objects

Array

object

id	number Dataset: Popularity ID of the recording
title	string Dataset: Popularity Title of the recording

genres

Array of any

Dataset: Popularity
Array containing the recording's genres

month

string

Dataset: Popularity
Month of popularity formatted as “YYYY-MM”

year

number

Dataset: Popularity
Year of popularity formatted as “YYYY”

country_code

string

Dataset: Popularity
Two-letter code of the recording’s country, following the ISO 3166-1 alpha-2 standard

popularity

number

Dataset: Popularity
Global score in percent of the artist

rank

number

Dataset: Popularity
Global rank of the artist

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"results": [{"recording": {"id": 16,
"title": "Lou Reed"
},
"genres": [null
],
"month": "2020-01",
"year": "2020",
"country_code": "FR",
"popularity": 100,
"rank": 1
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

Genres

All endpoints to get genres data

/api/genre

Get Music Story genres

Authorizations:

Bearer

query Parameters

id_parent	integer ID of Parent genre
offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the genre

name

required

string

Dataset: Basic
Name of the genre in english

Array of objects

Dataset: Basic
Array containing the genre translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
name	string Dataset: Basic Name of the genre in other languages

object

Dataset: Basic
Object containing parent genre

id_genre	number Dataset: Basic ID of the parent genre
name	string Dataset: Basic Name of the parent genre

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 1193,
"name": "Electronica",
"translated": [{"lang": "JA",
"name": "エレクトロニカ"
}
],
"parent_genre": {"id_genre": 66,
"name": "Electro"
}
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/genre/{id}

Get Music Story genre

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Genre

Responses

Response Schema: application/json

required

number

Dataset: Basic
ID of the genre

name

required

string

Dataset: Basic
Name of the genre in english

Array of objects

Dataset: Basic
Array containing the genre translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
name	string Dataset: Basic Name of the genre in other languages

object

Dataset: Basic
Object containing parent genre

id_genre	number Dataset: Basic ID of the parent genre
name	string Dataset: Basic Name of the parent genre

Response samples

Content type

application/json

{"id": 1193,
"name": "Electronica",
"translated": [{"lang": "JA",
"name": "エレクトロニカ"
}
],
"parent_genre": {"id_genre": 66,
"name": "Electro"
}
}

/api/genre/{id}/artists

Get Music Story genre top artists ordered by popularity

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Genre

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

id	number Dataset: Basic ID of the artist
name	string Dataset: Basic Full name of the artist
complementary	string Dataset: Basic Complementary of the artist
type	string Enum: "Person" "Band" Dataset: Basic Type of artist
country_code	string Dataset: Basic Two-letter code of the artist’s country, following the ISO 3166-1 alpha-2 standard
country_name	string Dataset: Basic Name of the artist’s country
role	string Dataset: Basic Role of artist

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 1095,
"name": "Ryuichi Sakamoto",
"complementary": "1952-2023",
"type": "Person",
"country_code": "JP",
"country_name": "Japan",
"role": "Composer"
}
],
"offset": 0,
"limit": 20,
"total": 45
}

Roles

All endpoints to get roles data

/api/role

Get Music Story roles

Authorizations:

Bearer

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the role

name

required

string

Dataset: Basic
Name of the role in english

Array of objects

Dataset: Basic
Array containing the role translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
name	string Dataset: Basic Name of the role in other languages

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 1,
"name": "Lyricist",
"translated": [{"lang": "JA",
"name": "作詞家"
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/role/{id}

Get Music Story role

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Role

Responses

Response Schema: application/json

required

number

Dataset: Basic
ID of the role

name

required

string

Dataset: Basic
Name of the role in english

Array of objects

Dataset: Basic
Array containing the role translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
name	string Dataset: Basic Name of the role in other languages

Response samples

Content type

application/json

{"id": 1,
"name": "Lyricist",
"translated": [{"lang": "JA",
"name": "作詞家"
}
]
}

Countries

All endpoints to get countries data

/api/country

Get Music Story countries

Authorizations:

Bearer

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Basic
ID of the country

name

required

string

Dataset: Basic
Name of the country in english

code

string

Dataset: Basic
Code (alpha-2) representing the country

Array of objects

Dataset: Basic
Array containing the country translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
name	string Dataset: Basic Name of the country in other languages

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 16,
"name": "Australia",
"code": "AU",
"translated": [{"lang": "JA",
"name": "オーストラリア"
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/country/{id}

Get Music Story country

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of Country

Responses

Response Schema: application/json

required

number

Dataset: Basic
ID of the country

name

required

string

Dataset: Basic
Name of the country in english

code

string

Dataset: Basic
Code (alpha-2) representing the country

Array of objects

Dataset: Basic
Array containing the country translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
name	string Dataset: Basic Name of the country in other languages

Response samples

Content type

application/json

{"id": 16,
"name": "Australia",
"code": "AU",
"translated": [{"lang": "JA",
"name": "オーストラリア"
}
]
}

Charts

All endpoints to get charts data

/api/charts

Get Music Story charts

Authorizations:

Bearer

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

id required	number Dataset: Chart ID of the charts
name required	string Dataset: Chart Name of the charts
area required	string Dataset: Chart Area name of charts
source required	string Dataset: Chart Source name of charts
official required	boolean Dataset: Chart Official charts information
country_code required	string Dataset: Chart Two-letter code of the artist’s country, following the ISO 3166-1 alpha-2 standard

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 5,
"name": "Top 100 Deezer - France",
"area": "Europe",
"source": "DEEZER",
"official": false,
"country_code": "FR"
}
],
"offset": 0,
"limit": 20,
"total": 45
}

Show types

All endpoint to get show types data

/api/show-type

Get Music Story Show Types

Authorizations:

Bearer

query Parameters

offset	integer >= 0 Default: 0 Offset number
limit	integer >= 0 Default: 20 Limit number

Responses

Response Schema: application/json

Array of objects

Array

required

number

Dataset: Show
ID of the Show Type

name

required

string

Dataset: Show
Name of the Show Type in english

Array of objects

Dataset: Show
Array containing the Show Type translated names

Array

lang	string Dataset: Show Language of the translated name, following ISO-639 standard
name	string Dataset: Show Name of the Show Type in other languages

offset

number

limit

number

total

number

Response samples

Content type

application/json

{"results": [{"id": 1,
"name": "Tour",
"translated": [{"lang": "FR",
"name": "Tournée"
}
]
}
],
"offset": 0,
"limit": 20,
"total": 45
}

/api/show-type/{id}

Get Music Story Show Type

Authorizations:

Bearer

path Parameters

required

integer[1-9][0-9]*

ID of the Show Type

Responses

Response Schema: application/json

required

number

Dataset: Show
ID of the Show Type

name

required

string

Dataset: Show
Name of the Show Type in english

Array of objects

Dataset: Show
Array containing the Show Type translated names

Array

lang	string Dataset: Show Language of the translated name, following ISO-639 standard
name	string Dataset: Show Name of the Show Type in other languages

Response samples

Content type

application/json

{"id": 1,
"name": "Tour",
"translated": [{"lang": "FR",
"name": "Tournée"
}
]
}

Artist Title

Endpoint to get artist title data

/api/artist-title

This endpoint has been specially designed to search for a recording by title and artist name. It is optimized to handle variations in artist and title typography (artist aliases, artist translated names, artist first and last name inversions, typos, incomplete title names, etc.). This is a typical use case for a radio playlist search for example.

Authorizations:

Bearer

query Parameters

name required	string Name of artist
title required	string Title of song
page	integer >= 1 Default: 1 Page number

Responses

Response Schema: application/json

Array of objects

Array

number

Dataset: Basic
ID of the recording

title

string

Dataset: Basic
Title of the recording

subtitle

string

Dataset: Basic
Subtitle of the recording

language

string

Dataset: Basic
Language of the recording

language_code

string

Dataset: Basic
Language of the recording, following ISO-639 standard

Array of objects

Dataset: Basic
Array containing the recording’s translated names

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
title	string Dataset: Basic Title of the recording translation
subtitle	string Dataset: Basic Subtitle of the recording translation

duration

string

Dataset: Basic
Duration of the recording, with format “HH:MM:SS”

isrc

string

Dataset: Basic
ISRC of the recording

object

name	string Dataset: Basic Name of the recording genre
id_genre	number Dataset: Basic ID of the recording genre

hit

number

Dataset: Basic
Rating if the recording has been in the charts

editors_pick

number

Dataset: Basic
Rating if the recording is recommended by the Music Story editorial team

score

number

Dataset: Basic
Score related to the search

Array of objects

Dataset: Basic
Array containing the artists

Array

number

Dataset: Basic
ID of the artist

name

string

Dataset: Basic
Full name of the artist

real_firstname_lastname

string

Dataset: Basic
Real name of the artist

Array of objects

Dataset: Basic
Array containing the artists aliases

Array

link	string Enum: "Alias" "Nickname" Dataset: Basic Type of alias
alias	string Dataset: Basic Alias

Array of objects

Dataset: Basic
Array containing the artists translated name

Array

lang	string Dataset: Basic Language of the translated name, following ISO-639 standard
name	string Dataset: Basic Name of the artist in other languages

type

string

Enum: "Person" "Band"

Dataset: Basic
Type of artist

picture

string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Path of the picture

Array of objects

Dataset: Basic
Array containing the artists genres

Array

link	string Enum: "Main" "Principal" "Secondary" "Influence" Dataset: Basic Relation type
name	string Dataset: Basic Name of the genre
id_genre	number Dataset: Basic ID of the genre

popularity

number

Dataset: Popularity
Popularity in percent of the artist

Array of objects

Dataset: Basic
Array containing the albums

Array

number

Dataset: Basic
ID of the album

title

string

Dataset: Basic
Title of the album

label

string

Dataset: Basic
Label of the album

distributor

string

Dataset: Basic
Distributor of the album

type

string

Enum: "ORIGINAL" "LIVE" "COMPILATION" "KARAOKE" "RING" "OTHER"

Dataset: Basic
Type of album

format

string

Enum: "ALBUM" "EP" "SINGLE" "MCD" "MIXTAPE"

Dataset: Basic
Format of the album

original_release_date

string

Dataset: Basic
Original release date of the album, with format “YYYY-MM-DD”. The value of “DD” and “MM” may be “00” if the day or month is unknown.

cover_art

string

Dataset: Artwork
Path of the cover art

cover_art_400

string

Dataset: Artwork
Path 400 of the cover art

Array of objects

Dataset: Basic
Array containing the albums genres

Array

id_genre	number Dataset: Basic ID of the genre
name	string Dataset: Basic Name of the genre

popularity

number

Dataset: Popularity
Popularity in percent of the recording

page

number

totalPages

number

totalHits

number

Response samples

Content type

application/json

{"hits": [{"id": 37782,
"title": "Time Is Running Out",
"subtitle": "Muse",
"language": "English",
"language_code": "EN",
"translated": [{"lang": "ja",
"title": "タイム・イズ・ランニングアウト",
"subtitle": null
}
],
"duration": "00:03:57",
"isrc": "GBCVT0300078",
"genre": {"name": "UK alternative rock",
"id_genre": 197
},
"hit": 4,
"editors_pick": null,
"score": 1,
"artists": [{"id": 100408,
"name": "Muse",
"real_firstname_lastname": null,
"aliases": null,
"translated": [{"lang": "AR",
"name": "ميوز"
}
],
"type": "Band",
"picture": "https://images.music-story.com/protected/pictures/XXX-YYY-UUID/XXX-YYY-UUID.jpg",
"genres": [{"link": "Main",
"name": "Rock",
"id_genre": 1
}
],
"popularity": 47.0420646855061
}
],
"albums": [{"id": 305942,
"title": "Time is Running Out",
"label": "Warner",
"distributor": null,
"type": "ORIGINAL",
"format": "SINGLE",
"original_release_date": "2003-09-08",
"cover_art": "https://images.music-story.com/download/cover_art/curation/original/3/7/1/0/XXX-YYY-UUID.jpg",
"cover_art_400": "https://images.music-story.com/download/cover_art/curation/400/3/7/1/0/XXX-YYY-UUID.jpg",
"genres": [{"id_genre": 197,
"name": "UK alternative rock"
}
]
}
],
"popularity": 35.92706247216542
}
],
"page": 1,
"totalPages": 50,
"totalHits": 1000
}

Recommendation

Endpoint to get recommendation data

/api/recommendation

This endpoint has been specially designed to create a playlist from one or more artist names and/or one or more track names. The results are based on our editorial work, including links between artists, genres and the artist's universe, etc. You can also fine-tune the results using our audio descriptors such as moods, BPM etc.

Only one of ms_track_ids or ms_artist_ids is required

Authorizations:

Bearer

query Parameters

ms_track_ids	string Number or comma separated list of number One or a list of Music Story Track ID
ms_artist_ids	string Number or comma separated list of number One or a list of Music Story Artist ID
audio_bpm	integer [ 1 .. 3 ] Default: null Required BPM level [ 1:low, 2:medium or 3:high ]
audio_arousal	integer [ 1 .. 3 ] Default: null Required Arousal level [ 1:low, 2:medium or 3:high ]
audio_valence	integer [ 1 .. 3 ] Default: null Required Valence level [ 1:low, 2:medium or 3:high ]
audio_intensity	integer [ 1 .. 3 ] Default: null Required Intensity level [ 1:low, 2:medium or 3:high ]
audio_moods	string Default: null String or comma separated list of string One or several moods
year_range	integer [ 1 .. 100 ] Default: 5 Years of recommendation range in more or less compared to given ID Tracks
results_nb	integer [ 10 .. 500 ] Default: 500 Number of results - number [ 10 .. 500 ]
min_accuracy	integer [ 0 .. 100 ] Default: 32 Minimum accuracy for selection of corresponding artists - number [ 0 .. 100 ]
order_by	string Default: null Order by results [ match, popularity or random ]

Responses

Response Schema: application/json

Array of objects

Dataset: API Recommendation
Array containing recommended tracks

Array

number

Dataset: API Recommendation
ID of the recording

match

number

Dataset: API Recommendation
Recommendation result relevance score

title

string

Dataset: API Recommendation
Title of the recording

subtitle

string

Dataset: API Recommendation
Subtitle of the recording

object

id_genre	number Dataset: API Recommendation Genre of the recording
name	string Dataset: API Recommendation Genre of the recording

popularity

number

Dataset: API Recommendation
Popularity score of the recording

Array of objects

Dataset: API Recommendation
Array containing artists information related to the recording

Array

id_artist	number Dataset: API Recommendation ID of the artist
name	string Dataset: API Recommendation Name of the artist

Array of objects

Dataset: API Recommendation
Array containing the features audio of the recording

Array

bpm

string

Dataset: API Recommendation
BPM value of the recording

Array of objects

Dataset: API Recommendation
Moods of the recording

Array

value	number Dataset: API Recommendation Mood value of the recording
name	string Dataset: API Recommendation Mood name of the recording

arousal

string

Dataset: API Recommendation
Arousal of the recording

valence

string

Dataset: API Recommendation
Valence of the recording

intensity

string

Dataset: API Recommendation
Intensity of the recording

object

Dataset: API Recommendation
Original album of the recording

id	number Dataset: API Recommendation Original album ID of the recording
title	string Dataset: API Recommendation Original album title of the recording
original_release_date	string Dataset: API Recommendation Original release date of the recording

Response samples

Content type

application/json

{"recording": [{"id": 9036384,
"match": 0.8947930483968929,
"title": "Thunderstruck",
"subtitle": null,
"genre": {"id_genre": 1,
"name": "Rock"
},
"popularity": 0.7369826209922324,
"artists": [{"id_artist": 100115,
"name": "AC/DC"
}
],
"audiodescriptions": [{"bpm": "67",
"moods": [{"value": 1,
"name": "Energetic"
}
],
"arousal": "0.73063",
"valence": "0.28747",
"intensity": "0.189142"
}
],
"original_album": {"id": 4038,
"title": "The Razor's Edge",
"original_release_date": "1979-07-27"
}
}
]
}

Report

Endpoint to get report data

/report/picture/usage

Use this endpoint to report the usages of a set of pictures. The count of pictures submitted in a single batch to this endpoint is limited to 1000

Authorizations:

Bearer

Request Body schema: application/json
required

id_transaction

required

integer > 0

This transaction id is for us to track your transaction

required

Array of objects [ 1 .. 1000 ] items

Array ([ 1 .. 1000 ] items)

id_picture required	integer
count required	integer

Responses

Request samples

Payload

Content type

application/json

{"id_transaction": 1,
"assets": [{"id_picture": 1,
"count": 1
}
]
}

Response samples

Content type

application/json

{"errors": [{"type": "Syntax error",
"message": "Request payload contains invalid `json` data."
}
]
}

Health

Endpoint to get health data

/health

Use this endpoint to know if the api is available

Responses

Response Schema: application/json

status

string

API status

Response samples

Content type

application/json

{"status": "available"
}

Monitoring

Endpoint to get monitoring data

/user/api/status

Use this point to find out where the user is in his use of the api

Responses

Response Schema: application/json

X-Rate-Limit-Remaining	number Dataset: Basic The number of requests remaining in the current ratelimit window
X-Rate-Limit-Limit	number Dataset: Basic The maximum number of requests that can be made per day
X-Rate-Limit-Retry-After	number Dataset: Basic The time in seconds until the ratelimit window resets

Response samples

Content type

application/json

{"X-Rate-Limit-Remaining": 185,
"X-Rate-Limit-Limit": 200,
"X-Rate-Limit-Retry-After": 0
}