Music-Story (2.0.0)
このドキュメントでは、APIをテストする方法を提供していません。テストを容易にするために、以下のツールをお勧めします：
cURL](https://curl.se/) (推奨、コマンドライン)
ReqBIN](https://reqbin.com/) (推奨、オンライン)
不眠症](https://insomnia.rest/)
/api/artist
ミュージック・ストーリーのアーティストを検索
Authorizations:
query Parameters
| query | string 検索するアーティストの名前またはID |
| page | integer >= 1 Default: 1 ページ番号 |
| musicbrainz_id | string 結果をフィルタリングするMusicbrainz ID |
| spotify_id | string Spotify IDで結果をフィルタリング |
| deezer_id | string 結果をフィルタリングするDeezer ID |
| napster_id | string 結果をフィルタリングするためのナップスターID |
| qobuz_id | string 結果をフィルタリングするQobuz ID |
| apple_id | string Apple Music IDで結果をフィルタリング |
| sevendigital_id | string 7デジタルIDで結果を絞り込む |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "hits": [
- {
- "id": 23,
- "name": "Paul McCartney",
- "isni": "0000000121452530",
- "real_firstname_lastname": "James Paul McCartney",
- "type": "Person",
- "gender": "Male",
- "main_role": 13,
- "country_name": "United Kingdom",
- "country_code": "GB",
- "influence_country_name": "United States",
- "influence_country_code": "US",
- "birth_date": "1942-06-18",
- "debut_date": null,
- "birth_place": "Liverpool,Mersey,England",
- "activity_periods": [ ],
- "death_date": null,
- "death_place": null,
- "genres": [
- {
- "id_genre": 1,
- "name": "Rock",
- "link": "Main"
}
], - "aliases": [
- {
- "alias": "Macca",
- "link": "Nickname"
}
], - "translated": [
- {
- "lang": "AR",
- "name": "بول مكارتني"
}
], - "band_members": [
- {
- "id_artist": 4746038,
- "name_artist": "Paul & Linda McCartney",
- "start_date": "1970-00-00",
- "end_date": "1971-00-00",
- "id_role": 13,
- "name_role": "Singer"
}
], - "related_artists": [
- {
- "id_artist": 1,
- "name": "George Harrison",
- "link": "Related"
}
], - "collaborators": [
- {
- "id_artist": 4678361,
- "name_artist": "John Wilson",
- "start_date": "2011-00-00",
- "end_date": "2011-00-00",
- "id_role": 28,
- "name_role": "Conductor"
}
], - "socials": {
- "website": [
- "www.myspace.com/paulmccartney",
- "www.paulmccartney.com",
- "www.maccablog.com"
],
}, - "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"
]
}, - "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}
ミュージック・ストーリー・アーティスト
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アーティストのID |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||||||||||||||||
| name required | string データセット ベーシック | ||||||||||||||||||
| isni | string データセット ベーシック | ||||||||||||||||||
| real_firstname_lastname | string データセット ベーシック | ||||||||||||||||||
| type required | string Enum: "Person" "Band" データセット ベーシック | ||||||||||||||||||
| gender | string Enum: "Male" "Female" データセット ベーシック | ||||||||||||||||||
| main_role | number データセット ベーシック | ||||||||||||||||||
| country_name | string データセット ベーシック | ||||||||||||||||||
| country_code | string データセット ベーシック | ||||||||||||||||||
| influence_country_name | string データセット ベーシック | ||||||||||||||||||
| influence_country_code | string データセット ベーシック | ||||||||||||||||||
| birth_date | string データセット バイオ | ||||||||||||||||||
| debut_date | string データセット バイオ | ||||||||||||||||||
| birth_place | string データセット バイオ | ||||||||||||||||||
Array of objects データセット バイオ | |||||||||||||||||||
Array
| |||||||||||||||||||
| death_date | string データセット バイオ | ||||||||||||||||||
| death_place | string データセット バイオ | ||||||||||||||||||
Array of objects データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル) | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects データセット ベーシック | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects データセット ベーシック | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects データセット アソシエイト | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects データセット レコ | |||||||||||||||||||
Array
| |||||||||||||||||||
Array of objects データセット アソシエイト | |||||||||||||||||||
Array
| |||||||||||||||||||
object データセット ベーシック | |||||||||||||||||||
| |||||||||||||||||||
object データセット ベーシック / 外部 | |||||||||||||||||||
| |||||||||||||||||||
| famous_for | string データセット バイオ | ||||||||||||||||||
| awards | string データセット バイオ | ||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 23,
- "name": "Paul McCartney",
- "isni": "0000000121452530",
- "real_firstname_lastname": "James Paul McCartney",
- "type": "Person",
- "gender": "Male",
- "main_role": 13,
- "country_name": "United Kingdom",
- "country_code": "GB",
- "influence_country_name": "United States",
- "influence_country_code": "US",
- "birth_date": "1942-06-18",
- "debut_date": null,
- "birth_place": "Liverpool,Mersey,England",
- "activity_periods": [ ],
- "death_date": null,
- "death_place": null,
- "genres": [
- {
- "id_genre": 1,
- "name": "Rock",
- "link": "Main"
}
], - "aliases": [
- {
- "alias": "Macca",
- "link": "Nickname"
}
], - "translated": [
- {
- "lang": "AR",
- "name": "بول مكارتني"
}
], - "band_members": [
- {
- "id_artist": 4746038,
- "name_artist": "Paul & Linda McCartney",
- "start_date": "1970-00-00",
- "end_date": "1971-00-00",
- "id_role": 13,
- "name_role": "Singer"
}
], - "related_artists": [
- {
- "id_artist": 1,
- "name": "George Harrison",
- "link": "Related"
}
], - "collaborators": [
- {
- "id_artist": 4678361,
- "name_artist": "John Wilson",
- "start_date": "2011-00-00",
- "end_date": "2011-00-00",
- "id_role": 28,
- "name_role": "Conductor"
}
], - "socials": {
- "website": [
- "www.myspace.com/paulmccartney",
- "www.paulmccartney.com",
- "www.maccablog.com"
],
}, - "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"
]
}, - "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 アーティスト略歴
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アーティストのID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||
Array
| |||||||||||
| offset | number | ||||||||||
| limit | number | ||||||||||
| total | number | ||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "lang": "JA",
- "source": "Music-Story",
- "content": "<p>XG (エックスジー) は、韓国を拠点とする日本のHIPHOP / R&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”の略であり、“常識にとらわれない規格外なスタイルの音楽やパフォーマンスを通じ、世界中の様々な境遇の人達をエンパワーすること”、を標榜している。 </p>",
- "author": "Hidehiko Horiuchi",
- "copyright": "©Copyright Music Story Hidehiko Horiuchi 2024"
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/artist/{id}/pictures
ミュージック・ストーリーのアーティスト写真を入手
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アーティストのID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| offset | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| limit | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| total | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id_picture": 22688,
- "source": "Getty",
- "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": [
- "square",
- "studio",
- "colour",
- "individual",
- "portrait"
]
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}
/api/artist/{id}/albums
ミュージック・ストーリー・アーティストのアルバムを入手
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アーティストのID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||
| offset | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| limit | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
| total | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 12946,
- "title": "The Rhythm of the Saints",
- "subtitle": null,
- "label": "Warner Bros.",
- "distributor": "Warner",
- "type": "ORIGINAL",
- "format": "ALBUM",
- "original_release_date": "1990-10-16",
- "rating": 3,
- "translated": [
- {
- "lang": "ja",
- "title": "リズム・オブ・ザ・セインツ",
- "subtitle": null
}
], - "externals": {
- "musicbrainz": [
- "9c08260c-d558-391b-ae2b-aba11b9793d8"
], - "discogs": [
- 113674
]
}, - "genre": {
- "id_genre": 143,
- "name": "Worldbeat"
}, - "artists": [
- {
- "id_artist": 2278,
- "name": "Paul Simon",
- "link": "Main"
}
]
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/artist/{id}/popularity
ミュージック・ストーリー・アーティストの人気を得る
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アーティストのID |
Responses
Response Schema: application/json
| type required | string Enum: "catalog" "current" データセット 人気 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| peak required | number データセット 人気 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object データセット 人気 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object データセット 人気 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object データセット 人気 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
}
}
]
}
}/api/album
ミュージック・ストーリーのアルバムを検索
Authorizations:
query Parameters
| query required | string 検索するアルバムの名前またはID |
| page | integer >= 1 Default: 1 ページ番号 |
| release_date | string 結果を絞り込むリリース日 |
| artist | string 結果を絞り込むアーティスト名 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "hits": [
- {
- "id": 12946,
- "title": "The Rhythm of the Saints",
- "subtitle": null,
- "label": "Warner Bros.",
- "distributor": "Warner",
- "type": "ORIGINAL",
- "format": "ALBUM",
- "original_release_date": "1990-10-16",
- "rating": 3,
- "translated": [
- {
- "lang": "ja",
- "title": "リズム・オブ・ザ・セインツ",
- "subtitle": null
}
], - "externals": {
- "musicbrainz": [
- "9c08260c-d558-391b-ae2b-aba11b9793d8"
], - "discogs": [
- 113674
]
}, - "genre": {
- "id_genre": 143,
- "name": "Worldbeat"
}, - "artists": [
- {
- "id_artist": 2278,
- "name": "Paul Simon",
- "link": "Main"
}
], - "score": "1"
}
], - "page": 1,
- "totalPages": 50,
- "totalHits": 1000
}/api/album/{id}
アルバム『Music Story』を入手
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アルバムのID |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||||
| title required | string データセット ベーシック | ||||||
| subtitle | string データセット ベーシック | ||||||
| label | string データセット ベーシック | ||||||
| distributor | string データセット ベーシック | ||||||
| type required | string Enum: "ORIGINAL" "LIVE" "COMPILATION" "KARAOKE" "RING" "OTHER" データセット ベーシック | ||||||
| format required | string Enum: "ALBUM" "EP" "SINGLE" "MCD" "MIXTAPE" データセット ベーシック | ||||||
| original_release_date | string データセット レコ | ||||||
| rating | number データセット レビュー | ||||||
Array of objects データセット ベーシック | |||||||
Array
| |||||||
object データセット ベーシック | |||||||
| |||||||
object | |||||||
| |||||||
Array of objects データセット ベー シック | |||||||
Array
| |||||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 12946,
- "title": "The Rhythm of the Saints",
- "subtitle": null,
- "label": "Warner Bros.",
- "distributor": "Warner",
- "type": "ORIGINAL",
- "format": "ALBUM",
- "original_release_date": "1990-10-16",
- "rating": 3,
- "translated": [
- {
- "lang": "ja",
- "title": "リズム・オブ・ザ・セインツ",
- "subtitle": null
}
], - "externals": {
- "musicbrainz": [
- "9c08260c-d558-391b-ae2b-aba11b9793d8"
], - "discogs": [
- 113674
]
}, - "genre": {
- "id_genre": 143,
- "name": "Worldbeat"
}, - "artists": [
- {
- "id_artist": 2278,
- "name": "Paul Simon",
- "link": "Main"
}
]
}/api/album/{id}/coverart
アルバム『Get Music Story』のカバーアート
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アルバムのID |
Responses
Response Schema: application/json
| path required | string データセット アートワーク |
| path_400 | string データセット アートワーク |
| width | number データセット アートワーク |
| height | number データセット アートワーク |
| source required | number データセット アートワーク |
| copyright | number データセット アートワーク |
Response samples
- 200
- 401
- 404
- 429
{- "width": 1500,
- "height": 1500,
- "source": "Music-Story",
- "copyright": "©Copyright Music Story"
}
/api/album/{id}/audiodescriptions
オーディオファイルで計算されたディスクリプタ
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アルバムのID |
Responses
Response Schema: application/json
| arousal | number データセット オーディオ |
| danceability | number データセット オーディオ |
| dissonance | number データセット オーディオ |
| electric_acoustic | number データセット オーディオ |
| melodicity | number データセット オーディオ |
| music_speech | number データセット オーディオ |
| studio_live | number データセット オーディオ |
| valence | number データセット オーディオ |
| vocal_instrumental | number データセット オーディオ |
Response samples
- 200
- 401
- 404
- 429
{- "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 アルバムリリース
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アルバムのID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||||||||||||||||
| release_date | string データセット ベーシック | ||||||||||||||||||
| distributor | string データセット ベーシック | ||||||||||||||||||
| barcode | string データセット ベーシック | ||||||||||||||||||
| support | string Enum: "2CD" "CD" "DVD" "EP" "K7" "LP" "NUM" データセット ベーシック | ||||||||||||||||||
object データセット ベーシック / 外部 | |||||||||||||||||||
| |||||||||||||||||||
object データセット ベーシック | |||||||||||||||||||
| |||||||||||||||||||
Array of objects データセット ベーシック | |||||||||||||||||||
Array
| |||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 446,
- "release_date": "2001-00-00",
- "distributor": "RCA",
- "barcode": "0744659975226",
- "support": "LP",
- "externals": {
- "musicbrainz": [
- "2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
- "9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
], - "discogs": [
- "534523,",
- 5373901,
- 1177873,
- 8897565,
- 437305
], - "spotify": [
- "1gsqQnSVIeP0CIFAclYRUB",
- "1KcGZXb6VBAxn8Jd9RVyc2",
- "2A2w7NSKKyAfDvwx6GEHEg",
- "5gtctm9OmVchYegE7PBOgc"
], - "deezer": [
- 107745
], - "napster": [
- "396274334",
- "189177"
], - "qobuz": [
- 183245
], - "apple": [
- 254339508
], - "sevendigital": [
- 293792
], - "linemusic": [
- "mb00000000000cba83"
]
}, - "album": {
- "id": 110,
- "title": "Metal Machine Music"
}, - "artists": [
- {
- "id": 16,
- "name": "Lou Reed"
}
]
}/api/album/{id}/credits
アルバムクレジットを取得
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アルバムのID |
Responses
Response Schema: application/json
| id required | number データセット クレジット | ||||||||||||||||
Array of objects データセット クレジット | |||||||||||||||||
Array
| |||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
ミュージック・ストーリーのアルバム・レビューを入手
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* アルバムのID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||
Array
| |||||||||||
| offset | number | ||||||||||
| limit | number | ||||||||||
| total | number | ||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
}/api/release
ミュージック・ストーリーのリリースを検索
Authorizations:
query Parameters
| query | string 検索するアルバム名またはリリースID |
| page | integer >= 1 Default: 1 ページ番号 |
| barcode | string バーコードで結果をフィルタリング |
| release_date | string 結果を絞り込むリリース日 |
| musicbrainz_id | string 結果をフィルタリングするMusicbrainz ID |
| spotify_id | string Spotify IDで結果をフィルタリング |
| deezer_id | string 結果をフィルタリングするDeezer ID |
| napster_id | string 結果をフィルタリングするためのナップスターID |
| qobuz_id | string 結果をフィルタリングするQobuz ID |
| apple_id | string Apple Music IDで結果をフィルタリング |
| sevendigital_id | string 7デジタルIDで結果を絞り込む |
| discogs_id | string Discogs IDで結果を絞り込む |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "hits": [
- {
- "id": 446,
- "release_date": "2001-00-00",
- "distributor": "RCA",
- "barcode": "0744659975226",
- "support": "LP",
- "externals": {
- "musicbrainz": [
- "2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
- "9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
], - "discogs": [
- "534523,",
- 5373901,
- 1177873,
- 8897565,
- 437305
], - "spotify": [
- "1gsqQnSVIeP0CIFAclYRUB",
- "1KcGZXb6VBAxn8Jd9RVyc2",
- "2A2w7NSKKyAfDvwx6GEHEg",
- "5gtctm9OmVchYegE7PBOgc"
], - "deezer": [
- 107745
], - "napster": [
- "396274334",
- "189177"
], - "qobuz": [
- 183245
], - "apple": [
- 254339508
], - "sevendigital": [
- 293792
], - "linemusic": [
- "mb00000000000cba83"
]
}, - "album": {
- "id": 110,
- "title": "Metal Machine Music"
}, - "artists": [
- {
- "id": 16,
- "name": "Lou Reed"
}
], - "score": "1"
}
], - "page": 1,
- "totalPages": 50,
- "totalHits": 1000
}/api/release/toc
ミュージック・ストーリーのリリースを目次から探す
Authorizations:
query Parameters
| toc required | string Example: toc=1 4 289150 150 72965 144450 217485 MusicBrainzの'Full TOC'フォーマットによるCDのTOC（Table of Content）で、スペースまたは
|
| page | integer >= 1 Default: 1 ページ番号 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "hits": [
- {
- "id": 446,
- "release_date": "2001-00-00",
- "distributor": "RCA",
- "barcode": "0744659975226",
- "support": "LP",
- "externals": {
- "musicbrainz": [
- "2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
- "9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
], - "discogs": [
- "534523,",
- 5373901,
- 1177873,
- 8897565,
- 437305
], - "spotify": [
- "1gsqQnSVIeP0CIFAclYRUB",
- "1KcGZXb6VBAxn8Jd9RVyc2",
- "2A2w7NSKKyAfDvwx6GEHEg",
- "5gtctm9OmVchYegE7PBOgc"
], - "deezer": [
- 107745
], - "napster": [
- "396274334",
- "189177"
], - "qobuz": [
- 183245
], - "apple": [
- 254339508
], - "sevendigital": [
- 293792
], - "linemusic": [
- "mb00000000000cba83"
]
}, - "album": {
- "id": 110,
- "title": "Metal Machine Music"
}, - "artists": [
- {
- "id": 16,
- "name": "Lou Reed"
}
], - "score": "1"
}
], - "page": 1,
- "totalPages": 50,
- "totalHits": 1000
}/api/release/{id}
ミュージック・ストーリー・リリース
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* リリースID |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||||||||||||||||
| release_date | string データセット ベーシック | ||||||||||||||||||
| distributor | string データセット ベーシック | ||||||||||||||||||
| barcode | string データセット ベーシック | ||||||||||||||||||
| support | string Enum: "2CD" "CD" "DVD" "EP" "K7" "LP" "NUM" データセット ベーシック | ||||||||||||||||||
object データセット ベーシック / 外部 | |||||||||||||||||||
| |||||||||||||||||||
object データセット ベーシック | |||||||||||||||||||
| |||||||||||||||||||
Array of objects データセット ベーシック | |||||||||||||||||||
Array
| |||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 446,
- "release_date": "2001-00-00",
- "distributor": "RCA",
- "barcode": "0744659975226",
- "support": "LP",
- "externals": {
- "musicbrainz": [
- "2e287d89-19fa-47d2-ad87-897b6fc9c8b0",
- "9bf6bca9-5c27-3d57-9b50-133348bdb9e7"
], - "discogs": [
- "534523,",
- 5373901,
- 1177873,
- 8897565,
- 437305
], - "spotify": [
- "1gsqQnSVIeP0CIFAclYRUB",
- "1KcGZXb6VBAxn8Jd9RVyc2",
- "2A2w7NSKKyAfDvwx6GEHEg",
- "5gtctm9OmVchYegE7PBOgc"
], - "deezer": [
- 107745
], - "napster": [
- "396274334",
- "189177"
], - "qobuz": [
- 183245
], - "apple": [
- 254339508
], - "sevendigital": [
- 293792
], - "linemusic": [
- "mb00000000000cba83"
]
}, - "album": {
- "id": 110,
- "title": "Metal Machine Music"
}, - "artists": [
- {
- "id": 16,
- "name": "Lou Reed"
}
]
}/api/release/{id}/tracks
ミュージック・ストーリーのリリース曲を入手
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* リリースID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||
Array
| |||||||||||||||||||
| offset | number | ||||||||||||||||||
| limit | number | ||||||||||||||||||
| total | number | ||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
}/api/recording
ミュージック・ストーリーのレコーディングを検索
Authorizations:
query Parameters
| query | string 検索する録画の名前またはID |
| page | integer >= 1 Default: 1 ページ番号 |
| isrc | string 結果をフィルタリングするISRC |
| musicbrainz_id | string 結果をフィルタリングするMusicbrainz ID |
| spotify_id | string Spotify IDで結果をフィルタリング |
| deezer_id | string 結果をフィルタリングするDeezer ID |
| napster_id | string 結果をフィルタリングするためのナップスターID |
| qobuz_id | string 結果をフィルタリングするQobuz ID |
| apple_id | string Apple Music IDで結果をフィルタリング |
| sevendigital_id | string 7デジタルIDで結果を絞り込む |
| lyricfind_id | string 結果を絞り込むLyricfind ID |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "hits": [
- {
- "id": 49846,
- "title": "Thunderstruck",
- "subtitle": null,
- "duration": "00:06:34",
- "isrc": "AUAP09200021",
- "hit": null,
- "editors_pick": null,
- "externals": {
- "musicbrainz": [
- 464398
], - "lyricfind": [
- 194658,
- 5244802
], - "spotify": [
- "1DstlcbjaI2vjyJNNW7leT",
- "1DstlcbjaI2vjyJNNW7leT"
], - "deezer": [
- 92722920,
- 92720126
], - "napster": [
- "613f6c61b98e619b681d0f28",
- "613f801ab98e619b68c841bf",
- "610034875",
- "609221422",
- "190835078",
- "190834549"
], - "qobuz": [
- 19912668,
- 19907823,
- 19907940
], - "apple": [
- 575992085,
- 575997835,
- 579533232
], - "sevendigital": [
- 40266621,
- 40267569
], - "linemusic": [
- "mt000000000074338d",
- "mt00000000007431eb"
]
}, - "translated": [
- {
- "lang": "ja",
- "title": "サンダーストラック",
- "subtitle": null
}
], - "related_isrcs": null,
- "genre": {
- "id_genre": 32,
- "name": "Hard rock"
}, - "artists": [
- {
- "id": 100115,
- "name": "AC/DC"
}
], - "score": "1"
}
], - "page": 1,
- "totalPages": 50,
- "totalHits": 1000
}/api/recording/{id}
ミュージック・ストーリーのレコーディングを受ける
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 録音ID |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||||||||||||||||
| title required | string データセット ベーシック | ||||||||||||||||||
| subtitle | string データセット ベーシック | ||||||||||||||||||
| duration | string データセット ベーシック | ||||||||||||||||||
| isrc | string データセット ベーシック | ||||||||||||||||||
| hit | number データセット ベーシック | ||||||||||||||||||
| editors_pick | number データセット ベーシック | ||||||||||||||||||
object データセット ベーシック | |||||||||||||||||||
| |||||||||||||||||||
Array of objects データセット ベーシック | |||||||||||||||||||
Array
| |||||||||||||||||||
| related_isrcs | Array of strings データセット ベーシック | ||||||||||||||||||
object データセット ベーシック | |||||||||||||||||||
| |||||||||||||||||||
Array of objects データセット ベーシック | |||||||||||||||||||
Array
| |||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 49846,
- "title": "Thunderstruck",
- "subtitle": null,
- "duration": "00:06:34",
- "isrc": "AUAP09200021",
- "hit": null,
- "editors_pick": null,
- "externals": {
- "musicbrainz": [
- 464398
], - "lyricfind": [
- 194658,
- 5244802
], - "spotify": [
- "1DstlcbjaI2vjyJNNW7leT",
- "1DstlcbjaI2vjyJNNW7leT"
], - "deezer": [
- 92722920,
- 92720126
], - "napster": [
- "613f6c61b98e619b681d0f28",
- "613f801ab98e619b68c841bf",
- "610034875",
- "609221422",
- "190835078",
- "190834549"
], - "qobuz": [
- 19912668,
- 19907823,
- 19907940
], - "apple": [
- 575992085,
- 575997835,
- 579533232
], - "sevendigital": [
- 40266621,
- 40267569
], - "linemusic": [
- "mt000000000074338d",
- "mt00000000007431eb"
]
}, - "translated": [
- {
- "lang": "ja",
- "title": "サンダーストラック",
- "subtitle": null
}
], - "related_isrcs": null,
- "genre": {
- "id_genre": 32,
- "name": "Hard rock"
}, - "artists": [
- {
- "id": 100115,
- "name": "AC/DC"
}
]
}/api/recording/{id}/audiodescriptions
シンバルの技術で計算されたディスクリプタ
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 録音ID |
Responses
Response Schema: application/json
| absolute_loudness | number データセット オーディオ | ||||
| arousal | number データセット オーディオ | ||||
| articulation | number データセット オーディオ | ||||
| binary | number データセット オーディオ | ||||
| bpm | number データセット オーディオ | ||||
| brightness | number データセット オーディオ | ||||
| centroid | number データセット オーディオ | ||||
| chroma01 | number データセット オーディオ | ||||
| chroma02 | number データセット オーディオ | ||||
| chroma03 | number データセット オーディオ | ||||
| chroma04 | number データセット オーディオ | ||||
| chroma05 | number データセット オーディオ | ||||
| chroma06 | number データセット オーディオ | ||||
| chroma08 | number データセット オーディオ | ||||
| chroma09 | number データセット オーディオ | ||||
| chroma10 | number データセット オーディオ | ||||
| chroma11 | number データセット オーディオ | ||||
| chroma12 | number データセット オーディオ | ||||
| complexity | number データセット オーディオ | ||||
| complexity_chroma | number データセット オーディオ | ||||
| danceability | number データセット オーディオ | ||||
| dissonance | number データセット オーディオ | ||||
| electric_acoustic | number データ セット オーディオ | ||||
| event_density | number データセット オーディオ | ||||
| flatness | number データセット オーディオ | ||||
| intensity | number データセット オーディオ | ||||
| loudness | number データセット オーディオ | ||||
| loudness_range | number データセット オーディオ | ||||
| melodicity | number データセット オーディオ 低い値は、ノイズ、サウンドスケープ、または複雑なハーモニーやメロディーを持つトラック（クラシック、ジャズなど）に関連します。 | ||||
| mfcc01 | number データセット オーデ ィオ | ||||
| mfcc02 | number データセット オーディオ | ||||
| mfcc03 | number データセット オーディオ | ||||
| mfcc04 | number データセット オーディオ | ||||
| mfcc05 | number データセット オーディオ | ||||
| mfcc06 | number データセット オーディオ | ||||
| mfcc07 | number データセット オーディオ | ||||
| mfcc08 | number データセット オーディオ | ||||
| mfcc09 | number データセット オーディオ | ||||
| mfcc10 | number データセット オーディオ | ||||
| mfcc11 | number データセット オーディオ | ||||
| mfcc12 | number データセット オーディオ | ||||
| mfcc13 | number データセット オーディオ | ||||
Array of objects データセット オーディオ | |||||
Array
| |||||
| music_speech | number データセット オーディオ | ||||
| pulse_clarity | number データセット オーディオ | ||||
| rhythmic_stability | number データセット オーディオ | ||||
| roll_off | number データセット オーディオ | ||||
| spread | number データセット オーディオ | ||||
| studio_live | number データセット オーディオ | ||||
| themes | Array of strings データセット オーディオ | ||||
| timbres | Array of strings データセッ ト オーディオ | ||||
| valence | number データセット オーディオ | ||||
| vocal_instrumental | number データセット オーディオ | ||||
| zero_cross_rate | number データセット オーディオ | ||||
Response samples
- 200
- 401
- 404
- 429
{- "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
レコーディングのリリックを入手
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 録音ID |
Responses
Response Schema: application/json
| id_recording required | number データセット 歌詞 | ||||||||||||||||
| lfid required | string データセット 歌詞 | ||||||||||||||||
| title | string データセット 歌詞 | ||||||||||||||||
| hfa_code | string データセット 歌詞 | ||||||||||||||||
| publisher_credit | Array of strings データセット 歌詞 | ||||||||||||||||
| territories required | Array of strings データセット 歌詞 | ||||||||||||||||
| language | string データセット 歌詞 | ||||||||||||||||
| language_code | string データセット 歌詞 | ||||||||||||||||
| lyric | string データセット 歌詞 | ||||||||||||||||
Array of objects オブジェクト・テーブルには歌詞の同期が含まれている | |||||||||||||||||
Array
| |||||||||||||||||
Array of objects データセット 歌詞 | |||||||||||||||||
Array
| |||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
ミュージック・ストーリーのレコーディング人気をゲット
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 録音ID |
Responses
Response Schema: application/json
| type required | string データセット 人気 | ||||||||||||||||||||||||||||||||||||||||||
| peak required | number データセット 人気 | ||||||||||||||||||||||||||||||||||||||||||
object データセット 人気 | |||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||
object データセット 人気 | |||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||
object データセット 人気 | |||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
チャートに表示された録画の要約を得る
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 録音ID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 500 限度数 |
Responses
Response Schema: application/json
Array of objects 録画の全チャートを含むオブジェクトの配列 | |||||||||||||
Array
| |||||||||||||
| offset | number | ||||||||||||
| limit | number | ||||||||||||
| total | number | ||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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}
チャートに表示された録音の詳細を取得する
Authorizations:
path Parameters
| idRecording required | integer >= 0 録画のID |
| idCharts required | integer >= 0 チャートID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 500 限度数 |
Responses
Response Schema: application/json
Array of objects このチャートの順位を持つ すべての日付を含むオブジェクトの配列 | |||||||||
Array
| |||||||||
| offset | number | ||||||||
| limit | number | ||||||||
| total | number | ||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "results": [
- {
- "date": "2023-11-10",
- "rank": 90
}
]
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/recording/{id}/credits
レコーディングのクレジットを取得
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 録音ID |
Responses
Response Schema: application/json
| id | number データセット クレジット | ||||||||||||||||
Array of objects データセット クレジット | |||||||||||||||||
Array
| |||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 696211,
- "data": [
- {
- "parent_credit_name": "Engineer",
- "parent_credit": [
- {
- "credit_child_name": "Assistant Engineer",
- "credit_child": [
- {
- "name": "David Gleeson",
- "id_artist": 4754188
}
]
}
]
}
]
}/api/show
音楽番組検索
Authorizations:
query Parameters
| query required | string 検索する番組名またはID |
| type | integer 結果をフィルタリングするショータイプID |
| artist | string 結果を絞り込むアーティスト名 |
| page | integer >= 1 Default: 1 ページ番号 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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}
ゲット・ミュージック・ストーリー・ショー
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* ショーのID |
Responses
Response Schema: application/json
| id | number データセット ショー | ||||
| name | string データセット ショー | ||||
| subtitle | string データセット ショー | ||||
object データセット ショー | |||||
| |||||
object データセット ショー | |||||
| |||||
Array of objects データセット ショー | |||||
Array
| |||||
| year | number データセット ショー | ||||
| country | string データセット ショー | ||||
| area | string データセット ショー | ||||
| description | string データセット ショー | ||||
Response samples
- 200
- 401
- 404
- 429
{- "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
ゲット・ミュージック・ストーリー 画像
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* ショーのID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| offset | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| limit | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| total | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id_picture": 22688,
- "source": "Getty",
- "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": [
- "square",
- "studio",
- "colour",
- "individual",
- "portrait"
]
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/work
ミュージック・ストーリー作品を探す
Authorizations:
query Parameters
| query required | string 検索する作品名 |
| iswc | string 結果をフィルタリングするISWC |
| ipi | string 結果をフィルタリングするIPI |
| rightOwner | string 結果をフィルタリングする権利所有者 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
}/api/lyrics
歌詞を見る
Authorizations:
query Parameters
| query required | string 検索する歌詞のLyricfind IDまたはタイトルまたはハリー・フォックス代理店コード |
| page | integer >= 1 Default: 1 ページ番号 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
}/api/popularity/artist
ミュージック・ストーリー人気レコーディング
Authorizations:
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
| id_genre | integer[1-9][0-9]* ジャンルID |
| month | string[1-9][0-9]{1,3}-[0-9]{2} 年 月 |
| year | integer[1-9][0-9]{1,3} 年 |
| country_code | string[A-Z]{2} 国名コード |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||
Array
| |||||||||||||||||||||
| offset | number | ||||||||||||||||||||
| limit | number | ||||||||||||||||||||
| total | number | ||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
ミュージック・ストーリー人気レコーディング
Authorizations:
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
| id_genre | integer[1-9][0-9]* ジャンルID |
| month | string[1-9][0-9]{1,3}-[0-9]{2} 年 月 |
| year | integer[1-9][0-9]{1,3} 年 |
| country_code | string[A-Z]{2} 国名コード |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||
| offset | number | ||||||||||||||||||||||||
| limit | number | ||||||||||||||||||||||||
| total | number | ||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "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
}/api/genre
ミュージック・ストーリー・ジャンル
Authorizations:
query Parameters
| id_parent | integer 親ジャンルのID |
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||
Array
| |||||||||||||||||||||
| offset | number | ||||||||||||||||||||
| limit | number | ||||||||||||||||||||
| total | number | ||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 1193,
- "name": "Electronica",
- "translated": [
- {
- "lang": "JA",
- "name": "エレクトロニカ"
}
], - "parent_genre": {
- "id_genre": 66,
- "name": "Electro"
}
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/genre/{id}
ミュージック・ストーリー・ジャンル
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* ジャンルID |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||
| name required | string データセット ベーシック | ||||
Array of objects データセット ベーシック | |||||
Array
| |||||
object データセット ベーシック | |||||
| |||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 1193,
- "name": "Electronica",
- "translated": [
- {
- "lang": "JA",
- "name": "エレクトロニカ"
}
], - "parent_genre": {
- "id_genre": 66,
- "name": "Electro"
}
}/api/genre/{id}/artists
Get Music Story ジャンル別トップアーティスト人気順
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* ジャンルID |
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||
Array
| |||||||||||||||
| offset | number | ||||||||||||||
| limit | number | ||||||||||||||
| total | number | ||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 1095,
- "name": "Ryuichi Sakamoto",
- "complementary": "1952-2023",
- "type": "Person",
- "country_code": "JP",
- "country_name": "Japan",
- "role": "Composer"
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/role
ミュージック・ストーリーの役割
Authorizations:
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||
Array
| |||||||||||||
| offset | number | ||||||||||||
| limit | number | ||||||||||||
| total | number | ||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 1,
- "name": "Lyricist",
- "translated": [
- {
- "lang": "JA",
- "name": "作詞家"
}
]
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/role/{id}
ミュージック・ストーリーの役割
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 役割ID |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||
| name required | string データセット ベーシック | ||||
Array of objects データセット ベーシック | |||||
Array
| |||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 1,
- "name": "Lyricist",
- "translated": [
- {
- "lang": "JA",
- "name": "作詞家"
}
]
}/api/country
ミュージック・ストーリー・カントリー
Authorizations:
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||
Array
| |||||||||||||||
| offset | number | ||||||||||||||
| limit | number | ||||||||||||||
| total | number | ||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 16,
- "name": "Australia",
- "code": "AU",
- "translated": [
- {
- "lang": "JA",
- "name": "オーストラリア"
}
]
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/country/{id}
ミュージック・ストーリー
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* 国のID |
Responses
Response Schema: application/json
| id required | number データセット ベーシック | ||||
| name required | string データセット ベーシック | ||||
| code | string データセット ベーシック | ||||
Array of objects データセット ベーシック | |||||
Array
| |||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 16,
- "name": "Australia",
- "code": "AU",
- "translated": [
- {
- "lang": "JA",
- "name": "オーストラリア"
}
]
}/api/charts
ミュージック・ストーリー・チャート
Authorizations:
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||
Array
| |||||||||||||
| offset | number | ||||||||||||
| limit | number | ||||||||||||
| total | number | ||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 5,
- "name": "Top 100 Deezer - France",
- "area": "Europe",
- "source": "DEEZER",
- "official": false,
- "country_code": "FR"
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/show-type
ミュージック・ストーリー・ショーの種類
Authorizations:
query Parameters
| offset | integer >= 0 Default: 0 オフセット番号 |
| limit | integer >= 0 Default: 20 限度数 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||
Array
| |||||||||||||
| offset | number | ||||||||||||
| limit | number | ||||||||||||
| total | number | ||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 1,
- "name": "Tour",
- "translated": [
- {
- "lang": "FR",
- "name": "Tournée"
}
]
}
], - "offset": 0,
- "limit": 20,
- "total": 45
}/api/show-type/{id}
ゲット・ミュージック・ストーリー・ショー・タイプ
Authorizations:
path Parameters
| id required | integer[1-9][0-9]* ショー・タイプのID |
Responses
Response Schema: application/json
| id required | number データセット ショー | ||||
| name required | string データセット ショー | ||||
Array of objects データセット ショー | |||||
Array
| |||||
Response samples
- 200
- 401
- 404
- 429
{- "id": 1,
- "name": "Tour",
- "translated": [
- {
- "lang": "FR",
- "name": "Tournée"
}
]
}/api/artist-title
このエンドポイントは、タイトルとアーティスト名で録音を検索するために特別に設計されています。 アーティストとタイトルのタイポグラフィのバリエーション（アーティストの別名、アーティストの翻訳名、アーティストの姓と名の反転、タイプミス、不完全なタイトル名など）を処理するように最適化されています。 これは、例えばラジオのプレイリスト検索の典型的なユースケースです。
Authorizations:
query Parameters
| name required | string アーティスト名 |
| title required | string 曲名 |
| page | integer >= 1 Default: 1 ページ番号 |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| page | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalPages | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| totalHits | number | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "hits": [
- {
- "id": 37782,
- "title": "Time Is Running Out",
- "subtitle": "Muse",
- "language": "English",
- "language_code": "EN",
- "translated": [
- {
- "lang": "ja",
- "title": "タイム・イズ・ランニングアウト",
- "subtitle": null
}
], - "duration": "00:03:57",
- "isrc": "GBCVT0300078",
- "genre": {
- "name": "UK alternative rock",
- "id_genre": 197
}, - "hit": 4,
- "editors_pick": null,
- "score": 1,
- "artists": [
- {
- "id": 100408,
- "name": "Muse",
- "real_firstname_lastname": null,
- "aliases": null,
- "translated": [
- {
- "lang": "AR",
- "name": "ميوز"
}
], - "type": "Band",
- "genres": [
- {
- "link": "Main",
- "name": "Rock",
- "id_genre": 1
}
], - "popularity": 47.0420646855061
}
], - "albums": [
- {
- "id": 305942,
- "title": "Time is Running Out",
- "label": "Warner",
- "distributor": null,
- "type": "ORIGINAL",
- "format": "SINGLE",
- "original_release_date": "2003-09-08",
- "genres": [
- {
- "id_genre": 197,
- "name": "UK alternative rock"
}
]
}
], - "popularity": 35.92706247216542
}
], - "page": 1,
- "totalPages": 50,
- "totalHits": 1000
}
/api/recommendation
このエンドポイントは、1つまたは複数のアーティスト名および/または1つまたは複数のトラック名からプレイリストを作成するために特別に設計されています。 結果は、アーティスト間のリンク、ジャンル、アーティストのユニバースなどを含む編集作業に基づいています。 また、ムード、BPMなどのオーディオ記述子を使用して結果を微調整することができます。
- ms_track_idsまたはms_artist_idsのどちらか一方のみが必要です。
Authorizations:
query Parameters
| ms_track_ids | string Number or comma separated list of number |
| ms_artist_ids | string Number or comma separated list of number |
| 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 |
| 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 データセット API推奨 | |||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "tracks": [
- {
- "match": 0.8947930483968929,
- "ms_track_id": 9036384,
- "title": "Thunderstruck",
- "subtitle": null,
- "genre": "Hard rock",
- "popularity": 0.7369826209922324,
- "artists": [
- {
- "id": 100115,
- "mbid": "d7bb0d10-3177-4bc5-a8b9-7c53fec4fda9",
- "name": "AC/DC"
}
], - "features_audio": [
- {
- "bpm": "67",
- "moods": [
- [
- "Frustrated",
- 0.88
], - [
- "Energic",
- 0.73
]
], - "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/picture/usage
このエンドポイントを使用して、一連の画像の使用率を報告します。このエンドポイントに単一のバッチで提出された写真のカウントは、1000に制限されています。
Authorizations:
Request Body schema: application/jsonrequired
| id_transaction required | integer > 0 このトランザクションIDは、お客様のトランザクションを追跡するためのものです。 | ||||
required | Array of objects [ 1 .. 1000 ] items | ||||
Array ([ 1 .. 1000 ] items)
| |||||
Responses
Request samples
- Payload
{- "id_transaction": 1,
- "assets": [
- {
- "id_picture": 1,
- "count": 1
}
]
}Response samples
- 400
- 401
- 415
- 422
{- "errors": [
- {
- "type": "Syntax error",
- "message": "リクエストのペイロードに無効な `json` データが含まれています。"
}
]
}/user/api/status
このポイントを使って、ユーザーがAPIをどのように使っているかを調べる。
Responses
Response Schema: application/json
| X-Rate-Limit-Remaining | number データセット ベーシック |
| X-Rate-Limit-Limit | number データセット ベーシック |
| X-Rate-Limit-Retry-After | number データセット ベーシック |
Response samples
- 200
- 401
{- "X-Rate-Limit-Remaining": 185,
- "X-Rate-Limit-Limit": 200,
- "X-Rate-Limit-Retry-After": 0
}