メインコンテンツまでスキップ
API docs by Redocly

Music-Story (2.0.0)

Music Storyテクニカルサポート: webmaster@music-story.com

このドキュメントでは、APIをテストする方法を提供していません。APIのテストを簡単に行うために、以下のツールを推奨しています：

はじめに

最初のステップは、Music StoryのプラットフォームであるMetadata Monitorにアカウントを作成することです。

私たちのAPIで利用可能なメタデータのビジュアル・バージョン以上のもので、以下のようなサービスを備えた専用のAPIセクションにアクセスできます：

  • APIコール数の確認
  • トークン情報の取得
  • APIステータスの確認
  • 弊社サポートチームへのお問い合わせ

どのようにAPIをテストできますか？

15日間のトライアルアカウントを作成できます。15日間のAPIアクセスが可能なトークンが自動的に発行されます。 すべてのAPIエンドポイントにアクセス可能ですが、1日あたりの呼び出し上限は200回です。

プレミアムアクセスを取得するにはどうすればよいですか？

プレミアムアカウントを取得するには、musicstorypro@music-story.com までご連絡ください。お客様のニーズに合わせて、エンドポイントへのアクセス範囲やレート制限を調整できます。

認証

このAPIは、各リクエストのパーミッションを検証するためにパーソナルアクセストークンを使用します。

これを使用するには、metadata monitorのアカウントが必要です。トークンはプロフィールかAPI - Monitoringページにあります。

Authorizationヘッダーにbearer方式を指定して使用してください。

以下は、curlを使用した例です。

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

レート制限

メタデータモニターアカウントでは、デフォルト(トライアルアカウント)で1日あたり200リクエストが許可されています。(一定の時間枠内でのリクエスト数を制限する固定ウィンドウ方式)このクォータに達すると、HTTPステータスコード429 - Too Many Requestsが返されます。頻繁にこの状態になる場合は、musicstorypro@music-story.com までご連絡いただければ、制限を増やすことができます。

お客様の状況を確認するには、2つの方法があります。

  1. APIの「監視」タブのMetadata Monitorにアクセスする。

  2. エンドポイント /user/api/status を呼び出す。 以下のような応答が返ってくる。

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

例 1日あたり1000リクエストのレート制限があるとする。24時間以内に1200リクエストをしようとすると、APIはrate limit exceededエラーで応答し、ユーザーが1日のクォータに達したことを示します。

アーティスト

アーティストのデータを取得するすべてのエンドポイント

/api/artist

Music Storyのアーティストを検索する

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

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

isni
string

データセット ベーシック
アーティストのISNI

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

データセット ベーシック
アーティストの主な役割のID

country_name
string

データセット ベーシック
アーティストの国名

country_code
string

データセット ベーシック
ISO 3166-1アルファ2規格に基づくアーティストの国の2文字コード

influence_country_name
string

データセット ベーシック
アーティストに最も影響を与えた国名

influence_country_code
string

データセット ベーシック
アーティストに最も影響を与えた国の2文字コード（ISO 3166-1 alpha-2標準準拠）

birth_date
string

データセット バイオ
アーティストの生年月日。フォーマットは “YYYY-MM-DD”。DDとMMの値は、日または月が不明な場合は “00” になることがあります。

debut_date
string

データセット バイオ
アーティストのデビュー日。フォーマットは “YYYY-MM-DD”。DDおよびMMの値は、日または月が不明な場合は “00” でもよい。

birth_place
string

データセット バイオ
アーティストの出身地

Array of objects

データセット バイオ
アーティストの活動期間を含む配列

Array
start_date
required
string

データセット バイオ
YYYY-MM-DDフォーマットの開始日。日または月が不明な場合、DDとMMの値は00になることがあります。

end_date
string

データセット バイオ
YYYY-MM-DD形式の終了日。日または月が不明な場合、DDおよびMMの値は00になることがあります。

death_date
string

データセット バイオ
アーティストの死亡日。フォーマットはYYYY-MM-DD。日または月が不明な場合、DDとMMの値は00になることがあります。

death_place
string

データセット バイオ
アーティストの死亡地

Array of objects

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
アーティストのジャンルを含むリスト

Array
id_genre
required
number

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
ジャンルID

name
required
string

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
ジャンル名

link
required
string
Enum: "Main" "Principal" "Secondary" "Influence"

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
関係タイプ

Array of objects

データセット ベーシック (主役のみ) / レコ (その他の役割)
アーティストの役割を含むリスト

Array
id_role
required
number

データセット ベーシック (主役のみ) / レコ (その他の役割)
役割ID

name
required
string

データセット ベーシック (主役のみ) / レコ (その他の役割)
役割名

link
required
string
Enum: "Main" "Other"

データセット ベーシック (主役のみ) / レコ (その他の役割)
関係タイプ

Array of objects

データセット ベーシック
アーティストの別名を含むリスト

Array
alias
required
string

データセット ベーシック
別名

link
required
string
Enum: "Alias" "Nickname"

データセット ベーシック
エイリアスの種類

Array of objects

データセット ベーシック
アーティストの翻訳名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
required
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

name
required
string

データセット ベーシック
他言語でのアーティスト名

Array of objects

データセット アソシエイト
バンドメンバーを含む配列

Array
id_artist
required
number

データセット アソシエイト
バンドメンバーのID

name_artist
required
string

データセット アソシエイト
バンドメンバー名

start_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、アーティストがバンドメンバーになった日付。日または月が不明な場合、DDおよびMMの値は00でもよい。

end_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、アーティストがバンドメンバーでなくなった日付。日または月が不明な場合、DDおよびMMの値は00でもよい。

id_role
required
number

データセット アソシエイト
バンドメンバーの役割ID

name_role
required
string

データセット アソシエイト
バンドメンバーの役名

Array of objects

データセット レコ
関連アーティストを含む配列

Array
id_artist
required
number

データセット レコ
関連アーティストのID

name
required
string

データセット レコ
関連アーティスト名

link
required
string
Enum: "Related" "Successor" "Influence"

データセット レコ
関係タイプ

Array of objects

データセット アソシエイト
アーティストの協力者を含む配列

Array
id_artist
required
number

データセット アソシエイト
協力者のID

name_artist
required
string

データセット アソシエイト
協力者名

start_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、コラボレーション開始日。日または月が不明な場合、DDおよびMMの値は00でもよい。

end_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、共同作業が終了した日付。日または月が不明な場合、DDおよびMMの値は00でもよい。

id_role
required
number

データセット アソシエイト
協力者の役割のID

name_role
required
string

データセット アソシエイト
協力者の役割名

object

データセット ベーシック
アーティストに関連する外部リンクを含むオブジェクト

tiktok
string

データセット ベーシック
アーティストのTikTokページへのリンク

twitter
string

データセット ベーシック
アーティストのX (Twitter)へのリンク

website
Array of strings

データセット ベーシック
アーティストのウェブサイトへのリンクを含む配列

youtube
string

データセット ベーシック
アーティストのYoutubeチャンネルへのリンク

facebook
string

データセット ベーシック
アーティストのFacebookページへのリンク

instagram
string

データセット ベーシック
アーティストのインスタグラムへのリンク

soundcloud
string

データセット ベーシック
アーティストのSoundcloudページへのリンク

object

データセット ベーシック / 外部
外部データベースやプラットフォームのアーティストIDを含むオブジェクト

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzアーティストIDリスト

discogs
Array of numbers

データセット ベーシック
DiscogsアーティストIDリスト

spotify
Array of strings

データセット 外部
SpotifyアーティストIDリスト

deezer
Array of numbers

データセット 外部
DeezerアーティストIDリスト

napster
Array of strings

データセット 外部
NapsterアーティストIDリスト

qobuz
Array of numbers

データセット 外部
QobuzアーティストIDリスト

apple
Array of numbers

データセット 外部
Apple MusicアーティストIDリスト

sevendigital
Array of numbers

データセット 外部
7DigitalアーティストIDリスト

linemusic
Array of strings

データセット 外部
Line MusicアーティストIDリスト

wikidata
Array of strings

データセット ベーシック
WikidataアーティストIDリスト

famous_for
string

データセット バイオ
そのアーティストが有名である理由を説明する紹介文

awards
string

データセット バイオ
アーティストの受賞歴一覧

score
number

検索に関連するスコア

page
number
totalPages
number
totalHits
number

Response samples

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

/api/artist/{id}

Music Storyアーティスト

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

アーティストのID

Responses

Response Schema: application/json
id
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

isni
string

データセット ベーシック
アーティストのISNI

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

データセット ベーシック
アーティストの主な役割のID

country_name
string

データセット ベーシック
アーティストの国名

country_code
string

データセット ベーシック
ISO 3166-1アルファ2規格に基づくアーティストの国の2文字コード

influence_country_name
string

データセット ベーシック
アーティストに最も影響を与えた国名

influence_country_code
string

データセット ベーシック
アーティストに最も影響を与えた国の2文字コード（ISO 3166-1 alpha-2標準準拠）

birth_date
string

データセット バイオ
アーティストの生年月日。フォーマットは “YYYY-MM-DD”。DDとMMの値は、日または月が不明な場合は “00” になることがあります。

debut_date
string

データセット バイオ
アーティストのデビュー日。フォーマットは “YYYY-MM-DD”。DDおよびMMの値は、日または月が不明な場合は “00” でもよい。

birth_place
string

データセット バイオ
アーティストの出身地

Array of objects

データセット バイオ
アーティストの活動期間を含む配列

Array
start_date
required
string

データセット バイオ
YYYY-MM-DDフォーマットの開始日。日または月が不明な場合、DDとMMの値は00になることがあります。

end_date
string

データセット バイオ
YYYY-MM-DD形式の終了日。日または月が不明な場合、DDおよびMMの値は00になることがあります。

death_date
string

データセット バイオ
アーティストの死亡日。フォーマットはYYYY-MM-DD。日または月が不明な場合、DDとMMの値は00になることがあります。

death_place
string

データセット バイオ
アーティストの死亡地

Array of objects

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
アーティストのジャンルを含むリスト

