Skip to main content
API docs by Redocly

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:

Getting started with our API

The first step is to create an account to the Music Story platform called the Metadata Monitor.

More than a visual version of the metadata available in our API, the Metadata Monitor gives you access to a dedicated API section with services like:

  • An overview of the number of API calls
  • Access to your token
  • Information about API status
  • An access to contact our teams for support

How can I test the API?

You can create a 15-day trial account. It will automatically generate a token giving you access to the API for the same time frame. You'll be able to access any endpoint in our API, but you'll be limited to 200 calls per day.

How can I get premium access?

You can contact us at musicstorypro@music-story.com in order to get a premium account and together we'll be able to customize your access to our different endpoints and the rate limit according to your needs.

Authorization

This api uses access tokens to validate the permissions of each request.

To do this, you must have an account on the metadata monitor. You can create a token in the "API Keys" section of your user profile or your organization's settings.

To use it, use the Authorization header with the bearer method.

Here's an example using curl

curl -X GET \
  https://api.v2.music-story.com/api/artist?query=Muse \
  -H 'Authorization: Bearer YOUR_TOKEN_HERE'

Rate limiting

With a metadata monitor account, by default (Trial account) you are allowed 200 requests per day. (Fixed window method) Once this quota has been reached, you will receive an HTTP status code 429 - Too Many Requests If this happens too often, you can contact us at musicstorypro@music-story.com to increase your limit.

To find out where you stand, you have two options.

  1. Go to the motnitor metadata in the API - Monitoring tab

  2. Call the endpoint /user/api/status You'll receive a response like this

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

Example: Suppose you have a rate limit of 1000 requests per day. If you attempts to make 1200 requests within a 24-hour period, the API will respond with a rate limit exceeded error, indicating that the user has reached their daily quota.

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
id
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

nature
string
Enum: "Human" "Virtual" "Avatar" "Deepfake" "Vocaloids" "Generative AI"

Dataset: Basic
Nature of artist

gender
string
Enum: "Male" "Female" "Other"

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
Array containing the artist’s roles

Array
id_role
required
number

Dataset: Basic
ID of the role

name
required
string

Dataset: Basic
Name of the role

link
required
string
Enum: "Main" "Other"

Dataset: Basic
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
string

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

rfc_5646
required
string

Dataset: Basic
Language of the translated name, following RFC 5646 standard

name
required
string

Dataset: Basic
Name of the artist in other languages

Array of objects

Dataset: Basic
Array containing the band members

Array
id_artist
required
number

Dataset: Basic
ID of the band member

name_artist
required
string

Dataset: Basic
Name of the band member

start_date
string

Dataset: Basic
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: Basic
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: Basic
ID of the band member’s role

name_role
required
string

Dataset: Basic
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: Basic
Array containing the artist’s collaborators

Array
id_artist
required
number

Dataset: Basic
ID of the collaborator

name_artist
required
string

Dataset: Basic
Name of the collaborator

start_date
string

Dataset: Basic
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: Basic
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: Basic
ID of the collaborator’s role

name_role
required
string

Dataset: Basic
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",
      • "nature": "Human",
      • "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",
          • "rfc_5646": "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": {},
      • "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
id
required
integer[1-9][0-9]*

ID of Artist

Responses

Response Schema: application/json
id
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

nature
string
Enum: "Human" "Virtual" "Avatar" "Deepfake" "Vocaloids" "Generative AI"

Dataset: Basic
Nature of artist

gender
string
Enum: "Male" "Female" "Other"

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
Array containing the artist’s roles

Array
id_role
required
number

Dataset: Basic
ID of the role

name
required
string

Dataset: Basic
Name of the role

link
required
string
Enum: "Main" "Other"

Dataset: Basic
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
string

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

rfc_5646
required
string

Dataset: Basic
Language of the translated name, following RFC 5646 standard

name
required
string

Dataset: Basic
Name of the artist in other languages

Array of objects

Dataset: Basic
Array containing the band members

Array
id_artist
required
number

Dataset: Basic
ID of the band member

name_artist
required
string

Dataset: Basic
Name of the band member

start_date
string

Dataset: Basic
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: Basic
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: Basic
ID of the band member’s role

name_role
required
string

Dataset: Basic
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: Basic
Array containing the artist’s collaborators

Array
id_artist
required
number

Dataset: Basic
ID of the collaborator

name_artist
required
string

Dataset: Basic
Name of the collaborator

start_date
string

Dataset: Basic
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: Basic
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: Basic
ID of the collaborator’s role

