Music-Story (2.0.0)
이 문서에서는 API를 테스트하는 방법을 제공하지 않습니다. 테스트를 용이하게 하기 위해 다음 도구를 사용하는 것이 좋습니다:
cURL(권장, 명령줄)
ReqBIN](https://reqbin.com/)(권장, 온라인)
첫 번째 단계는 메타데이터 모니터라는 뮤직 스토리 플랫폼에 계정을 만드는 것입니다.
메타데이터 모니터는 API에서 제공되는 메타데이터의 시각적 버전을 넘어 다음과 같은 서비스가 포함된 전용 API 섹션에 액세스할 수 있는 기능을 제공합니다:
- API 호출 수에 대한 개요
- 토큰에 대한 액세스
- API 상태에 대한 정보
- 지원팀에 연락할 수 있는 액세스 권한
API를 테스트하려면 어떻게 해야 하나요?
15일 평가판 계정을 만들 수 있습니다. 그러면 같은 기간 동안 API에 액세스할 수 있는 토큰이 자동으로 생성됩니다. API의 모든 엔드포인트에 액세스할 수 있지만 하루에 200회 호출로 제한됩니다.
프리미엄 액세스 권한을 얻으려면 어떻게 해야 하나요?
프리미엄 계정을 얻으려면 musicstorypro@music-story.com 으로 문의하시면 필요에 따라 다양한 엔드포인트에 대한 액세스 권한과 요금 한도를 맞춤 설정할 수 있습니다.
메타데이터 모니터 계정을 사용하면 기본적으로(평가판 계정) 하루에 200건의 요청이 허용됩니다. (Fixed window method)이 할당량에 도달하면 다음을 받게 됩니다 HTTP status code 429 - Too Many Requests이런 일이 너무 자주 발생하면 musicstorypro@music-story.com 으로 문의하여 한도를 늘릴 수 있습니다.
현재 상태를 확인하려면 두 가지 옵션이 있습니다.
모트모니터 메타데이터로 이동하여 API - Monitoring 탭
엔드포인트 호출
/user/api/status다음과 같은 응답을 받게 됩니다{ "X-Rate-Limit-Remaining": 5, "X-Rate-Limit-Limit": 5, "X-Rate-Limit-Retry-After": 0 }
예: 하루 요청 수 제한이 1,000건이라고 가정합니다. 24시간 내에 1200건의 요청을 시도하면 API는 사용자가 일일 할당량에 도달했음을 나타내는 속도 제한 초과 오류로 응답합니다.
/api/artist
Music Story 아티스트 검색
Authorizations:
query Parameters
| query | string 검색할 아티스트의 이름 또는 ID |
| page | integer >= 1 Default: 1 페이지 번호 |
| isni | string ISNI로 결과 필터링 |
| musicbrainz_id | string Musicbrainz ID로 결과 필터링 |
| spotify_id | string Spotify ID로 결과 필터링 |
| deezer_id | string Deezer ID로 결과 필터링 |
| napster_id | string Napster ID로 결과 필터링 |
| qobuz_id | string Qobuz ID로 결과 필터링 |
| apple_id | string Apple Music ID로 결과 필터링 |
| sevendigital_id | string 7Digital ID로 결과 필터링 |
| wikidata_id | string Wikidata 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",
- "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": {
- "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"
], - "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}
뮤직 스토리 아티스트 받기
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" 데이터 세트: 기본 | ||||||||||||||||||||
| nature | string Enum: "Human" "Virtual" "Avatar" "Deepfake" "Vocaloids" "Generative AI" 데이터 세트: 기본 | ||||||||||||||||||||
| gender | string Enum: "Male" "Female" 데이터 세트: 기본 | ||||||||||||||||||||
| main_role | number Deprecated 데이터 세트: 기본 | ||||||||||||||||||||
| 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 데이터 세트: 기본 (메인 장르만) / Reco (기타 장르) | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects 데이터 세트: 기본 (주요 역할만) / Reco (기타 역할) | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects 데이터 세트: 기본 | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects 데이터 세트: 기본 | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects 데이터 세트: 어소시에이트 | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects 데이터 세트: Reco | |||||||||||||||||||||
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",
- "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": {
- "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"
], - "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
뮤직 스토리 아티스트 약력 보기
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 한도 수 |
| format | Array of strings Items Enum: "1:1" "16:9" "all" 쉼표로 구분된 포맷 목록. 여러 형식을 사용할 경우 동일한 id_picture 가 중복될 수 있으므로 id_picture_version 을 사용하는 것이 좋습니다. |
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,
- "id_picture_version": 27190,
- "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
뮤직 스토리 아티스트 앨범 받기
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",
- "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
뮤직 스토리 아티스트 인기도 얻기
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",
- "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}
뮤직 스토리 앨범 받기
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 데이터 세트: Reco | ||||||||||||||
| 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",
- "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
뮤직 스토리 앨범 표지 아트 받기
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
뮤직 스토리 앨범 출시 정보 받기
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": 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
앨범 크레딧 받기
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/picture/log
Get Music Story picture logs
Authorizations:
query Parameters
| limit | integer >= 0 Default: 1000 한도 수 |
| start_after | integer Default: null 마지막으로 처리된 로그의 ID |
Responses
Response Schema: application/json
Array of objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Array
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Response samples
- 200
- 401
- 404
- 429
{- "results": [
- {
- "id": 1025,
- "id_picture": 194784,
- "id_picture_version": 413353,
- "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"
}
]
}/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 Napster ID로 결과 필터링 |
| qobuz_id | string Qobuz ID로 결과 필터링 |
| apple_id | string Apple Music ID로 결과 필터링 |
| sevendigital_id | string 7Digital 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",
- "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
목차로 뮤직 스토리 릴리스 검색
Authorizations:
query Parameters
| toc required | string Example: toc=1 4 289150 150 72965 144450 217485 다음 값으로 공백 또는
|
| 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",
- "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}
뮤직 스토리 릴리스 받기
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" 데이터 세트: 기본 | ||||||||||||||||||
| recommended | boolean 데이터 세트: 기본 | ||||||||||||||||||
| commentary | string 데이터 세트: 기본 | ||||||||||||||||||
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",
- "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
뮤직 스토리 출시 트랙 받기
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 Napster ID로 결과 필터링 |
| qobuz_id | string Qobuz ID로 결과 필터링 |
| apple_id | string Apple Music ID로 결과 필터링 |
| sevendigital_id | string 7Digital 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",
- "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}
뮤직 스토리 녹음 받기
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 Deprecated 데이터 세트: 기본 | ||||||||||||||||||
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",
- "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
Simbals 기술로 계산된 설명자
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/recording/{id}/clusters
녹화 클러스터 받기
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": [
- {
- "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/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 한도 수 |
| format | Array of strings Items Enum: "1:1" "16:9" "all" 쉼표로 구분된 포맷 목록. 여러 형식을 사용할 경우 동일한 id_picture 가 중복될 수 있으므로 id_picture_version 을 사용하는 것이 좋습니다. |
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,
- "id_picture_version": 27190,
- "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/work
뮤직 스토리 작품 검색
Authorizations:
query Parameters
| query required | string 검색할 작품 이름 |
| iswc | string 결과를 필터링하는 ISWC |
| ipi | string 결과를 필터링하는 IPI |
| rightOwner | string 결과를 필터링하는 권한 소유자 |
| isrc | string 결과를 필터링하는 ISRC |
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 또는 제목 또는 Lyric의 해리 폭스 에이전시 코드를 검색합니다. |
| 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",
- "rfc_5646": "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",
- "rfc_5646": "ja",
- "name": "エレクトロニカ"
}
], - "parent_genre": {
- "id_genre": 66,
- "name": "Electro"
}
}/api/genre/{id}/artists
인기순으로 뮤직 스토리 장르별 상위 아티스트 보기
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",
- "nature": "Human",
- "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",
- "rfc_5646": "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",
- "rfc_5646": "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/charts/{id_charts}/dates
뮤직 스토리 차트 날짜 받기
Authorizations:
path Parameters
| id_charts 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": 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
뮤직 스토리 차트 행 받기
Authorizations:
path Parameters
| id_charts required | integer[1-9][0-9]* 차트 ID |
| id_date 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": 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
}/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",
- "rfc_5646": "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",
- "rfc_5646": "ar",
- "name": "ميوز"
}
], - "type": "Band",
- "nature": "Human",
- "genres": [
- {
- "link": "Main",
- "name": "Rock",
- "id_genre": 1
}
], - "roles": [
- {
- "id_role": 1,
- "name": "Composer"
}
], - "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
이 엔드포인트는 하나 이상의 아티스트 이름 및/또는 하나 이상의 트랙 이름으로 재생 목록을 만들 수 있도록 특별히 설계되었습니다. 결과는 아티스트, 장르, 아티스트의 세계관 등의 링크를 포함한 편집 작업을 기반으로 합니다. 무드, 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
{- "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/picture/usage
이 엔드포인트를 사용하여 사진 세트의 사용량을 보고하세요. 이 엔드포인트에 단일 배치로 제출되는 사진의 수는 1000장으로 제한됩니다.
Authorizations:
Request Body schema: application/jsonrequired
| id_transaction required | integer > 0 이 거래 ID는 당사가 귀하의 거래를 추적하기 위한 것입니다. | ||||
| test | boolean Default: false 이 필드를 true로 설정하여 이 이 미지 사용 보고서를 테스트로 표시합니다. | ||||
required | Array of objects [ 1 .. 1000 ] items | ||||
Array ([ 1 .. 1000 ] items)
| |||||
Responses
Request samples
- Payload
{- "id_transaction": 1,
- "test": false,
- "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
}/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
}