Array
id_genre
required
number

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
ジャンルID

name
required
string

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
ジャンル名

link
required
string
Enum: "Main" "Principal" "Secondary" "Influence"

データセット ベーシック (メインジャンルのみ) / レコ (その他のジャンル)
関係タイプ

Array of objects

データセット ベーシック (主役のみ) / レコ (その他の役割)
アーティストの役割を含むリスト

Array
id_role
required
number

データセット ベーシック (主役のみ) / レコ (その他の役割)
役割ID

name
required
string

データセット ベーシック (主役のみ) / レコ (その他の役割)
役割名

link
required
string
Enum: "Main" "Other"

データセット ベーシック (主役のみ) / レコ (その他の役割)
関係タイプ

Array of objects

データセット ベーシック
アーティストの別名を含むリスト

Array
alias
required
string

データセット ベーシック
別名

link
required
string
Enum: "Alias" "Nickname"

データセット ベーシック
エイリアスの種類

Array of objects

データセット ベーシック
アーティストの翻訳名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
required
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

name
required
string

データセット ベーシック
他言語でのアーティスト名

Array of objects

データセット アソシエイト
バンドメンバーを含む配列

Array
id_artist
required
number

データセット アソシエイト
バンドメンバーのID

name_artist
required
string

データセット アソシエイト
バンドメンバー名

start_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、アーティストがバンドメンバーになった日付。日または月が不明な場合、DDおよびMMの値は00でもよい。

end_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、アーティストがバンドメンバーでなくなった日付。日または月が不明な場合、DDおよびMMの値は00でもよい。

id_role
required
number

データセット アソシエイト
バンドメンバーの役割ID

name_role
required
string

データセット アソシエイト
バンドメンバーの役名

Array of objects

データセット レコ
関連アーティストを含む配列

Array
id_artist
required
number

データセット レコ
関連アーティストのID

name
required
string

データセット レコ
関連アーティスト名

link
required
string
Enum: "Related" "Successor" "Influence"

データセット レコ
関係タイプ

Array of objects

データセット アソシエイト
アーティストの協力者を含む配列

Array
id_artist
required
number

データセット アソシエイト
協力者のID

name_artist
required
string

データセット アソシエイト
協力者名

start_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、コラボレーション開始日。日または月が不明な場合、DDおよびMMの値は00でもよい。

end_date
string

データセット アソシエイト
YYYY-MM-DDフォーマットで、共同作業が終了した日付。日または月が不明な場合、DDおよびMMの値は00でもよい。

id_role
required
number

データセット アソシエイト
協力者の役割のID

name_role
required
string

データセット アソシエイト
協力者の役割名

object

データセット ベーシック
アーティストに関連する外部リンクを含むオブジェクト

tiktok
string

データセット ベーシック
アーティストのTikTokページへのリンク

twitter
string

データセット ベーシック
アーティストのX (Twitter)へのリンク

website
Array of strings

データセット ベーシック
アーティストのウェブサイトへのリンクを含む配列

youtube
string

データセット ベーシック
アーティストのYoutubeチャンネルへのリンク

facebook
string

データセット ベーシック
アーティストのFacebookページへのリンク

instagram
string

データセット ベーシック
アーティストのインスタグラムへのリンク

soundcloud
string

データセット ベーシック
アーティストのSoundcloudページへのリンク

object

データセット ベーシック / 外部
外部データベースやプラットフォームのアーティストIDを含むオブジェクト

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzアーティストIDリスト

discogs
Array of numbers

データセット ベーシック
DiscogsアーティストIDリスト

spotify
Array of strings

データセット 外部
SpotifyアーティストIDリスト

deezer
Array of numbers

データセット 外部
DeezerアーティストIDリスト

napster
Array of strings

データセット 外部
NapsterアーティストIDリスト

qobuz
Array of numbers

データセット 外部
QobuzアーティストIDリスト

apple
Array of numbers

データセット 外部
Apple MusicアーティストIDリスト

sevendigital
Array of numbers

データセット 外部
7DigitalアーティストIDリスト

linemusic
Array of strings

データセット 外部
Line MusicアーティストIDリスト

wikidata
Array of strings

データセット ベーシック
WikidataアーティストIDリスト

famous_for
string

データセット バイオ
そのアーティストが有名である理由を説明する紹介文

awards
string

データセット バイオ
アーティストの受賞歴一覧

Response samples

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

/api/artist/{id}/biographies

Music Storyアーティストの略歴を取得

Authorizations:
Bearer
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
lang
string
Enum: "FR" "EN" "DE" "JA" "PT" "ES"

データセット バイオ
プロフィールが書かれている言語

source
string
Enum: "Music-Story" "CD Journal"

データセット バイオ
プロフィールの出典

content
string

データセット バイオ
プロフィール本文

author
string

データセット バイオ
プロフィール執筆者

copyright
string

データセット バイオ
プロフィールの著作権

offset
number
limit
number
total
number

Response samples

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

/api/artist/{id}/pictures

Music Storyアーティスト写真を取得する

Authorizations:
Bearer
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
id_picture
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のID。一意性は (id_picture, format) の組み合わせによって定義されます。複数のフォーマットが同じ id_picture を共有することは可能ですが、デフォルトのフォーマット (1:1) では一意です。

id_picture_version
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
画像バージョンのID（一意）

name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のパス

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

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の出典

format
string
Enum: "1:1" "16:9"

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のフォーマット

width
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の幅（ピクセル）

height
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の高さ（ピクセル）

mimetype
string
Value: "image/jpeg"

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のMIMEタイプ

copyright
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の著作権

object

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のメタデータを含むオブジェクト

id
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

quality_rank
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

title
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

date_created
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

date_submitted
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

orientation
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

collection_name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

copyright
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

credit_line
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

license_model
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

artist
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

editorial_segments
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

product_types
Array of strings
people
Array of strings
object
id
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

object
height
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

width
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

object
how_can_i_use_it
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

release_info
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

usage_restrictions
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

tags
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のタグを含む配列

offset
number
limit
number
total
number

Response samples

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

/api/artist/{id}/albums

Music Storyアーティストのアルバムを取得する

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

データセット ベーシック
アルバムのID

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

データセット レコ
YYYY-MM-DDフォーマットで、アルバムのオリジナル発売日。日または月が不明な場合、DDおよびMMの値は00になることがあります。

rating
number

データセット レビュー
アルバムの評価

Array of objects

データセット ベーシック
アルバムの翻訳タイトルを含む配列

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
required
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

title
required
string

データセット ベーシック
他の言語でのタイトル名

subtitle
string

データセット ベーシック
他の言語でのサブタイトル名

object

データセット ベーシック
外部データベースやプラットフォームにおけるアルバムのIDを含むオブジェクト

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzのアルバムIDの配列

discogs
Array of numbers

データセット ベーシック
DiscogsアルバムIDの配列

object
id_genre
required
number

データセット ベーシック
アルバムのジャンルID

name
required
string

データセット ベーシック
アルバムのジャンル名

Array of objects

データセット ベーシック
アルバムに関連するアーティストの配列

Array
id_artist
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
アーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

offset
number
limit
number
total
number

Response samples

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

/api/artist/{id}/popularity

Music Storyアーティストの人気を取得する

Authorizations:
Bearer
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

データセット 人気
オブジェクトは、アーティストの人気のグローバル情報を含む

score
required
number [ 0 .. 100 ]

データセット 人気
グローバル・スコア（アーティストに占める割合

rank
number

データセット 人気
アーティストの世界ランク

recordings_in_charts
number

データセット 人気
チャートの総タイトル数

object

データセット 人気
オブジェクトには、アーティストの人気カタログ情報が含まれています。

score
required
number [ 0 .. 100 ]

データセット 人気
カタログスコア（アーティスト比

rank
number

データセット 人気
アーティストのカタログランク

recordings_in_charts
number

データセット 人気
チャートの総タイトル数

Array of objects

データセット 人気
年ごとのカタログ人気の詳細をすべて含む配列

Array
year
required
number

データセット 人気
人気の年

charts_used
required
number

データセット 人気
人気度算出に使用したチャート数

rank
required
number

データセット 人気
アーティストのランク

score
required
number [ 0 .. 100 ]

データセット 人気
アーティストの採点

object

データセット 人気
そのアーティストのベスト盤

id
required
number

データセット 人気
最も人気のあるレコーディングID

title
required
string

データセット 人気
最も人気のあるレコーディング・タイトル

best_rank
required
number

データセット 人気
チャートでの最高順位

best_country_code
required
string

データセット 人気
ISO3166-1アルファ2標準に従った、録音が最高ランクに達した国の2文字コード、または複数の国でランクに達した場合はNULL（文字列、任意）

best_country_name
required
string

データセット 人気
最高位を記録した国名（複数の国で最高位を記録した場合は「International」）。

Array of objects

データセット 人気
国別のカタログ人気の詳細をすべて含む配列

Array
code
required
string

データセット 人気
ISO 3166-1 alpha-2標準に従った2文字の国コード。

name
required
string

データセット 人気
国名

charts_used
required
number

データセット 人気
人気度算出に使用したチャート数

rank
required
number

データセット 人気
アーティストのランク

score
required
number [ 0 .. 100 ]

データセット 人気
アーティストの採点

object

データセット 人気
そのアーティストのベスト盤

id
required
number

データセット 人気
最も人気のある録音ID

title
required
string

データセット 人気
最も人気のあるレコーディング・タイトル

best_rank
required
number

データセット 人気
チャートでの最高順位

best_month
required
string

データセット 人気
最高の収録月

weeks_in_charts
required
number

データセット 人気
収録チャートの週数

object

データセット 人気
アーティストの現在の人気情報を含むオブジェクト

score
required
number [ 0 .. 100 ]

データセット 人気
アーティストの現在の得点率

rank
number

データセット 人気
アーティストの現在のランク

recordings_in_charts
number

データセット 人気
チャートの総タイトル数

Array of objects

データセット 人気
オブジェクト・テーブルには、月ごとの現在の人気の詳細がすべて含まれている。

Array
month
required
string