name_role
required
string

Dataset: Basic
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",
  • "nature": "Human",
  • "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",
      • "rfc_5646": "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": {},
  • "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
id
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
id
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

copyright
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

id
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

copyright
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

tags
Array of strings

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Array containing the picture’s tags

offset
number
limit
number
total
number

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
id
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
id
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
string

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

rfc_5646
required
string

Dataset: Basic
Language of the translated name, following RFC 5646 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
Enum: "Main" "Feat"

Dataset: Basic
Relation type

Array of objects

Dataset: Basic
Roles of the artist

Array
id
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

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",
          • "rfc_5646": "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",
          • "roles": [
            • {
              • "id": 123,
              • "name": "Singer"
              }
            ]
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

/api/artist/{id}/popularity

Get Music Story artist popularity

Authorizations:
Bearer
path Parameters
id
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
id
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
string

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

rfc_5646
required
string

Dataset: Basic
Language of the translated name, following RFC 5646 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
Enum: "Main" "Feat"

Dataset: Basic
Relation type

Array of objects

Dataset: Basic
Roles of the artist

Array
id
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

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",
          • "rfc_5646": "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",
          • "roles": [
            • {
              • "id": 123,
              • "name": "Singer"
              }
            ]
          }
        ],
      • "score": "1"
      }
    ],
  • "page": 1,
  • "totalPages": 50,
  • "totalHits": 1000
}

/api/album/{id}

Get Music Story album

Authorizations:
Bearer
path Parameters
id
required
integer[1-9][0-9]*

ID of Album

Responses

Response Schema: application/json
id
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
string

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

rfc_5646
required
string

Dataset: Basic
Language of the translated name, following RFC 5646 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
Enum: "Main" "Feat"

Dataset: Basic
Relation type

Array of objects

Dataset: Basic
Roles of the artist

Array
id
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

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",
      • "rfc_5646": "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",
      • "roles": [
        • {
          • "id": 123,
          • "name": "Singer"
          }
        ]
      }
    ]
}

/api/album/{id}/coverart

Get Music Story album coverart

Authorizations:
Bearer
path Parameters
id
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
{}

/api/album/{id}/audiodescriptions

Descriptors calculated on audio files

Authorizations:
Bearer
path Parameters
id
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
id
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
id
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

recommended
boolean

Dataset: Basic
Recommended release information. This is useful in cases where it is necessary to recover a single version.

commentary
string

Dataset: Basic
Commentary 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

link
required
string
Enum: "Main" "Feat"

Dataset: Basic
Relation type

Array of objects

Dataset: Basic
Roles of the artist

Array
id
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

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",
      • "recommended": false,
      • "commentary": "Deluxe",
      • "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",
          • "link": "Main",
          • "roles": [
            • {
              • "id": 123,
              • "name": "Singer"
              }
            ]
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

/api/album/{id}/credits

Get album credits

Authorizations:
Bearer
path Parameters
id
required
integer[1-9][0-9]*

ID of Album

Responses

Response Schema: application/json
id
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
id
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
Source of the review

content
required
string

Dataset: Review
Content of the review

author
string

Dataset: Review
Author of the review

copyright
string

Dataset: Review
Copyright of the review

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
id
number

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

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

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

copyright
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

id
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

copyright
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

tags
Array of strings

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Array containing the picture’s tags

date
string

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Date of modification on the picture

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
id
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

recommended
boolean

Dataset: Basic
Recommended release information. This is useful in cases where it is necessary to recover a single version.

commentary
string

Dataset: Basic
Commentary 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

link
required
string
Enum: "Main" "Feat"

Dataset: Basic
Relation type

Array of objects

Dataset: Basic
Roles of the artist

Array
id
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

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",
      • "recommended": false,
      • "commentary": "Deluxe",
      • "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",
          • "link": "Main",
          • "roles": [
            • {
              • "id": 123,
              • "name": "Singer"
              }
            ]
          }
        ],
      • "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
id
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

recommended
boolean

Dataset: Basic
Recommended release information. This is useful in cases where it is necessary to recover a single version.

commentary
string

Dataset: Basic
Commentary 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

link
required
string
Enum: "Main" "Feat"

Dataset: Basic
Relation type

Array of objects

Dataset: Basic
Roles of the artist

Array
id
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

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",
      • "recommended": false,
      • "commentary": "Deluxe",
      • "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",
          • "link": "Main",
          • "roles": [
            • {
              • "id": 123,
              • "name": "Singer"
              }
            ]
          }
        ],
      • "score": "1"
      }
    ],
  • "page": 1,
  • "totalPages": 50,
  • "totalHits": 1000
}