データセット 人気
YYYY-MMでフォーマットされた人気月

charts_used
required
number

データセット 人気
人気度算出に使用したチャート数

rank
required
number

データセット 人気
アーティストのランク

score
required
number [ 0 .. 100 ]

データセット 人気
アーティストの採点

object

データセット 人気
そのアーティストのベスト盤

id
required
number

データセット 人気
最も人気のあるレコーディングID

title
required
string

最も人気のあるレコーディング・タイトル

best_rank
required
number

データセット 人気
チャートでの最高順位

best_country_code
required
string

データセット 人気
ISO3166-1アルファ2標準に従った、録音が最高ランクに達した国の2文字コード、または複数の国でランクに達した場合はNULL（文字列、任意）

best_country_name
required
string

データセット 人気
最高位を記録した国名（複数の国で最高位を記録した場合は「International」）。

Array of objects

データセット 人気
国ごとの現在の人気の詳細をすべて含む配列

Array
code
required
string

データセット 人気
ISO 3166-1 alpha-2標準に従った2文字の国コード。

name
required
string

データセット 人気
国名

charts_used
required
number

データセット 人気
人気度算出に使用したチャート数

rank
required
number

データセット 人気
アーティストのランク

score
required
number [ 0 .. 100 ]

データセット 人気
アーティストの採点

object

データセット 人気
そのアーティストのベスト盤

id
required
number

データセット 人気
最も人気のあるレコーディングID

title
required
string

データセット 人気
最も人気のあるレコーディング・タイトル

best_rank
required
number

データセット 人気
チャートでの最高順位

best_month
required
string

データセット 人気
最高の収録月

weeks_in_charts
required
number

データセット 人気
収録チャートの週数

Response samples

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

アルバム

アルバムデータを取得するすべてのエンドポイント

/api/album

Music Storyアーティストのアルバムを検索する

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

データセット ベーシック
アルバムのID

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

データセット レコ
YYYY-MM-DDフォーマットで、アルバムのオリジナル発売日。日または月が不明な場合、DDおよびMMの値は00になることがあります。

rating
number

データセット レビュー
アルバムの評価

Array of objects

データセット ベーシック
アルバムの翻訳タイトルを含む配列

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
required
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

title
required
string

データセット ベーシック
他の言語でのタイトル名

subtitle
string

データセット ベーシック
他の言語でのサブタイトル名

object

データセット ベーシック
外部データベースやプラットフォームにおけるアルバムのIDを含むオブジェクト

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzのアルバムIDの配列

discogs
Array of numbers

データセット ベーシック
DiscogsアルバムIDの配列

object
id_genre
required
number

データセット ベーシック
アルバムのジャンルID

name
required
string

データセット ベーシック
アルバムのジャンル名

Array of objects

データセット ベーシック
アルバムに関連するアーティストの配列

Array
id_artist
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
アーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

score
number

検索に関連するスコア

page
number
totalPages
number
totalHits
number

Response samples

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

/api/album/{id}

Music Storyアルバムを取得する

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

アルバムのID

Responses

Response Schema: application/json
id
required
number

データセット ベーシック
アルバムのID

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

データセット レコ
YYYY-MM-DDフォーマットで、アルバムのオリジナル発売日。日または月が不明な場合、DDおよびMMの値は00になることがあります。

rating
number

データセット レビュー
アルバムの評価

Array of objects

データセット ベーシック
アルバムの翻訳タイトルを含む配列

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
required
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

title
required
string

データセット ベーシック
他の言語でのタイトル名

subtitle
string

データセット ベーシック
他の言語でのサブタイトル名

object

データセット ベーシック
外部データベースやプラットフォームにおけるアルバムのIDを含むオブジェクト

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzのアルバムIDの配列

discogs
Array of numbers

データセット ベーシック
DiscogsアルバムIDの配列

object
id_genre
required
number

データセット ベーシック
アルバムのジャンルID

name
required
string

データセット ベーシック
アルバムのジャンル名

Array of objects

データセット ベーシック
アルバムに関連するアーティストの配列

Array
id_artist
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
アーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

Response samples

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

/api/album/{id}/coverart

Music Storyアルバムカバーアートを取得する

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

アルバムのID

Responses

Response Schema: application/json
path
required
string

データセット アートワーク
写真のカバーアートのパス

path_400
string

データセット アートワーク
配信写真のカバーアート（400x400）のパス

width
number

データセット アートワーク
カバーアートの幅（ピクセル）

height
number

データセット アートワーク
カバーアートの高さ（ピクセル）

source
required
number

データセット アートワーク
カバーアートの出典

copyright
number

データセット アートワーク
カバーアートの著作権

Response samples

Content type
application/json
{}

/api/album/{id}/audiodescriptions

オーディオファイルで計算されたディスクリプタ

Authorizations:
Bearer
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

Content type
application/json
{
  • "arousal": 0.6090944588744586,
  • "danceability": 0.42260865800865793,
  • "dissonance": 0.4210159740259739,
  • "electric_acoustic": 0.3986565800865799,
  • "melodicity": 0.6357076190476186,
  • "music_speech": 0.08721415584415596,
  • "studio_live": 0.294824155844156,
  • "valence": 0.4137444588744586,
  • "vocal_instrumental": 0.06088199134199131
}

/api/album/{id}/releases

Music Story アルバムリリースを取得する

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

データセット ベーシック
リリースのID

release_date
string

データセット ベーシック
リリース日。フォーマットは “YYYY-MM-DD”。DD と MM の値は、日または月が不明な場合は “00” になることがあります。

distributor
string

データセット ベーシック
リリースの販売元

barcode
string

データセット ベーシック
リリースのバーコード（EANまたはUPC）

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

データセット ベーシック
リリースの形式

recommended
boolean

データセット ベーシック
推奨リリース情報。これは、単一のバージョンを復元する必要がある場合に有用です。

commentary
string

データセット ベーシック
リリース補完的な

object

データセット ベーシック / 外部
外部データベースやプラットフォームにおけるリリースのIDを含むオブジェクト。

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzリリースIDのリスト

discogs
Array of numbers

データセット ベーシック
DiscogsリリースIDのリスト

spotify
Array of strings

データセット 外部
SpotifyリリースIDのリスト

deezer
Array of numbers

データセット 外部
DeezerリリースIDのリスト

napster
Array of strings

データセット 外部
NapsterリリースIDのリスト

qobuz
Array of numbers

データセット 外部
QobuzリリースIDのリスト

apple
Array of numbers

データセット 外部
Apple MusicリリースIDのリスト

sevendigital
Array of numbers

データセット 外部
7DigitalリリースIDのリスト

linemusic
Array of strings

データセット 外部
Line MusicリリースIDのリスト

object

データセット ベーシック
アルバム情報を含むオブジェクト

id
required
number

データセット ベーシック
アルバムのID

title
required
string

データセット ベーシック
アルバムタイトル

Array of objects

データセット ベーシック
アーティスト情報を含むオブジェクト

Array
id
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
アーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

offset
number
limit
number
total
number

Response samples

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

/api/album/{id}/credits

アルバムクレジットを取得

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

アルバムのID

Responses

Response Schema: application/json
id
required
number

データセット クレジット
アルバムのID

Array of objects

データセット クレジット
クレジット情報を含むオブジェクトのテーブル

Array
parent_credit_name
string

データセット クレジット
親クレジット名

Array of objects

データセット クレジット
オブジェクトの子クレジットのテーブルには、すべての子クレジットが含まれています。

Array
credit_child_name
string

データセット クレジット
子供のクレジット名

Array of objects

データセット クレジット
オブジェクトの子クレジットの表

Array
name
string

データセット クレジット
クレジットのアーティスト名

id_artist
number

データセット クレジット
Music Storyカタログに掲載されたアーティストのID

Response samples

Content type
application/json
{
  • "id": 696211,
  • "data": [
    • {
      • "parent_credit_name": "Engineer",
      • "parent_credit": [
        • {
          • "credit_child_name": "Assistant Engineer",
          • "credit_child": [
            • {
              • "name": "David Gleeson",
              • "id_artist": 4754188
              }
            ]
          }
        ]
      }
    ]
}

/api/album/{id}/reviews

Music Storyアルバムレビューを取得する

Authorizations:
Bearer
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
lang
required
string
Enum: "FR" "EN" "DE" "JA" "PT" "ES"

データセット レビュー
レビューが書かれた言語

source
required
string

データセット レビュー
カバーアートの著作権

content
required
string

データセット レビュー
カバーアートの著作権

author
string

データセット レビュー
カバーアートの著作権

copyright
string

データセット レビュー
カバーアートの著作権

offset
number
limit
number
total
number

Response samples

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

写真

写真データを取得するすべてのエンドポイント

/api/picture/log

Get Music Story picture logs

Authorizations:
Bearer
query Parameters
limit
integer >= 0
Default: 1000

限度数

start_after
integer
Default: null

最後に処理されたログのID

Responses

Response Schema: application/json
Array of objects
Array
id
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
ログのID

id_picture
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のID。一意性は (id_picture, format) の組み合わせによって定義されます。複数のフォーマットが同じ id_picture を共有することは可能ですが、デフォルトのフォーマット (1:1) では一意です。

id_picture_version
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
画像バージョンのID（一意）

name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のパス

width
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の幅（ピクセル）

height
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の高さ（ピクセル）

mimetype
string
Value: "image/jpeg"

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のMIMEタイプ

copyright
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の著作権

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

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の出典

format
string
Enum: "1:1" "16:9"

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のフォーマット

action
string
Enum: "update" "delete"

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
画像に対して行われた操作

object

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のメタデータを含むオブジェクト

id
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

quality_rank
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

title
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

date_created
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

date_submitted
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

orientation
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

collection_name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

copyright
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

credit_line
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

license_model
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

artist
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

editorial_segments
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

product_types
Array of strings
people
Array of strings
object
id
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

object
height
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

width
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

object
how_can_i_use_it
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

release_info
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

usage_restrictions
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

tags
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のタグを含む配列

date
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
画像の修正日

Response samples

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

リリース

リリースデータを取得するすべてのエンドポイント

/api/release

Music Storyリリースを検索する

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

データセット ベーシック
リリースのID

release_date
string

データセット ベーシック
リリース日。フォーマットは “YYYY-MM-DD”。DD と MM の値は、日または月が不明な場合は “00” になることがあります。

distributor
string

データセット ベーシック
リリースの販売元

barcode
string

データセット ベーシック
リリースのバーコード（EANまたはUPC）

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

データセット ベーシック
リリースの形式

recommended
boolean

データセット ベーシック
推奨リリース情報。これは、単一のバージョンを復元する必要がある場合に有用です。

commentary
string

データセット ベーシック
リリース補完的な

object

データセット ベーシック / 外部
外部データベースやプラットフォームにおけるリリースのIDを含むオブジェクト。

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzリリースIDのリスト

discogs
Array of numbers

データセット ベーシック
DiscogsリリースIDのリスト

spotify
Array of strings

データセット 外部
SpotifyリリースIDのリスト

deezer
Array of numbers

データセット 外部
DeezerリリースIDのリスト

napster
Array of strings

データセット 外部
NapsterリリースIDのリスト

qobuz
Array of numbers

データセット 外部
QobuzリリースIDのリスト

apple
Array of numbers

データセット 外部
Apple MusicリリースIDのリスト

sevendigital
Array of numbers

データセット 外部
7DigitalリリースIDのリスト

linemusic
Array of strings

データセット 外部
Line MusicリリースIDのリスト

object

データセット ベーシック
アルバム情報を含むオブジェクト

id
required
number

データセット ベーシック
アルバムのID

title
required
string

データセット ベーシック
アルバムタイトル

Array of objects

データセット ベーシック
アーティスト情報を含むオブジェクト

Array
id
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
アーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

score
number

検索に関連するスコア

page
number
totalPages
number
totalHits
number

Response samples

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

/api/release/toc

Music Storyリリースを目次(TOC)で検索する

Authorizations:
Bearer
query Parameters
toc
required
string
Example: toc=1 4 289150 150 72965 144450 217485

MusicBrainzの「Full TOC」形式で表現されたCDのTOC（目次情報）は、以下の値をスペースまたは+で区切った形式です：

  • 最初のトラック番号（常に1）
  • 最後のトラック番号
  • リードアウトトラック（ディスク終端）のセクターオフセット
  • トラック1から始まる各トラックのセクターオフセット
page
integer >= 1
Default: 1

ページ番号

Responses

Response Schema: application/json
Array of objects
Array
id
required
number

データセット ベーシック
リリースのID

release_date
string

データセット ベーシック
リリース日。フォーマットは “YYYY-MM-DD”。DD と MM の値は、日または月が不明な場合は “00” になることがあります。

distributor
string

データセット ベーシック
リリースの販売元

barcode
string

データセット ベーシック
リリースのバーコード（EANまたはUPC）

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

データセット ベーシック
リリースの形式

recommended
boolean

データセット ベーシック
推奨リリース情報。これは、単一のバージョンを復元する必要がある場合に有用です。

commentary
string

データセット ベーシック
リリース補完的な

object

データセット ベーシック / 外部
外部データベースやプラットフォームにおけるリリースのIDを含むオブジェクト。

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzリリースIDのリスト

discogs
Array of numbers

データセット ベーシック
DiscogsリリースIDのリスト

spotify
Array of strings

データセット 外部
SpotifyリリースIDのリスト

deezer
Array of numbers

データセット 外部
DeezerリリースIDのリスト

napster
Array of strings

データセット 外部
NapsterリリースIDのリスト

qobuz
Array of numbers

データセット 外部
QobuzリリースIDのリスト

apple
Array of numbers

データセット 外部
Apple MusicリリースIDのリスト

sevendigital
Array of numbers

データセット 外部
7DigitalリリースIDのリスト

linemusic
Array of strings

データセット 外部
Line MusicリリースIDのリスト

object

データセット ベーシック
アルバム情報を含むオブジェクト

id
required
number

データセット ベーシック
アルバムのID

title
required
string

データセット ベーシック
アルバムタイトル

Array of objects

データセット ベーシック
アーティスト情報を含むオブジェクト

Array
id
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
アーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

score
number

検索に関連するスコア

page
number
totalPages
number
totalHits
number

Response samples

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

/api/release/{id}

Music Storyリリースを取得する

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

リリースID

Responses

Response Schema: application/json
id
required
number

データセット ベーシック
リリースのID

release_date
string

データセット ベーシック
リリース日。フォーマットは “YYYY-MM-DD”。DD と MM の値は、日または月が不明な場合は “00” になることがあります。

distributor
string

データセット ベーシック
リリースの販売元

barcode
string

データセット ベーシック
リリースのバーコード（EANまたはUPC）

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

データセット ベーシック
リリースの形式

recommended
boolean

データセット ベーシック
推奨リリース情報。これは、単一のバージョンを復元する必要がある場合に有用です。

commentary
string

データセット ベーシック
リリース補完的な

object

データセット ベーシック / 外部
外部データベースやプラットフォームにおけるリリースのIDを含むオブジェクト。

musicbrainz
Array of strings

データセット ベーシック
MusicBrainzリリースIDのリスト

discogs
Array of numbers

データセット ベーシック
DiscogsリリースIDのリスト

spotify
Array of strings

データセット 外部
SpotifyリリースIDのリスト

deezer
Array of numbers

データセット 外部
DeezerリリースIDのリスト

napster
Array of strings

データセット 外部
NapsterリリースIDのリスト

qobuz
Array of numbers

データセット 外部
QobuzリリースIDのリスト

apple
Array of numbers

データセット 外部
Apple MusicリリースIDのリスト

sevendigital
Array of numbers

データセット 外部
7DigitalリリースIDのリスト

linemusic
Array of strings

データセット 外部
Line MusicリリースIDのリスト

object

データセット ベーシック
アルバム情報を含むオブジェクト

id
required
number

データセット ベーシック
アルバムのID

title
required
string

データセット ベーシック
アルバムタイトル

Array of objects

データセット ベーシック
アーティスト情報を含むオブジェクト

Array
id
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
アーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

Response samples

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

/api/release/{id}/tracks

Music Storyリリース音源を取得する

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

データセット ベーシック
トラックのID

disc_number
number

データセット ベーシック
ディスク番号

track_number
number

データセット ベーシック
トラック番号

object

データセット ベーシック
音源情報を含むオブジェクト

id
number

データセット ベーシック
音源のID

title
string

データセット ベーシック
音源タイトル

subtitle
string

データセット ベーシック
音源のサブタイトル

duration
string

データセット ベーシック
音源時間（フォーマット “HH:MM:SS”）

offset
number
limit
number
total
number

Response samples

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

音源

音源データを取得するすべてのエンドポイント

/api/recording

Music Story音源を検索する

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

データセット ベーシック
音源のID

title
required
string

データセット ベーシック
音源タイトル

subtitle
string

データセット ベーシック
音源のサブタイトル

duration
string

データセット ベーシック
音源の時間（フォーマットは “HH:MM:SS”）

isrc
string

データセット ベーシック
音源のISRC

hit
number

データセット ベーシック
音源がチャートにランクインした場合の評価

editors_pick
number

データセット ベーシック
Music Story編集部が推奨する音源である場合の評価

object

データセット ベーシック
外部データベースやプラットフォームにおける音源のIDを含むオブジェクト

musicbrainz
Array of numbers

データセット ベーシック
MusicBrainzの音源IDのリスト

lyricfind
Array of numbers

データセット 歌詞
LyricFindの音源IDのリスト

spotify
Array of strings

データセット 外部
Spotifyの音源IDのリスト

deezer
Array of numbers

データセット 外部
Deezerの音源IDのリスト

napster
Array of strings

データセット 外部
Napster 音源IDのリスト

qobuz
Array of numbers

データセット 外部
Qobuz音源IDのリスト

apple
Array of numbers

データセット 外部
Apple Musicの音源IDのリスト

sevendigital
Array of numbers

データセット 外部
7Digitalの音源IDのリスト

linemusic
Array of strings

データセット 外部
Line Music音源IDのリスト

Array of objects

データセット ベーシック
音源の翻訳名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

title
string

データセット ベーシック
他の言語での音源タイトル

subtitle
string

データセット ベーシック
他の言語による音源のサブタイトル

related_isrcs
Array of strings
Deprecated

データセット ベーシック
関連するISRCのリスト

object

データセット ベーシック
音源のジャンルを含むオブジェクト

id_genre
required
number

データセット ベーシック
音源ジャンルのID

name
required
string

データセット ベーシック
音源ジャンル名

Array of objects

データセット ベーシック
アーティスト情報を含むオブジェクト

Array
id
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

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

データセット ベーシック
アーティストのタイプ

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
この音源におけるアーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
英語での役名

score
number

検索に関連するスコア

page
number
totalPages
number
totalHits
number

Response samples

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

/api/recording/{id}

Music Story音源を取得する

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

音源ID

Responses

Response Schema: application/json
id
required
number

データセット ベーシック
音源のID

title
required
string

データセット ベーシック
音源タイトル

subtitle
string

データセット ベーシック
音源のサブタイトル

duration
string

データセット ベーシック
音源の時間（フォーマットは “HH:MM:SS”）

isrc
string

データセット ベーシック
音源のISRC

hit
number

データセット ベーシック
音源がチャートにランクインした場合の評価

editors_pick
number

データセット ベーシック
Music Story編集部が推奨する音源である場合の評価

object

データセット ベーシック
外部データベースやプラットフォームにおける音源のIDを含むオブジェクト

musicbrainz
Array of numbers

データセット ベーシック
MusicBrainzの音源IDのリスト

lyricfind
Array of numbers

データセット 歌詞
LyricFindの音源IDのリスト

spotify
Array of strings

データセット 外部
Spotifyの音源IDのリスト

deezer
Array of numbers

データセット 外部
Deezerの音源IDのリスト

napster
Array of strings

データセット 外部
Napster 音源IDのリスト