/api/release/{id}

Get Music Story release

Authorizations:
Bearer
path Parameters
id
required
integer[1-9][0-9]*

ID of Release

Responses

Response Schema: application/json
id
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

recommended
boolean

Dataset: Basic
Recommended release information. This is useful in cases where it is necessary to recover a single version.

commentary
string

Dataset: Basic
Commentary 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

link
required
string
Enum: "Main" "Feat"

Dataset: Basic
Relation type

Array of objects

Dataset: Basic
Roles of the artist

Array
id
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

Response samples

Content type
application/json
{
  • "id": 446,
  • "release_date": "2001-00-00",
  • "distributor": "RCA",
  • "barcode": "0744659975226",
  • "support": "LP",
  • "recommended": false,
  • "commentary": "Deluxe",
  • "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",
      • "link": "Main",
      • "roles": [
        • {
          • "id": 123,
          • "name": "Singer"
          }
        ]
      }
    ]
}

/api/release/{id}/tracks

Get Music Story release tracks

Authorizations:
Bearer
path Parameters
id
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
id
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
id
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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 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
Deprecated

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
id
required
number

Dataset: Basic
ID of the artist

name
required
string

Dataset: Basic
Name of the artist

type
required
string
Deprecated
Enum: "MAIN" "FEAT"

Dataset: Basic
Type of the artist

link
required
string
Enum: "Main" "Feat"

Dataset: Basic
Relation type

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",
          • "rfc_5646": "ja",
          • "title": "サンダーストラック",
          • "subtitle": null
          }
        ],
      • "related_isrcs": null,
      • "genre": {
        • "id_genre": 32,
        • "name": "Hard rock"
        },
      • "artists": [
        • {
          • "id": 100115,
          • "name": "AC/DC",
          • "type": "MAIN",
          • "link": "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
id
required
integer[1-9][0-9]*

ID of Recording

Responses

Response Schema: application/json
id
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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 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
Deprecated

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
id
required
number

Dataset: Basic
ID of the artist

name
required
string

Dataset: Basic
Name of the artist

type
required
string
Deprecated
Enum: "MAIN" "FEAT"

Dataset: Basic
Type of the artist

link
required
string
Enum: "Main" "Feat"

Dataset: Basic
Relation type

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",
      • "rfc_5646": "ja",
      • "title": "サンダーストラック",
      • "subtitle": null
      }
    ],
  • "related_isrcs": null,
  • "genre": {
    • "id_genre": 32,
    • "name": "Hard rock"
    },
  • "artists": [
    • {
      • "id": 100115,
      • "name": "AC/DC",
      • "type": "MAIN",
      • "link": "Main",
      • "roles": [
        • {
          • "id": 123,
          • "name": "Singer"
          }
        ]
      }
    ]
}

/api/recording/{id}/audiodescriptions

Descriptors calculated with Simbals technology

Authorizations:
Bearer
path Parameters
id
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
id
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
id
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
id
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
id
required
integer[1-9][0-9]*

ID of Recording

Responses

Response Schema: application/json
id
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
              }
            ]
          }
        ]
      }
    ]
}

/api/recording/{id}/clusters

Get clusters in which the recording appears.

Authorizations:
Bearer
path Parameters
id
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
id
number

Dataset: Clusters
ID of the cluster

type
required
string
Enum: "similar_work" "similar_artist_title" "similar_phonogram" "candidate"

Dataset: Clusters
Type of the cluster

  • similar_work: Similar works
  • similar_artist_title: Similar artists and titles
  • similar_phonogram: Similar phonograms
required
Array of objects

Dataset: Clusters
Array of object contains all recordings of the cluster

Array
id
required
number

Dataset: Clusters
ID of the recording

isrc
string

Dataset: Clusters
ISRC of the recording

title
required
string

Dataset: Clusters
Title of the recording

subtitle
string

Dataset: Clusters
Subtitle of the recording

duration
string

Dataset: Clusters
Duration of the recording

required
Array of objects

Dataset: Clusters
Array of object contains all artists of the recording

Array
id
number

Dataset: Clusters
ID of the artist

name
required
string

Dataset: Clusters
Name of the artist

type
string

Dataset: Clusters
Type of the artist

offset
number
limit
number
total
number

Response samples

Content type
application/json
{
  • "results": [
    • {
      • "id": 123,
      • "type": "similar_artist_title",
      • "recordings": [
        • {
          • "id": 123,
          • "isrc": "AUAP09200021",
          • "title": "Thunderstruck",
          • "subtitle": null,
          • "duration": "00:06:34",
          • "artists": [
            • {
              • "id": 123,
              • "name": "AC/DC",
              • "type": "Person"
              }
            ]
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

/api/recording/{id}/cluster-candidates

Get candidate clusters of the recording.

Authorizations:
Bearer
path Parameters
id
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
isrc
required
string

Dataset: Clusters
ISRC of the recording

title
required
string

Dataset: Clusters
Title of the recording

subtitle
string

Dataset: Clusters
Subtitle of the recording

duration
string

Dataset: Clusters
Duration of the recording

required
Array of objects

Dataset: Clusters
Array of object contains all artists of the recording

Array
name
required
string

Dataset: Clusters
Name of the artist

offset
number
limit
number
total
number

Response samples

Content type
application/json
{
  • "results": [
    • {
      • "isrc": "AUAP09200021",
      • "title": "Thunderstruck",
      • "subtitle": null,
      • "duration": "00:06:34",
      • "artists": [
        • {
          • "name": "AC/DC"
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

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
id
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
id
required
integer[1-9][0-9]*

ID of Show

Responses

Response Schema: application/json
id
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
id
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

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

copyright
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

id
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

copyright
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

tags
Array of strings

Dataset: Picture-Getty / Picture-Curation / Picture-Label
Array containing the picture’s tags

offset
number
limit
number
total
number

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

isrc
string

ISRC to filter results

Responses

Response Schema: application/json
Array of objects
Array
id
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
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

role
string

Dataset: Work
Role of the share

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
id
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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 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",
          • "rfc_5646": "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
id
required
integer[1-9][0-9]*

ID of Genre

Responses

Response Schema: application/json
id
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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 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",
      • "rfc_5646": "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
id
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

nature
string
Enum: "Human" "Virtual" "Avatar" "Deepfake" "Vocaloids" "Generative AI"

Dataset: Basic
Nature 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",
      • "nature": "Human",
      • "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
id
required
number

Dataset: Basic
ID of the role

name
required
string

Dataset: Basic
Name of the role in english

object

Dataset: Basic
Category of the role

id
number

Dataset: Basic
ID of the role category

name
string

Dataset: Basic
Name of the role category 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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 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",
      • "category": {
        • "id": 1,
        • "name": "Other"
        },
      • "translated": [
        • {
          • "lang": "JA",
          • "rfc_5646": "ja",
          • "name": "作詞家"
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

/api/role/{id}

Get Music Story role

Authorizations:
Bearer
path Parameters
id
required
integer[1-9][0-9]*

ID of Role

Responses

Response Schema: application/json
id
required
number

Dataset: Basic
ID of the role

name
required
string

Dataset: Basic
Name of the role in english

object

Dataset: Basic
Category of the role

id
number

Dataset: Basic
ID of the role category

name
string

Dataset: Basic
Name of the role category 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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 standard

name
string

Dataset: Basic
Name of the role in other languages

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Lyricist",
  • "category": {
    • "id": 1,
    • "name": "Other"
    },
  • "translated": [
    • {
      • "lang": "JA",
      • "rfc_5646": "ja",
      • "name": "作詞家"
      }
    ]
}

Roles Categories

All endpoints to get roles categories

/api/role-category

Get Music Story role-category

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: Basic
ID of the role category

name
required
string

Dataset: Basic
Name of the role category 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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 standard

name
string

Dataset: Basic
Name of the role category in other languages

offset
number
limit
number
total
number

Response samples

Content type
application/json
{
  • "results": [
    • {
      • "id": 1,
      • "name": "Lyricist",
      • "translated": [
        • {
          • "lang": "JA",
          • "rfc_5646": "ja",
          • "name": "作詞家"
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

/api/role-category/{id}

Get Music Story role-category

Authorizations:
Bearer
path Parameters
id
required
integer[1-9][0-9]*

ID of Role category

Responses

Response Schema: application/json
id
required
number

Dataset: Basic
ID of the role category

name
required
string

Dataset: Basic
Name of the role category 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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 standard

name
string

Dataset: Basic
Name of the role category in other languages

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Lyricist",
  • "translated": [
    • {
      • "lang": "JA",
      • "rfc_5646": "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
id
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
id
required
integer[1-9][0-9]*

ID of Country

Responses

Response Schema: application/json
id
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
}

/api/charts/{id_charts}/dates

Get Music Story charts dates

Authorizations:
Bearer
path Parameters
id_charts
required
integer[1-9][0-9]*

ID of the chart

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 date entry

start_date
string <date>

Dataset: Chart
Date of the beginning of the chart's period

end_date
string <date>

Dataset: Chart
Date of the end of the chart's period

matched
number

Dataset: Chart
Indicates if the chart's date period has been matched

total
number

Dataset: Chart
Total number of entries for the chart's date period

offset
number
limit
number
total
number

Response samples

Content type
application/json
{
  • "results": [
    • {
      • "id": 5,
      • "start_date": "2023-08-01",
      • "end_date": "2023-08-07",
      • "matched": 95,
      • "total": 100
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

/api/charts/{id_charts}/dates/{id_date}/rows

Get Music Story charts rows

Authorizations:
Bearer
path Parameters
id_charts
required
integer[1-9][0-9]*

ID of the chart

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

ID of the chart's period

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 chart's period entry

artist_name
string

Dataset: Chart
Name of the artist

album_title
string

Dataset: Chart
Title of the album

recording_title
string

Dataset: Chart
Name of the recording

rank
number

Dataset: Chart
Rank of the artist or title

previous_rank
number

Dataset: Chart
Previous rank of the artist or title

best_rank
number

Dataset: Chart
Best rank of the artist or title

appearances
number

Dataset: Chart
Number of weeks the artist or title has been on the chart

date_in
string <date>

Dataset: Chart
Date the artist or title entered the chart

rank_in
number

Dataset: Chart
Rank of the artist or title when it entered the chart

date_out
string <date>

Dataset: Chart
Date the artist or title left the chart

rank_out
number

Dataset: Chart
Rank of the artist or title when it left the chart

object

Dataset: Chart
MusicStory artist information

id
number

Dataset: Chart
MusicStory ID of the artist

name
string

Dataset: Chart
Name of the MusicStory artist

object

Dataset: Chart
MusicStory album information

id
number

Dataset: Chart
MusicStory ID of the album

title
string

Dataset: Chart
Title of the MusicStory album

Array of objects

Dataset: Chart
MusicStory recording information

Array
id
number

Dataset: Chart
MusicStory ID of the recording

title
string

Dataset: Chart
Title of the MusicStory recording

subtitle
string

Dataset: Chart
Subtitle of the MusicStory recording

offset
number
limit
number
total
number

Response samples

Content type
application/json
{
  • "results": [
    • {
      • "id": 5001,
      • "artist_name": "The Beatles",
      • "album_title": "Let It Be",
      • "recording_title": "Let It Be",
      • "rank": 1,
      • "previous_rank": 2,
      • "best_rank": 1,
      • "appearances": 10,
      • "date_in": "2023-08-01",
      • "rank_in": 1,
      • "date_out": "2023-10-10",
      • "rank_out": 50,
      • "ms_artist": {
        • "id": 1234,
        • "name": "The Beatles"
        },
      • "ms_album": {
        • "id": 5678,
        • "title": "Let It Be"
        },
      • "ms_recordings": [
        • {
          • "id": 91011,
          • "title": "Let It Be",
          • "subtitle": "Remastered"
          }
        ]
      }
    ],
  • "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
id
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
id
required
integer[1-9][0-9]*

ID of the Show Type

Responses

Response Schema: application/json
id
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
id
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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 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
id
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

rfc_5646
string

Dataset: Basic
Language of the translated name, following RFC 5646 standard

name
string

Dataset: Basic
Name of the artist in other languages

type
string
Enum: "Person" "Band"

Dataset: Basic
Type of artist

nature
string
Enum: "Human" "Virtual" "Avatar" "Deepfake" "Vocaloids" "Generative AI"

Dataset: Basic
Nature 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

Array of objects

Dataset: Basic
Array containing the artist's roles on this recording

Array
id_role
number

Dataset: Basic
ID of the role

name
string

Dataset: Basic
Name of the role

popularity
number

Dataset: Popularity
Popularity in percent of the artist

Array of objects

Dataset: Basic
Array containing the albums

Array
id
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": [],
  • "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
id
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

test
boolean
Default: false

Set this field to true to mark this picture usage report as a test.

required
Array of objects [ 1 .. 1000 ] items
Array ([ 1 .. 1000 ] items)
id_picture
required
integer
count
required
integer

Responses

Request samples

Content type
application/json
{
  • "id_transaction": 1,
  • "test": false,
  • "assets": [
    • {
      • "id_picture": 1,
      • "count": 1
      }
    ]
}

Response samples

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

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
}