qobuz
Array of numbers

データセット 外部
Qobuz音源IDのリスト

apple
Array of numbers

データセット 外部
Apple Musicの音源IDのリスト

sevendigital
Array of numbers

データセット 外部
7Digitalの音源IDのリスト

linemusic
Array of strings

データセット 外部
Line Music音源IDのリスト

Array of objects

データセット ベーシック
音源の翻訳名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

title
string

データセット ベーシック
他の言語での音源タイトル

subtitle
string

データセット ベーシック
他の言語による音源のサブタイトル

related_isrcs
Array of strings
Deprecated

データセット ベーシック
関連するISRCのリスト

object

データセット ベーシック
音源のジャンルを含むオブジェクト

id_genre
required
number

データセット ベーシック
音源ジャンルのID

name
required
string

データセット ベーシック
音源ジャンル名

Array of objects

データセット ベーシック
アーティスト情報を含むオブジェクト

Array
id
required
number

データセット ベーシック
アーティストのID

name
required
string

データセット ベーシック
アーティスト名

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

データセット ベーシック
アーティストのタイプ

link
required
string
Enum: "Main" "Feat"

データセット ベーシック
関係タイプ

Array of objects

データセット ベーシック
この音源におけるアーティストの役割

Array
id
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
英語での役名

Response samples

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

/api/recording/{id}/audiodescriptions

シンバルの技術で計算されたディスクリプタ

Authorizations:
Bearer
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

データセット オーディオ
音源のBPM

brightness
number

データセット オーディオ
音／音楽の明るさの印象。

centroid
number

データセット オーディオ
スペクトルの重心がどこにあるかを示す。

chroma01
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma02
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma03
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma04
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma05
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma06
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma08
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma09
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma10
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma11
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

chroma12
number

データセット オーディオ
クロマ係数は、音楽のオクターブの12の異なる半音を表す12のビンに投影されたスペクトルのエネルギーである。

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

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc02
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc03
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc04
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc05
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc06
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc07
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc08
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc09
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc10
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc11
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc12
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

mfcc13
number

データセット オーディオ
MFCCは少数の係数でスペクトルの形状を表します。

Array of objects

データセット オーディオ
オブジェクトの配列には、録音のすべてのムードが含まれる。

Array
name
string

データセット オーディオ
録音のムード名

value
number

データセット オーディオ
レコーディングのムードの重さ

music_speech
number

データセット オーディオ
トラック内の発話内容を示す。 高い値は、話し言葉（インタビュー、オーディオブック、詩、解説）の存在に関連する。 低い値は、おそらく音楽、最終的にはボーカル入り（歌入りトラック）、ただし発話部分はないものに対応します。

pulse_clarity
number

データセット オーディオ
テンポの知覚。 テンポが明確で非常に安定している場合、この値は高い。 低い値は、リズムのないトラック、またはテンポが不安定なトラックを示す。

rhythmic_stability
number

データセット オーディオ
テンポの知覚。 テンポが明確で非常に安定している場合、この値は高い。 低い値は、リズムのないトラック、またはテンポが不安定なトラックを示す。

roll_off
number

データセット オーディオ
スペクトルの全エネルギーの85％が含まれる周波数と定義される。 高調波/ノイズカット周波数と何らかの相関がある。

spread
number

データセット オーディオ
平均値を中心としたスペクトルの広がりと定義される。

studio_live
number

データセット オーディオ
そのトラックがライブで演奏された確率を示す。 高い数値はライブトラックに対応する。 低い値はスタジオ録音に関連する可能性が高い。

themes
Array of strings

データセット オーディオ
文字列の表には、音源の全テーマが含まれる

timbres
Array of strings

データセット オーディオ
文字列テーブルには、音源のすべての音色が含まれています。

valence
number

データセット オーディオ
気分の知覚的測定値で、例えば喜び／悲しみなど、肯定的または否定的な感情に関連する。 高い値は、ポジティブな感情を持つトラックに対応する。 低い値は悲しいトラック。

vocal_instrumental
number

データセット オーディオ
音源にボーカルが含まれているかどうかを示します。 高い値は、音源にボーカル音が含まれていない（インストゥルメンタル）可能性が高いことを示します。 低い値は、おそらくボーカルを含むトラック（歌、ラップ、スラム、スピーチなど）に対応します。

zero_cross_rate
number

データセット オーディオ
信号値がゼロ軸を横切る回数。 ノイズの多い音は値が大きく、周期的な音は値が小さい傾向がある。

Response samples

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

/api/recording/{id}/lyric

音源の歌詞を取得する

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

音源ID

Responses

Response Schema: application/json
id_recording
required
number

データセット 歌詞
録音のID

lfid
required
string

データセット 歌詞
リリックファンドID

title
string

データセット 歌詞
音源タイトル

hfa_code
string

データセット 歌詞
ハリーフォックスエージェンシーコード

publisher_credit
Array of strings

データセット 歌詞
出版社の文字列テーブル

territories
required
Array of strings

データセット 歌詞
歌詞の地域の配列

language
string

データセット 歌詞
歌詞の言語

language_code
string

データセット 歌詞
ISO-639標準に従った歌詞の言語コード

lyric
string

データセット 歌詞
音源の歌詞

Array of objects

オブジェクト・テーブルには同期歌詞が含まれています

Array
line
string

データセット 歌詞
歌詞の一部

duration
string

データセット 歌詞
歌詞の一部のミリ秒単位の継続時間

milliseconds
string

データセット 歌詞
歌詞の一部のミリ秒単位の位置

lrc_timestamp
string

データセット 歌詞
時間フォーマットHH:MM:SSでの位置

Array of objects

データセット 歌詞
オブジェクトテーブルは翻訳を含む

Array
Array of objects

データセット 歌詞
オブジェクト・テーブルには、翻訳同期歌詞が含まれています。

Array
line
string

データセット 歌詞
翻訳の一部

duration
string

データセット 歌詞
翻訳部分のミリ秒単位の継続時間

milliseconds
string

データセット 歌詞
翻訳パートのミリ秒単位の位置

lrc_timestamp
string

データセット 歌詞
時間フォーマットHH:MM:SSでの位置

lyric
string

データセット 歌詞
翻訳の歌詞

language
string

データセット 歌詞
翻訳言語

Response samples

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

/api/recording/{id}/popularity

Music Storyの音源人気を取得する

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

音源ID

Responses

Response Schema: application/json
type
required
string

データセット 人気
音源における代表的な人気タイプ

peak
required
number

データセット 人気
年単位での代表的な日付

object

データセット 人気
このオブジェクトは、音源の人気に関するグローバル情報を含む

score
required
number [ 0 .. 100 ]

データセット 人気
音源のグローバルスコア（パーセンテージ）

rank
number

データセット 人気
音源のグローバルランク

object

データセット 人気
このオブジェクトには、音源のカタログ人気情報が含まれています。

score
required
number [ 0 .. 100 ]

データセット 人気
音源のカタログスコア（パーセンテージ）

rank
number

データセット 人気
音源のカタログランク

Array of objects

データセット 人気
このテーブルには、年別のカタログ人気の詳細がすべて含まれています

Array
year
number

データセット 人気
人気の年

charts_used
number

データセット 人気
人気度算出に使用したチャート数

rank
number

データセット 人気
音源のランク

score
number [ 0 .. 100 ]

データセット 人気
音源のスコア（パーセンテージ）

best_rank
number

データセット 人気
チャート内での音源の最高ランク

best_country_code
string

データセット 人気
ISO 3166-1 alpha-2標準に従った、音源が最高ランクを記録した国の2文字コード。複数の国で記録された場合はNULL

best_country_name
string

データセット 人気
音源が最高ランクを記録した国名、または複数の国で記録された場合は「International」

Array of objects

データセット 人気
このテーブルには、国別のカタログ人気詳細がすべて含まれています。

Array
code
string

データセット 人気
ISO 3166-1 alpha-2標準に従った2文字の国コード。

name
string

データセット 人気
国名

charts_used
number

データセット 人気
人気度算出に使用したチャート数

rank
number

データセット 人気
音源のランク

score
number [ 0 .. 100 ]

データセット 人気
音源のスコア（パーセンテージ）

best_rank
number

データセット 人気
音源の最高ランク

best_month
string

データセット 人気
音源の最高ランクを記録した月

weeks_in_charts
number

データセット 人気
音源がチャートにランクインしていた週数

object

データセット 人気
このオブジェクトは、音源の現在の人気情報を含む

score
required
number [ 0 .. 100 ]

データセット 人気
音源の現在のスコア（パーセンテージ）

rank
number

データセット 人気
音源の現在のランク

Array of objects

データセット 人気
このテーブルには、月ごとの現在の人気詳細がすべて含まれている

Array
month
string

データセット 人気
「YYYY-MM」の形式でフォーマットされた人気月

charts_used
number

データセット 人気
人気度算出に使用したチャート数

rank
number

データセット 人気
音源の現在のランク

score
number [ 0 .. 100 ]

データセット 人気
音源の現在のスコア（パーセンテージ）

best_rank
number

データセット 人気
チャート内での音源の最高ランク

best_country_code
string

データセット 人気
ISO 3166-1 alpha-2標準に従った、音源が最高ランクを記録した国の2文字コード。複数の国で記録された場合はNULL

best_country_name
string

データセット 人気
音源が最高ランクを記録した国名、または複数の国で記録された場合は「International」

Array of objects

データセット 人気
このテーブルには、国別の現在の人気詳細がすべて含まれている

Array
code
string

データセット 人気
ISO 3166-1 alpha-2標準に従った2文字の国コード

name
string

データセット 人気
国名

charts_used
number

データセット 人気
人気度算出に使用したチャート数

rank
number

データセット 人気
音源の現在のランク

score
number [ 0 .. 100 ]

データセット 人気
音源の現在のスコア（パーセンテージ）

best_rank
number

データセット 人気
音源の最高ランク

best_month
string

データセット 人気
音源の最高ランクを記録した月

weeks_in_charts
number

データセット 人気
音源がチャートにランクインしていた週数

Response samples

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

/api/recording/{id}/charts

音源がチャートに登場した際の要約を取得する

Authorizations:
Bearer
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
Array of objects

データセット チャート
音源の全チャートを含むオブジェクトのリスト

Array
id_charts
number

データセット チャート
音源の全チャートを含むオブジェクトのリスト

name
string

データセット チャート
音源の全チャートを含むオブジェクトのリスト

best_rank
number

データセット チャート
音源の全チャートを含むオブジェクトのリスト

entry_date
string

データセット チャート
音源の全チャートを含むオブジェクトのリスト

offset
number
limit
number
total
number

Response samples

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

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

チャートに表示された音源の詳細を取得する

Authorizations:
Bearer
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
Array of objects

データセット チャート
このチャートの順位を持つすべての日付を含むオブジェクトのリスト

Array
date
string

データセット チャート
チャートの日付

rank
number

データセット チャート
音源のチャート順位

offset
number
limit
number
total
number

Response samples

Content type
application/json
{
  • "results": [
    • {
      • "results": [
        • {
          • "date": "2023-11-10",
          • "rank": 90
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

/api/recording/{id}/credits

音源のクレジットを取得

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

音源ID

Responses

Response Schema: application/json
id
number

データセット クレジット
音源のID

Array of objects

データセット クレジット
クレジット情報を含むオブジェクトの表

Array
parent_credit_name
string

データセット クレジット
親クレジット名

Array of objects

データセット クレジット
すべての子クレジットが含まれる子クレジットのオブジェクト表

Array
credit_child_name
string

データセット クレジット
子クレジット名

Array of objects

データセット クレジット
子クレジットのオブジェクト表

Array
name
string

データセット クレジット
クレジットのアーティスト名

id_artist
number

データセット クレジット
Music Storyカタログに登録されているアーティストのID

Response samples

Content type
application/json
{
  • "id": 696211,
  • "data": [
    • {
      • "parent_credit_name": "Engineer",
      • "parent_credit": [
        • {
          • "credit_child_name": "Assistant Engineer",
          • "credit_child": [
            • {
              • "name": "David Gleeson",
              • "id_artist": 4754188
              }
            ]
          }
        ]
      }
    ]
}

/api/recording/{id}/clusters

音源のクラスタを取得

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

データセット クラスター
クラスタのID

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

データセット クラスター
クラスタのタイプ

  • similar_work: 類似作品
  • similar_artist_title: 類似アーティストと作品
  • similar_phonogram: 類似フォノグラム
  • candidate: related_isrcsフィールドに表示された録画
required
Array of objects

データセット クラスター
クラスタの全音源を含むリスト

Array
id
required
number

データセット クラスター
音源のID

isrc
string

データセット クラスター
音源のISRC

title
required
string

データセット クラスター
音源のタイトル

subtitle
string

データセット クラスター
音源のサブタイトル

duration
string

データセット クラスター
音源の長さ

required
Array of objects

データセット クラスター
音源のアーティスト

Array
id
number

データセット クラスター
アーティストのID

name
required
string

データセット クラスター
アーティストの名前

type
string

データセット クラスター
アーティストのタイプ

offset
number
limit
number
total
number

Response samples

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

公演

公演データを取得するすべてのエンドポイント

/api/show

Music Story公演を検索する

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

データセット ショー
公演のID

name
string

データセット ショー
公演のタイトル

subtitle
string

データセット ショー
公演のサブタイトル

object

データセット ショー
公演の種類

id
number

データセット ショー
公演タイプのID

name
string

データセット ショー
公演タイプ名

object

データセット ショー
公演関連アルバム

id
number

データセット ショー
公演関連アルバムのID

title
string

データセット ショー
公演関連アルバムのタイトル

Array of objects

データセット ショー
アルバムに関連するアーティストのリスト

Array
id
number

データセット ショー
アーティストのID

name
string

データセット ショー
アーティスト名

year
number

データセット ショー
開催年

country
string

データセット ショー
公演の代表国

area
string

データセット ショー
公演のエリア

description
string

データセット ショー
公演の内容

score
number

検索に関連するスコア

page
number
totalPages
number
totalHits
number

Response samples

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

/api/show/{id}

Music Story公演を取得する

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

公演のID

Responses

Response Schema: application/json
id
number

データセット ショー
公演のID

name
string

データセット ショー
公演のタイトル

subtitle
string

データセット ショー
公演のサブタイトル

object

データセット ショー
公演の種類

id
number

データセット ショー
公演タイプのID

name
string

データセット ショー
公演タイプ名

object

データセット ショー
公演関連アルバム

id
number

データセット ショー
公演関連アルバムのID

title
string

データセット ショー
公演関連アルバムのタイトル

Array of objects

データセット ショー
アルバムに関連するアーティストのリスト

Array
id
number

データセット ショー
アーティストのID

name
string

データセット ショー
アーティスト名

year
number

データセット ショー
開催年

country
string

データセット ショー
公演の代表国

area
string

データセット ショー
公演のエリア

description
string

データセット ショー
公演の内容

Response samples

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

/api/show/{id}/pictures

Music Story公演写真を取得する

Authorizations:
Bearer
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
id_picture
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のID。一意性は (id_picture, format) の組み合わせによって定義されます。複数のフォーマットが同じ id_picture を共有することは可能ですが、デフォルトのフォーマット (1:1) では一意です。

id_picture_version
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
画像バージョンのID（一意）

name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のパス

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

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の出典

format
string
Enum: "1:1" "16:9"

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のフォーマット

width
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の幅（ピクセル）

height
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の高さ（ピクセル）

mimetype
string
Value: "image/jpeg"

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のMIMEタイプ

copyright
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真の著作権

object

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のメタデータを含むオブジェクト

id
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

quality_rank
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

title
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

date_created
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

date_submitted
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

orientation
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

collection_name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

copyright
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

credit_line
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

license_model
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

artist
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

editorial_segments
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

product_types
Array of strings
people
Array of strings
object
id
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

name
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

object
height
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

width
number

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

object
how_can_i_use_it
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

release_info
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

usage_restrictions
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル

tags
Array of strings

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のタグを含む配列

offset
number
limit
number
total
number

Response samples

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

作品

作品データを取得するすべてのエンドポイント

/api/work

Music Story作品を検索する

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

データセット 仕事
作品ID

title
string

データセット 仕事
作品名

iswc
string

データセット 仕事
作品のISWCコード

hfa_code
string

データセット 仕事
作品のHFAコード

Array of objects

データセット 仕事
作品のシェアのリスト

Array
id
number

データセット 仕事
シェアのID

ipi
number

データセット 仕事
シェアのIPIコード

name
string

データセット 仕事
シェアの名称

role
string

データセット 仕事
シェアの役割

share
number

データセット 仕事
作品のシェア

Array of objects

データセット 仕事
作品の親シェアのリスト

Array
id
number

データセット 仕事
シェアのID

ipi
number

データセット 仕事
シェアのIPIコード

name
string

データセット 仕事
シェアの名称

isrcs
Array of strings

データセット 仕事
作品に関連するISRCのリスト

page
number
totalPages
number
totalHits
number

Response samples

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

歌詞

歌詞データを取得するすべてのエンドポイント

/api/lyrics

歌詞を取得する

Authorizations:
Bearer
query Parameters
query
required
string

検索する歌詞のLyricfind ID、タイトル、またはハリー・フォックスエージェンシーコード

page
integer >= 1
Default: 1

ページ番号

Responses

Response Schema: application/json
Array of objects
Array
id_recording
required
number

データセット 歌詞
録音のID

lfid
required
string

データセット 歌詞
リリックファンドID

title
string

データセット 歌詞
音源タイトル

hfa_code
string

データセット 歌詞
ハリーフォックスエージェンシーコード

publisher_credit
Array of strings

データセット 歌詞
出版社の文字列テーブル

territories
required
Array of strings

データセット 歌詞
歌詞の地域の配列

language
string

データセット 歌詞
歌詞の言語

language_code
string

データセット 歌詞
ISO-639標準に従った歌詞の言語コード

lyric
string

データセット 歌詞
音源の歌詞

Array of objects

オブジェクト・テーブルには同期歌詞が含まれています

Array
line
string

データセット 歌詞
歌詞の一部

duration
string

データセット 歌詞
歌詞の一部のミリ秒単位の継続時間

milliseconds
string

データセット 歌詞
歌詞の一部のミリ秒単位の位置

lrc_timestamp
string

データセット 歌詞
時間フォーマットHH:MM:SSでの位置

Array of objects

データセット 歌詞
オブジェクトテーブルは翻訳を含む

Array
Array of objects

データセット 歌詞
オブジェクト・テーブルには、翻訳同期歌詞が含まれています。

Array
line
string

データセット 歌詞
翻訳の一部

duration
string

データセット 歌詞
翻訳部分のミリ秒単位の継続時間

milliseconds
string

データセット 歌詞
翻訳パートのミリ秒単位の位置

lrc_timestamp
string

データセット 歌詞
時間フォーマットHH:MM:SSでの位置

lyric
string

データセット 歌詞
翻訳の歌詞

language
string

データセット 歌詞
翻訳言語

score
number

検索に関連するスコア

page
number
totalPages
number
totalHits
number

Response samples

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

人気

人気データを取得するすべてのエンドポイント

/api/popularity/artist

Music Storyの人気音源

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

データセット 人気
アーティストのID

name
string

データセット 人気
アーティスト名

genres
Array of any

データセット 人気
アーティストのジャンルを含むリスト

month
string

データセット 人気
YYYY-MMでフォーマットされた人気月

year
number

データセット 人気
YYYYでフォーマットされた人気年

country_code
string

データセット 人気
ISO3166-1アルファ2標準に従った、アーティストの国の2文字コード

popularity
number

データセット 人気
グローバルスコア（アーティストに占める割合）

rank
number

データセット 人気
アーティストの世界ランク

offset
number
limit
number
total
number

Response samples

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

/api/popularity/recording

Music Storyの人気音源

Authorizations:
Bearer
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
Array of objects
Array
object
id
number

データセット 人気
音源のID

title
string

データセット 人気
音源タイトル

genres
Array of any

データセット 人気
音源ジャンルを含むリスト

month
string

データセット 人気
YYYY-MMでフォーマットされた人気月

year
number

データセット 人気
YYYYでフォーマットされた人気年

country_code
string

データセット 人気
ISO 3166-1 alpha-2標準に従った、音源の国の2文字コード

popularity
number

データセット 人気
グローバルスコア（アーティストに占める割合）

rank
number

データセット 人気
アーティストの世界ランク

offset
number
limit
number
total
number

Response samples

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

ジャンル

ジャンルデータを取得するすべてのエンドポイント

/api/genre

Music Storyジャンルを取得する

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

データセット ベーシック
ジャンルID

name
required
string

データセット ベーシック
英語でのジャンル名

Array of objects

データセット ベーシック
翻訳されたジャンル名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

name
string

データセット ベーシック
他言語でのジャンル名

object

データセット ベーシック
親ジャンルを含むオブジェクト

id_genre
number

データセット ベーシック
親ジャンルのID

name
string

データセット ベーシック
親ジャンル名

offset
number
limit
number
total
number

Response samples

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

/api/genre/{id}

Music Storyジャンルを取得する

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

ジャンルID

Responses

Response Schema: application/json
id
required
number

データセット ベーシック
ジャンルID

name
required
string

データセット ベーシック
英語でのジャンル名

Array of objects

データセット ベーシック
翻訳されたジャンル名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

name
string

データセット ベーシック
他言語でのジャンル名

object

データセット ベーシック
親ジャンルを含むオブジェクト

id_genre
number

データセット ベーシック
親ジャンルのID

name
string

データセット ベーシック
親ジャンル名

Response samples

Content type
application/json
{
  • "id": 1193,
  • "name": "Electronica",
  • "translated": [
    • {
      • "lang": "JA",
      • "rfc_5646": "ja",
      • "name": "エレクトロニカ"
      }
    ],
  • "parent_genre": {
    • "id_genre": 66,
    • "name": "Electro"
    }
}

/api/genre/{id}/artists

Music Story ジャンル別トップアーティスト人気順を取得する

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

データセット ベーシック
アーティストのID

name
string

データセット ベーシック
アーティスト名

complementary
string

データセット ベーシック
アーティストの補完

type
string
Enum: "Person" "Band"

データセット ベーシック
アーティストのタイプ

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

データセット ベーシック
アーティストの性質

country_code
string

データセット ベーシック
ISO3166-1アルファ2標準に従った、アーティストの国の2文字コード

country_name
string

データセット ベーシック
アーティストの国名

role
string

データセット ベーシック
アーティストの役割

offset
number
limit
number
total
number

Response samples

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

役割

ロールデータを取得するすべてのエンドポイント

/api/role

Music Story役割を取得する

Authorizations:
Bearer
query Parameters
offset
integer >= 0
Default: 0

オフセット番号

limit
integer >= 0
Default: 20

限度数

Responses

Response Schema: application/json
Array of objects
Array
id
required
number

データセット ベーシック
役割のID

name
required
string

データセット ベーシック
英語での役名

Array of objects

データセット ベーシック
役名の翻訳を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

name
string

データセット ベーシック
他の言語での役名

offset
number
limit
number
total
number

Response samples

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

/api/role/{id}

Music Story役割を取得する

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

役割ID

Responses

Response Schema: application/json
id
required
number

データセット ベーシック
役割のID

name
required
string

データセット ベーシック
英語での役名

Array of objects

データセット ベーシック
役名の翻訳を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

name
string

データセット ベーシック
他の言語での役名

Response samples

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

国名

各国のデータを取得するすべてのエンドポイント

/api/country

Music Story複数国名を取得する

Authorizations:
Bearer
query Parameters
offset
integer >= 0
Default: 0

オフセット番号

limit
integer >= 0
Default: 20

限度数

Responses

Response Schema: application/json
Array of objects
Array
id
required
number

データセット ベーシック
国のID

name
required
string

データセット ベーシック
英語での国名

code
string

データセット ベーシック
国を表すコード（アルファ2）

Array of objects

データセット ベーシック
翻訳された国名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

name
string

データセット ベーシック
他の言語での国名

offset
number
limit
number
total
number

Response samples

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

/api/country/{id}

Music Story国名を取得する

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

国のID

Responses

Response Schema: application/json
id
required
number

データセット ベーシック
国のID

name
required
string

データセット ベーシック
英語での国名

code
string

データセット ベーシック
国を表すコード（アルファ2）

Array of objects

データセット ベーシック
翻訳された国名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

name
string

データセット ベーシック
他の言語での国名

Response samples

Content type
application/json
{
  • "id": 16,
  • "name": "Australia",
  • "code": "AU",
  • "translated": [
    • {
      • "lang": "JA",
      • "name": "オーストラリア"
      }
    ]
}

チャート

チャートデータを取得するすべてのエンドポイント

/api/charts

Music Storyチャートを取得する

Authorizations:
Bearer
query Parameters
offset
integer >= 0
Default: 0

オフセット番号

limit
integer >= 0
Default: 20

限度数

Responses

Response Schema: application/json
Array of objects
Array
id
required
number

データセット チャート
チャートのID

name
required
string

データセット チャート
チャート名

area
required
string

データセット チャート
チャートのエリア名

source
required
string

データセット チャート
チャートのソース名

official
required
boolean

データセット チャート
公式チャート情報

country_code
required
string

データセット チャート
ISO3166-1アルファ2標準に従った、アーティストの国の2文字コード

offset
number
limit
number
total
number

Response samples

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

/api/charts/{id_charts}/dates

Music Storyチャート日付を取得する

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

データセット チャート
チャートの日付エントリのID

start_date
string <date>

データセット チャート
チャート期間の開始日

end_date
string <date>

データセット チャート
チャート期間の終了日

matched
number

データセット チャート
チャートの日付期間が一致しているかどうかを示す

total
number

データセット チャート
チャートの日付期間のエントリの総数

offset
number
limit
number
total
number

Response samples

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

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

Music Storyチャート行を取得する

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

データセット チャート
チャートの行エントリのID

artist_name
string

データセット チャート
チャート行のアーティスト名

album_title
string

データセット チャート
チャート行のアルバムタイトル

recording_title
string

データセット チャート
チャート行の録音名

rank
number

データセット チャート
チャート行のランク位置

previous_rank
number

データセット チャート
チャート行の前回のランク位置

best_rank
number

データセット チャート
チャート行の最高ランク位置

appearances
number

データセット チャート
チャート行の出現回数

date_in
string <date>

データセット チャート
チャート行に入った日付

rank_in
number

データセット チャート
チャート行に入ったときのランク位置

date_out
string <date>

データセット チャート
チャート行から出た日付

rank_out
number

データセット チャート
チャート行から出たときのランク位置

object

データセット チャート
チャート行のMusic Storyアーティスト情報

id
number

データセット チャート
チャート行のMusic StoryアーティストID

name
string

データセット チャート
チャート行のMusic Storyアーティスト名

object

データセット チャート
チャート行のMusic Storyアルバム情報

id
number

データセット チャート
チャート行のMusic StoryアルバムID

title
string

データセット チャート
チャート行のMusic Storyアルバムタイトル

Array of objects

データセット チャート
チャート行のMusic Story録音情報

Array
id
number

データセット チャート
チャート行のMusic Story録音ID

title
string

データセット チャート
チャート行のMusic Story録音タイトル

subtitle
string

データセット チャート
チャート行のMusic Story録音サブタイトル

offset
number
limit
number
total
number

Response samples

Content type
application/json
{
  • "results": [
    • {
      • "id": 5001,
      • "artist_name": "The Beatles",
      • "album_title": "Let It Be",
      • "recording_title": "Let It Be",
      • "rank": 1,
      • "previous_rank": 2,
      • "best_rank": 1,
      • "appearances": 10,
      • "date_in": "2023-08-01",
      • "rank_in": 1,
      • "date_out": "2023-10-10",
      • "rank_out": 50,
      • "ms_artist": {
        • "id": 1234,
        • "name": "The Beatles"
        },
      • "ms_album": {
        • "id": 5678,
        • "title": "Let It Be"
        },
      • "ms_recordings": [
        • {
          • "id": 91011,
          • "title": "Let It Be",
          • "subtitle": "Remastered"
          }
        ]
      }
    ],
  • "offset": 0,
  • "limit": 20,
  • "total": 45
}

公演タイプ

公演タイプデータを取得するすべてのエンドポイント

/api/show-type

Music Story公演タイプを取得する

Authorizations:
Bearer
query Parameters
offset
integer >= 0
Default: 0

オフセット番号

limit
integer >= 0
Default: 20

限度数

Responses

Response Schema: application/json
Array of objects
Array
id
required
number

データセット ショー
公演タイプのID

name
required
string

データセット ショー
公演タイプの名称（英語）

Array of objects

データセット ショー
公演タイプの翻訳名を含むリスト

Array
lang
string

データセット ショー
ISO-639標準に従った翻訳名の言語

name
string

データセット ショー
他の言語での公演タイプ名

offset
number
limit
number
total
number

Response samples

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

/api/show-type/{id}

Music Story公演タイプを取得する

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

公演タイプのID

Responses

Response Schema: application/json
id
required
number

データセット ショー
公演タイプのID

name
required
string

データセット ショー
公演タイプの名称（英語）

Array of objects

データセット ショー
公演タイプの翻訳名を含むリスト

Array
lang
string

データセット ショー
ISO-639標準に従った翻訳名の言語

name
string

データセット ショー
他の言語での公演タイプ名

Response samples

Content type
application/json
{
  • "id": 1,
  • "name": "Tour",
  • "translated": [
    • {
      • "lang": "FR",
      • "name": "Tournée"
      }
    ]
}

アーティスト名

アーティストのタイトルデータを取得するエンドポイント

/api/artist-title

このエンドポイントは、タイトルとアーティスト名でレコーディングを検索するために特別に設計されています。 アーティストとタイトルのタイポグラフィのバリエーション（アーティストの別名、アーティストの翻訳名、アーティストの姓と名の反転、タイプミス、不完全なタイトル名など）を処理するように最適化されています。 例えばラジオのプレイリスト検索が典型的なユースケースとなります。

Authorizations:
Bearer
query Parameters
name
required
string

アーティスト名

title
required
string

曲名

page
integer >= 1
Default: 1

ページ番号

Responses

Response Schema: application/json
Array of objects
Array
id
number

データセット ベーシック
音源のID

title
string

データセット ベーシック
録音タイトル

subtitle
string

データセット ベーシック
音源のサブタイトル

language
string

データセット ベーシック
収録言語

language_code
string

データセット ベーシック
ISO-639規格に準拠した音源言語

Array of objects

データセット ベーシック
音源の翻訳名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639標準に従った翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

title
string

データセット ベーシック
音源の翻訳タイトル

subtitle
string

データセット ベーシック
音源の翻訳サブタイトル

duration
string

データセット ベーシック
音源時間（フォーマット: HH:MM:SS）

isrc
string

データセット ベーシック
音源のISRC

object
name
string

データセット ベーシック
音源ジャンル名

id_genre
number

データセット ベーシック
音源ジャンルのID

hit
number

データセット ベーシック
音源がチャートにランクインした場合の評価

editors_pick
number

データセット ベーシック
Music Story編集部が推奨する音源の場合の評価

score
number

データセット ベーシック
検索に関連するスコア

Array of objects

データセット ベーシック
アーティストを含むリスト

Array
id
number

データセット ベーシック
アーティストのID

name
string

データセット ベーシック
アーティスト名

real_firstname_lastname
string

データセット ベーシック
アーティストの本名

Array of objects

データセット ベーシック
アーティストの別名を含むリスト

Array
link
string
Enum: "Alias" "Nickname"

データセット ベーシック
エイリアスの種類

alias
string

データセット ベーシック
別名

Array of objects

データセット ベーシック
アーティストの翻訳名を含むリスト

Array
lang
string

データセット ベーシック
ISO-639規格に準拠した翻訳名の言語

rfc_5646
string

データセット ベーシック
RFC 5646標準に従った翻訳名の言語

name
string

データセット ベーシック
他言語でのアーティスト名

type
string
Enum: "Person" "Band"

データセット ベーシック
アーティストのタイプ

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

データセット ベーシック
アーティストの性質

picture
string

データセット 写真-ゲッティ / ピクチャー・キュレーション / ピクチャーレーベル
写真のパス

Array of objects

データセット ベーシック
アーティストのジャンルを含む配列

Array
link
string
Enum: "Main" "Principal" "Secondary" "Influence"

データセット ベーシック
関係タイプ

name
string

データセット ベーシック
ジャンル名

id_genre
number

データセット ベーシック
アーティストの人気度（パーセント）

Array of objects

データセット ベーシック
この音源におけるアーティストの役割を含むリスト

Array
id_role
number

データセット ベーシック
役割のID

name
string

データセット ベーシック
役割の名前

popularity
number

データセット 人気
アーティストの人気度（パーセント

Array of objects

データセット ベーシック
アルバムを含むリスト

Array
id
number

データセット ベーシック
アルバムのID

title
string

データセット ベーシック
アルバムタイトル

label
string

データセット ベーシック
アルバムのレーベル

distributor
string

データセット ベーシック
アルバムの販売元

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

データセット ベーシック
アルバムの種類

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

データセット ベーシック
アルバムのフォーマット

original_release_date
string

データセット ベーシック
アルバムのオリジナル発売日（フォーマット: YYYY-MM-DD。不明な日または月の場合は “00”）

cover_art
string

データセット アートワーク
カバーアートのパス

cover_art_400
string

データセット アートワーク
カバーアートのパス400

Array of objects

データセット ベーシック
アルバムのジャンルを含むリスト

Array
id_genre
number

データセット ベーシック
ジャンルID

name
string

データセット ベーシック
ジャンル名

popularity
number

データセット 人気
音源の人気度（パーセント）

page
number
totalPages
number
totalHits
number

Response samples

Content type
application/json
{
  • "hits": [],
  • "page": 1,
  • "totalPages": 50,
  • "totalHits": 1000
}

推薦

推薦データを取得するエンドポイント

/api/recommendation

このエンドポイントは、1つ以上のアーティスト名または1つ以上のトラック名からプレイリストを作成するために特別に設計されています。 結果は、アーティスト間のリンク、ジャンル、アーティストのユニバースなどを含む編集作業に基づいています。 また、ムードやBPMなどのオーディオ指標を使用して結果を調整することも可能です。

  • ms_track_idsまたはms_artist_idsのいずれか1つが必須です
Authorizations:
Bearer
query Parameters
ms_track_ids
string

Number or comma separated list of number
One or a list of Music Story Track ID

ms_artist_ids
string

Number or comma separated list of number
One or a list of Music Story Artist ID

audio_bpm
integer [ 1 .. 3 ]
Default: null

Required BPM level [ 1:low, 2:medium or 3:high ]

audio_arousal
integer [ 1 .. 3 ]
Default: null

Required Arousal level [ 1:low, 2:medium or 3:high ]

audio_valence
integer [ 1 .. 3 ]
Default: null

Required Valence level [ 1:low, 2:medium or 3:high ]

audio_intensity
integer [ 1 .. 3 ]
Default: null

Required Intensity level [ 1:low, 2:medium or 3:high ]

audio_moods
string
Default: null

String or comma separated list of string
One or several moods

year_range
integer [ 1 .. 100 ]
Default: 5

Years of recommendation range in more or less compared to given ID Tracks

results_nb
integer [ 10 .. 500 ]
Default: 500

Number of results - number [ 10 .. 500 ]

min_accuracy
integer [ 0 .. 100 ]
Default: 32

Minimum accuracy for selection of corresponding artists - number [ 0 .. 100 ]

order_by
string
Default: null

Order by results [ match, popularity or random ]

Responses

Response Schema: application/json
Array of objects

データセット API推奨
推奨トラックを含むリスト

Array
id
number

データセット API推奨
音源のID

match
number

データセット API推奨
推薦結果の関連性スコア

title
string

データセット API推奨
音源タイトル

subtitle
string

データセット API推奨
音源のサブタイトル

object
id_genre
number

データセット API推奨
音源ジャンル

name
string

データセット API推奨
音源ジャンル

popularity
number

データセット API推奨
音源の人気スコア

Array of objects

データセット API推奨
音源に関連するアーティスト情報を含むリスト

Array
id_artist
number

データセット API推奨
アーティストのID

name
string

データセット API推奨
アーティスト名

Array of objects

データセット API推奨
音源の特徴音声を含むリスト

Array
bpm
string

データセット API推奨
音源のBPM値

Array of objects

データセット API推奨
音源のムード

Array
value
number

データセット API推奨
ムード値の記録

name
string

データセット API推奨
録音ムード名

arousal
string

データセット API推奨
音源の覚醒度

valence
string

データセット API推奨
音源の感情度

intensity
string

データセット API推奨
音源の強度

object

データセット API推奨
音源のオリジナルアルバム

id
number

データセット API推奨
音源のオリジナルアルバムID

title
string

データセット API推奨
音源のオリジナルアルバムタイトル

original_release_date
string

データセット API推奨
音源のオリジナルリリース日

Response samples

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

レポート

レポートデータを取得するエンドポイント

/report/picture/usage

このエンドポイントを使用して、複数の画像の使用状況を報告します。このエンドポイントに一度に送信できる画像の数は1000までに制限されています。

Authorizations:
Bearer
Request Body schema: application/json
required
id_transaction
required
integer > 0

このトランザクションIDは、トランザクションの追跡に使用します。

test
boolean
Default: false

このフィールドをtrueに設定して、この画像使用レポートをテストとしてマークします。

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

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "errors": [
    • {
      • "type": "Syntax error",
      • "message": "リクエストペイロードに無効なJSONデータが含まれています。"
      }
    ]
}

健康

健康データを取得するエンドポイント

/health

APIが利用可能かどうかを確認するために、このエンドポイントを使用します。

Responses

Response Schema: application/json
status
string

APIステータス

Response samples

Content type
application/json
{
  • "status": "available"
}

モニタリング

モニタリングデータを取得するエンドポイント

/user/api/status

このポイントを使用して、ユーザーがAPIをどの段階で使用しているかを確認します。

Responses

Response Schema: application/json
X-Rate-Limit-Remaining
number

データセット ベーシック
現在のレートリミットウィンドウ内で残りのリクエスト数

X-Rate-Limit-Limit
number

データセット ベーシック
1日あたりのリクエスト可能な最大数

X-Rate-Limit-Retry-After
number

データセット ベーシック
レートリミットウィンドウがリセットされるまでの残り秒数

Response samples

Content type
application/json
{
  • "X-Rate-Limit-Remaining": 185,
  • "X-Rate-Limit-Limit": 200,
  • "X-Rate-Limit-Retry-After": 0
}

健康

健康データを取得するエンドポイント

/health

APIが利用可能かどうかを確認するために、このエンドポイントを使用します。

Responses

Response Schema: application/json
status
string

APIステータス

Response samples

Content type
application/json
{
  • "status": "available"
}

モニタリング

モニタリングデータを取得するエンドポイント

/user/api/status

このポイントを使用して、ユーザーがAPIをどの段階で使用しているかを確認します。

Responses

Response Schema: application/json
X-Rate-Limit-Remaining
number

データセット ベーシック
現在のレートリミットウィンドウ内で残りのリクエスト数

X-Rate-Limit-Limit
number

データセット ベーシック
1日あたりのリクエスト可能な最大数

X-Rate-Limit-Retry-After
number

データセット ベーシック
レートリミットウィンドウがリセットされるまでの残り秒数

Response samples

Content type
application/json
{
  • "X-Rate-Limit-Remaining": 185,
  • "X-Rate-Limit-Limit": 200,
  • "X-Rate-Limit-Retry-After": 0
}