# LINE MUSIC Analytics APIリファレンス

# 目次

目次
共通仕様
アクセストークン
- アクセストークンを取得する
アーティスト
アルバム
ビデオアルバム
- ビデオアルバムのリストを取得する
- ビデオアルバムの情報を取得する
トラック
ビデオトラック
ランキング
レポート
オブジェクト

# 共通仕様

# レート制限

APIにはレート制限が適用されています。
レート制限を超えて送信を行った場合、429 Too Many Requestsが返ります。

# ステータスコード

APIの実行後、下記のステータスコードが返ります。

ステータスコード	説明
200 OK	リクエストが成功し、リソースが取得されました。
201 Created	リクエストが成功し、リソースが作成されました。
400 Bad Request	リクエストに不備があり、処理が行えませんでした。
401 Unauthorized	認証に失敗しました。
404 Not Found	取得しようとしたリソースが見つかりません。
429 Too Many Requests	レート制限を超えました。
500 Internal Server Error	サーバー内部でエラーが発生しました。

# アクセストークン

APIを実行するためにはアクセストークンが必要になります。
アクセストークンを発行するためには事前にクレデンシャルを作成する必要があります。
クレデンシャルの作成方法については、「クレデンシャルの作成方法」を参照してください。

アクセストークンはOAuth 2.0のクライアントクレデンシャルグラント (opens new window)で提供されます。
具体的な取得方法は「アクセストークンを取得する」を参照してください。
クライアントクレデンシャルグラントに対応したものであれば各種OAuth2クライアントライブラリがご利用いただけます。

# 日時型のフォーマット

日時の値はISO8601に準拠したフォーマットになります。
オブジェクトやレスポンスに含まれる型ごとのフォーマットは、下記のとおりです。

型	値の例
DateTime	2021-06-01T12:34:56.789Z
Date	2021-06-01

# エラーレスポンス

エラー発生時は、下記のレスポンスが返ります。

項目名	型	Not Null	説明
summary	String	○	エラーの概要
details	エラー詳細オブジェクトの配列	○	エラーの詳細詳しくは、「エラー詳細オブジェクト」を参照してください。

# エラー詳細オブジェクト

項目名	型	Not Null	説明
field_names	Stringの配列	○	エラーがあったフィールドのリスト
message	String	○	エラーメッセージ

# レスポンス例

{
  "summary": "List album is fail.",
  "details": [
    {
      "field_names": [
        "limit"
      ],
      "message": "limit is not int type."
    },
    {
      "field_names": [
        "upc",
        "product_number",
        "artist_id"
      ],
      "message": "Can not set more than 1 at the same time.[upc,product_number,artist_id]"
    }
  ]
}

# アクセストークン

# アクセストークンを取得する

APIを利用するためのアクセストークンを取得します。

# HTTPリクエスト

POST https://api-music.line.me/v1/token

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	認証をするためのトークンを設定してください。詳しくは、「認証するためのトークン」を参照してください。
Content-Type	String	○	`application/x-www-form-urlencoded`固定

# 認証するためのトークン

OAuth2のクライアントパスワード (opens new window)におけるヘッダーを使った認証を提供しています。
トークンのフォーマットや値の設定方法については、OAuth2ドキュメントのクライアントパスワード (opens new window)を参照ください。

# リクエストボディ

項目名	型	必須	デフォルト	説明
grant_type	String	○		`client_credentials`固定

# リクエスト例

 curl \
  -X POST \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "Authorization:Basic ${TOKEN}" \
  -d 'grant_type=client_credentials' \
  'https://api-music.line.me/v1/token'

# レスポンス

項目名	型	Not Null	説明
access_token	String	○	発行されたアクセストークン
expires_in	Number	○	アクセストークンが発行されてから有効期限が切れるまでの秒数
scope	String	○	スコープをスペース区切りにしたもの
token_type	String	○	トークンのタイプ `Bearer`固定。

# レスポンス例

{
  "access_token" : "IGte36U...",
  "expires_in" : 3600,
  "scope" : "READ",
  "token_type" : "Bearer"
}

# アーティスト

# アーティストのリストを取得する

アーティストのリストを取得します。
アーティストのリストは、アーティストオブジェクトのidプロパティの値によりソートされます。

# HTTPリクエスト

GET https://api-music.line.me/v1/artists

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# クエリパラメータ

項目名	型	デフォルト	説明
limit	Number	10	1回で取得するデータの件数 1〜100の値を指定してください。
offset	Number	0	取得するデータの開始位置 0から始まります。 0〜3000000の値を指定してください。
order	String	DESC	ソートの並び順下記のいずれかを指定してください。 `DESC` `ASC`

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/artists?limit=10&offset=0&order=DESC"

# レスポンス

項目名	型	Not Null	説明
artists	アーティストオブジェクトの配列	○	詳しくは、「アーティストオブジェクト」を参照してください。リストの最大件数はlimitで指定した件数になります。
total_count	Number	○	条件に合致した総件数
limit	Number	○	検索で実行されたデータの件数クエリパラメータの`limit`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
offset	Number	○	検索で実行されたデータの開始位置クエリパラメータの`offset`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
order	Number	○	検索で実行されたソートの並び順クエリパラメータの`order`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。

# レスポンス例

{
  "artists": [
    {
      "id": "mi0000000000000000",
      "name": "LINE MUSIC CORPORATION",
      "images": [
        {
          "width": 160,
          "height": 160,
          "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m160x160"
        },
        {
          "width": 470,
          "height": 470,
          "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m470x470"
        },
        {
          "width": 630,
          "height": 630,
          "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m630x630"
        }
      ],
      "description": "LINEで使われている音や楽曲を提供します。\n普段、LINEの着信などで気になる曲が入っているかもしれません。\n",
      "additional_name": "LINE MUSIC CORPORATION,ラインミュージックコーポレーション",
      "editable_additional_name": "LINE MUSIC CORPORATION,ラインミュージックコーポレーション",
      "label_id": "bl0000000000000000",
      "label_name": "LINE MUSIC",
      "page_url": "https://music.line.me/launch?target=artist&item=mi0000000000000000&cc=JP&v=1",
      "album_counts": {
        "total_count": 30,
        "published_count": 20,
        "unpublished_count": 10
      },
      "video_album_counts": {
        "total_count": 30,
        "published_count": 20,
        "unpublished_count": 10
      },
      "track_counts": {
        "total_count": 30,
        "published_count": 20,
        "unpublished_count": 10
      },
      "video_track_counts": {
        "total_count": 30,
        "published_count": 20,
        "unpublished_count": 10
      },
      "display_status": "VISIBLE",
      "main_artist_id": "mi0000000000000000",
      "main_artist_name": "LINE MUSIC CORPORATION",
      "main_artist_favorite_count": 12345,
      "main_artist_search_access_count": 12345
    }
  ],
  "total_count": 1000,
  "limit": 10,
  "offset": 0,
  "order": "DESC"
}

# アーティストの情報を取得する

アーティストIDを指定しアーティストの情報を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/artists/{id}

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# パスパラメータ

項目名	型	必須	説明
id	String	○	取得したいアーティストのID

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/artists/mi0000000000000000"

# レスポンス

アーティストオブジェクトの内容が返ります。
詳しくは、「アーティストオブジェクト」を参照してください。

# レスポンス例

{
  "id": "mi0000000000000000",
  "name": "LINE MUSIC CORPORATION",
  "images": [
    {
      "width": 160,
      "height": 160,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m160x160"
    },
    {
      "width": 470,
      "height": 470,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m470x470"
    },
    {
      "width": 630,
      "height": 630,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m630x630"
    }
  ],
  "description": "LINEで使われている音や楽曲を提供します。\n普段、LINEの着信などで気になる曲が入っているかもしれません。\n",
  "additional_name": "LINE MUSIC CORPORATION,ラインミュージックコーポレーション",
  "editable_additional_name": "LINE MUSIC CORPORATION,ラインミュージックコーポレーション",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "page_url": "https://music.line.me/launch?target=artist&item=mi0000000000000000&cc=JP&v=1",
  "album_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "video_album_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "track_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "video_track_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "display_status": "VISIBLE",
  "main_artist_id": "mi0000000000000000",
  "main_artist_name": "LINE MUSIC CORPORATION",
  "main_artist_favorite_count": 12345,
  "main_artist_search_access_count": 12345
}

# メインアーティストとは

メインアーティストは同一のアーティストが複数登録されている場合にLINE MUSIC上で表示されるアーティストを指します。

# アルバム

# アルバムのリストを取得する

アルバムのリストを取得します。
アルバムのリストは、アルバムオブジェクトのidプロパティの値によりソートされます。

# HTTPリクエスト

GET https://api-music.line.me/v1/albums

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# クエリパラメータ

項目名	型	必須	デフォルト	説明
upc	String	△		UPC
product_number	String	△		品番
artist_id	String	△		アーティストのID
limit	Number		10	1回で取得するデータの件数 1〜100の値を指定してください。
offset	Number		0	取得するデータの開始位置 0から始まります。 0〜300000の値を指定してください。
order	String		DESC	ソートの並び順下記のいずれかを指定してください。 `DESC` `ASC`

# 必須項目について

upc / product_number / artist_id には下記の入力制限があります。

上記の項目のうち1つは必ず指定してください
上記の項目は同時に複数指定できません

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/albums?artist_id=mi0000000000000000&limit=10&offset=0&order=DESC"

# レスポンス

項目名	型	Not Null	説明
albums	アルバムオブジェクトの配列	○	詳しくは、「アルバムオブジェクト」を参照してください。リストの最大件数はlimitで指定した件数になります。
total_count	Number	○	条件に合致した総件数
limit	Number	○	検索で実行されたデータの件数クエリパラメータの`limit`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
offset	Number	○	検索で実行されたデータの開始位置クエリパラメータの`offset`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
order	Number	○	検索で実行されたソートの並び順クエリパラメータの`order`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。

# レスポンス例

{
  "albums": [
    {
      "id": "mb0000000000000000",
      "name": "CLOSING FRIDAY",
      "images": [
        {
          "width": 160,
          "height": 160,
          "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m160x160"
        },
        {
          "width": 470,
          "height": 470,
          "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m470x470"
        },
        {
          "width": 630,
          "height": 630,
          "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m630x630"
        }
      ],
      "description": "このアルバムはLINEで使われているメロディを収録したものです。\n普段、LINEの着信などで気になる曲が入っているかもしれません。\n",
      "additional_name": "CLOSING FRIDAY,クロージングフライデー",
      "editable_additional_name": "CLOSING FRIDAY,クロージングフライデー",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "label_id": "bl0000000000000000",
      "label_name": "LINE MUSIC",
      "sub_label_name": "LINE MUSIC CORPORATION",
      "page_url": "https://music.line.me/launch?target=album&item=mb0000000000000000&cc=JP&v=1",
      "disc_count": 2,
      "track_count": 12,
      "favorite_count": 12345,
      "search_access_count": 12345,
      "genre": "邦楽",
      "release_time": "2021-04-01T00:00:00.000Z",
      "streaming_status": {
        "deleted": true,
        "publish_status": "NOT_PUBLISHED",
        "publish_start_time": "2021-04-01T00:00:00.000Z",
        "publish_end_time": "2021-04-30T23:59:59.000Z"
      },
      "purchase_status": {
        "deleted": true,
        "publish_status": "NOT_PUBLISHED",
        "purchase_target": "ALBUM",
        "price_code": "STAP",
        "publish_start_time": "2021-04-01T00:00:00.000Z",
        "publish_end_time": "2021-04-30T23:59:59.000Z"
      },
      "price": 120,
      "upc": "4000000000000",
      "product_number": "CODE-00001",
      "grid": "A1-2425G-ABC1234002-M",
      "package_id": "PKG-00001",
      "last_update_time": "2021-04-01T12:34:56.000Z"
    }
  ],
  "total_count": 1000,
  "limit": 10,
  "offset": 0,
  "order": "DESC"
}

# アルバムの情報を取得する

アルバムIDを指定しアルバムの情報を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/albums/{id}

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# パスパラメータ

項目名	型	必須	説明
id	String	○	取得したいアルバムのID

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/albums/mb0000000000000000"

# レスポンス

アルバムオブジェクトの内容が返ります。
詳しくは、「アルバムオブジェクト」を参照してください。

# レスポンス例

{
  "id": "mb0000000000000000",
  "name": "CLOSING FRIDAY",
  "images": [
    {
      "width": 160,
      "height": 160,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m160x160"
    },
    {
      "width": 470,
      "height": 470,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m470x470"
    },
    {
      "width": 630,
      "height": 630,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m630x630"
    }
  ],
  "description": "このアルバムはLINEで使われているメロディを収録したものです。\n普段、LINEの着信などで気になる曲が入っているかもしれません。\n",
  "additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "editable_additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": "https://music.line.me/launch?target=album&item=mb0000000000000000&cc=JP&v=1",
  "disc_count": 2,
  "track_count": 12,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "release_time": "2021-04-01T00:00:00.000Z",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "purchase_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "purchase_target": "ALBUM",
    "price_code": "STAP",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "price": 120,
  "upc": "4000000000000",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "package_id": "PKG-00001",
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# アルバムのエンベッド情報を取得する

アルバムIDを指定しアルバムのエンベッド情報を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/albums/{id}/embed

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# パスパラメータ

項目名	型	必須	説明
id	String	○	取得したいアルバムのID

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/albums/mb0000000000000000/embed"

# レスポンス

エンベッドオブジェクトの内容が返ります。
詳しくは、「エンベッドオブジェクト」を参照してください。

# レスポンス例

{
  "url": "https://music.line.me/webapp/embed/track/mb0000000000000000?width=0&height=0&isPC=true&autoPlay=false",
  "iframe_tag": "<iframe id='linemusic' src='https://music.line.me/webapp/embed/track/mb0000000000000000?width=0&height=0&isPC=true&autoPlay=false' width='0' height='0' frameborder='no' scrolling='no' marginwidth='0' marginheight='0' allow='autoplay' allowfullscreen></iframe>"
}

# ビデオアルバム

ビデオアルバムのリストを取得します。
ビデオアルバムのリストは、ビデオアルバムオブジェクトのidプロパティの値によりソートされます。

GET https://api-music.line.me/v1/video-albums

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

項目名	型	必須	デフォルト	説明
upc	String	△		UPC
product_number	String	△		品番
artist_id	String	△		アーティストのID
limit	Number		10	1回で取得するデータの件数 1〜100の値を指定してください。
offset	Number		0	取得するデータの開始位置 0から始まります。 0〜300000の値を指定してください。
order	String		DESC	ソートの並び順下記のいずれかを指定してください。 `DESC` `ASC`

upc / product_number / artist_id には下記の入力制限があります。

上記の項目のうち1つは必ず指定してください
上記の項目は同時に複数指定できません

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/video-albums?artist_id=mi0000000000000000&limit=10&offset=0&order=DESC"

項目名	型	Not Null	説明
video_albums	ビデオアルバムオブジェクトの配列	○	詳しくは、「ビデオアルバムオブジェクト」を参照してください。リストの最大件数はlimitで指定した件数になります。
total_count	Number	○	条件に合致した総件数
limit	Number	○	検索で実行されたデータの件数クエリパラメータの`limit`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
offset	Number	○	検索で実行されたデータの開始位置クエリパラメータの`offset`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
order	Number	○	検索で実行されたソートの並び順クエリパラメータの`order`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。

{
  "video_albums": [
    {
      "id": "mt0000000000000000",
      "name": "CLOSING FRIDAY",
      "additional_name": "CLOSING FRIDAY,クロージングフライデー",
      "editable_additional_name": "CLOSING FRIDAY,クロージングフライデー",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "label_id": "bl0000000000000000",
      "label_name": "LINE MUSIC",
      "sub_label_name": "LINE MUSIC CORPORATION",
      "page_url": "https://music.line.me/launch?target=track&item=mb0000000000000000&subitem=mt0000000000000000&cc=JP&v=1",
      "album_disc_no": 1,
      "album_track_no": 1,
      "play_duration": 195,
      "play_count": 12345,
      "favorite_count": 12345,
      "search_access_count": 12345,
      "genre": "邦楽",
      "streaming_status": {
        "deleted": true,
        "publish_status": "NOT_PUBLISHED",
        "publish_start_time": "2021-04-01T00:00:00.000Z",
        "publish_end_time": "2021-04-30T23:59:59.000Z"
      },
      "purchase_status": {
        "deleted": true,
        "publish_status": "NOT_PUBLISHED",
        "purchase_target": "ALBUM",
        "price_code": "STAP",
        "publish_start_time": "2021-04-01T00:00:00.000Z",
        "publish_end_time": "2021-04-30T23:59:59.000Z"
      },
      "price": 120,
      "isrc": "JPQ123456789",
      "product_number": "CODE-00001",
      "grid": "A1-2425G-ABC1234002-M",
      "rights_information": {
        "lyricist": "The lyricist",
        "translator": "The translator",
        "composer": "The composer",
        "arranger": "The arranger",
        "artist": "The artist",
        "ivt_type": "I",
        "lyric_translation_type": 1,
        "il_type": "I",
        "medley_type": "M"
      },
      "last_update_time": "2021-04-01T12:34:56.000Z"
    }
  ],
  "total_count": 1000,
  "limit": 10,
  "offset": 0,
  "order": "DESC"
}

# ビデオアルバムの情報を取得する

ビデオアルバムIDを指定しビデオアルバムの情報を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/video-albums/{id}

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# パスパラメータ

項目名	型	必須	説明
id	String	○	取得したいビデオアルバムのID

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/video-albums/vb0000000000000000"

# レスポンス

ビデオアルバムオブジェクトの内容が返ります。
詳しくは、「ビデオアルバムオブジェクト」を参照してください。

# レスポンス例

{
  "id": "vb0000000000000000",
  "name": "LINE MUSIC PR Movie",
  "images": [
    {
      "width": 160,
      "height": 90,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m160x90"
    },
    {
      "width": 480,
      "height": 270,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m480x270"
    },
    {
      "width": 640,
      "height": 360,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m640x360"
    }
  ],
  "description": "無料ユーザーも全楽曲を毎月フル再生できるようになりました！  \n是非この機会に登録してみてください。\n",
  "additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "editable_additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": null,
  "disc_count": 2,
  "video_track_count": 12,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "release_time": "2021-04-01T00:00:00.000Z",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "upc": "4000000000000",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "package_id": "PKG-00001",
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# トラック

# トラックのリストを取得する

トラックのリストを取得します。
トラックのリストは、トラックオブジェクトのidプロパティの値によりソートされます。

# HTTPリクエスト

GET https://api-music.line.me/v1/tracks

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# クエリパラメータ

項目名	型	必須	デフォルト	説明
isrc	String	△		ISRC
product_number	String	△		品番
artist_id	String	△		アーティストのID
album_id	String	△		アルバムのID
limit	Number		10	1回で取得するデータの件数 1〜100の値を指定してください。
offset	Number		0	取得するデータの開始位置 0から始まります。 0〜300000の値を指定してください。
order	String		DESC	ソートの並び順下記のいずれかを指定してください。 `DESC` `ASC`

# 必須項目について

isrc / product_number / artist_id / album_id には下記の入力制限があります。

上記の項目のうち1つは必ず指定してください
上記の項目は同時に複数指定できません

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/tracks?artist_id=mi0000000000000000&limit=10&offset=0&order=DESC"

# レスポンス

項目名	型	Not Null	説明
tracks	トラックオブジェクトの配列	○	詳しくは、「トラックオブジェクト」を参照してください。リストの最大件数はlimitで指定した件数になります。
total_count	Number	○	条件に合致した総件数
limit	Number	○	検索で実行されたデータの件数クエリパラメータの`limit`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
offset	Number	○	検索で実行されたデータの開始位置クエリパラメータの`offset`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
order	Number	○	検索で実行されたソートの並び順クエリパラメータの`order`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。

# レスポンス例

{
  "tracks": [
    {
      "id": "mt0000000000000000",
      "name": "CLOSING FRIDAY",
      "additional_name": "CLOSING FRIDAY,クロージングフライデー",
      "editable_additional_name": "CLOSING FRIDAY,クロージングフライデー",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "label_id": "bl0000000000000000",
      "label_name": "LINE MUSIC",
      "sub_label_name": "LINE MUSIC CORPORATION",
      "page_url": "https://music.line.me/launch?target=track&item=mb0000000000000000&subitem=mt0000000000000000&cc=JP&v=1",
      "album_disc_no": 1,
      "album_track_no": 1,
      "play_duration": 195,
      "play_count": 12345,
      "favorite_count": 12345,
      "search_access_count": 12345,
      "genre": "邦楽",
      "streaming_status": {
        "deleted": true,
        "publish_status": "NOT_PUBLISHED",
        "publish_start_time": "2021-04-01T00:00:00.000Z",
        "publish_end_time": "2021-04-30T23:59:59.000Z"
      },
      "purchase_status": {
        "deleted": true,
        "publish_status": "NOT_PUBLISHED",
        "purchase_target": "ALBUM",
        "price_code": "STAP",
        "publish_start_time": "2021-04-01T00:00:00.000Z",
        "publish_end_time": "2021-04-30T23:59:59.000Z"
      },
      "price": 120,
      "isrc": "JPQ123456789",
      "product_number": "CODE-00001",
      "grid": "A1-2425G-ABC1234002-M",
      "rights_information": {
        "lyricist": "The lyricist",
        "translator": "The translator",
        "composer": "The composer",
        "arranger": "The arranger",
        "artist": "The artist",
        "ivt_type": "I",
        "lyric_translation_type": 1,
        "il_type": "I",
        "medley_type": "M"
      },
      "last_update_time": "2021-04-01T12:34:56.000Z"
    }
  ],
  "total_count": 1000,
  "limit": 10,
  "offset": 0,
  "order": "DESC"
}

# トラックの情報を取得する

トラックIDを指定しトラックの情報を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/tracks/{id}

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# パスパラメータ

項目名	型	必須	説明
id	String	○	取得したいトラックのID

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/tracks/mt0000000000000000"

# レスポンス

トラックオブジェクトの内容が返ります。
詳しくは、「トラックオブジェクト」を参照してください。

# レスポンス例

{
  "id": "mt0000000000000000",
  "name": "CLOSING FRIDAY",
  "additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "editable_additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "album_id": "mb0000000000000000",
  "album_name": "CLOSING FRIDAY",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": "https://music.line.me/launch?target=track&item=mb0000000000000000&subitem=mt0000000000000000&cc=JP&v=1",
  "album_disc_no": 1,
  "album_track_no": 1,
  "play_duration": 195,
  "play_count": 12345,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "purchase_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "purchase_target": "ALBUM",
    "price_code": "STAP",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "price": 120,
  "isrc": "JPQ123456789",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "rights_information": {
    "lyricist": "The lyricist",
    "translator": "The translator",
    "composer": "The composer",
    "arranger": "The arranger",
    "artist": "The artist",
    "ivt_type": "I",
    "lyric_translation_type": 1,
    "il_type": "I",
    "medley_type": "M"
  },
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# トラックのエンベッド情報を取得する

トラックIDを指定しトラックのエンベッド情報を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/tracks/{id}/embed

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# パスパラメータ

項目名	型	必須	説明
id	String	○	取得したいトラックのID

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/tracks/mt0000000000000000/embed"

# レスポンス

エンベッドオブジェクトの内容が返ります。
詳しくは、「エンベッドオブジェクト」を参照してください。

# レスポンス例

{
  "url": "https://music.line.me/webapp/embed/track/mt0000000000000000?width=0&height=0&isPC=true&autoPlay=false",
  "iframe_tag": "<iframe id='linemusic' src='https://music.line.me/webapp/embed/track/mt0000000000000000?width=0&height=0&isPC=true&autoPlay=false' width='0' height='0' frameborder='no' scrolling='no' marginwidth='0' marginheight='0' allow='autoplay' allowfullscreen></iframe>"
}

# トラックカタログの情報を取得する

トラックカタログの情報を取得します。
トラックカタログの詳しくは、「LINE MUSIC Analytics カタログ定義書」を参照してください。

# HTTPリクエスト

GET https://api-music.line.me/v1/track-catalogs

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/track-catalogs"

# レスポンス

項目名	型	Not Null	説明
catalogs	カタログオブジェクトの配列	○	カタログのリスト詳しくは、「カタログオブジェクト」を参照してください。

# レスポンス例

{
  "catalogs": [
    {
      "date": "2021-08-01",
      "label_id": "bl0000000000000000",
      "url": "https://lmj-label-catalog.line-objects.com/20210801/lm_tracks_bl0000000000000001_20210801.zip?AWSAccessKeyId=keyvalue&Expires=1619174343&Signature=testsignature",
      "url_expires": "2021-08-02T12:34:56.000Z"
    }
  ]
}

# ビデオトラック

ビデオトラックのリストを取得します。
ビデオトラックのリストは、ビデオトラックオブジェクトのidプロパティの値によりソートされます。

GET https://api-music.line.me/v1/video-tracks

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

項目名	型	必須	デフォルト	説明
isrc	String	△		ISRC
product_number	String	△		品番
artist_id	String	△		アーティストのID
video_album_id	String	△		ビデオアルバムのID
limit	Number		10	1回で取得するデータの件数 1〜100の値を指定してください。
offset	Number		0	取得するデータの開始位置 0から始まります。 0〜300000の値を指定してください。
order	String		DESC	ソートの並び順下記のいずれかを指定してください。 `DESC` `ASC`

isrc / product_number / artist_id / video_album_id には下記の入力制限があります。

上記の項目のうち1つは必ず指定してください
上記の項目は同時に複数指定できません

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/video-tracks?artist_id=mi0000000000000000&limit=10&offset=0&order=DESC"

項目名	型	Not Null	説明
video_tracks	ビデオトラックオブジェクトの配列	○	詳しくは、「ビデオトラックオブジェクト」を参照してください。リストの最大件数はlimitで指定した件数になります。
total_count	Number	○	条件に合致した総件数
limit	Number	○	検索で実行されたデータの件数クエリパラメータの`limit`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
offset	Number	○	検索で実行されたデータの開始位置クエリパラメータの`offset`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
order	Number	○	検索で実行されたソートの並び順クエリパラメータの`order`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。

{
  "video_tracks": [
    {
      "id": "mv0000000000000000",
      "name": "LINE MUSIC PR Movie",
      "images": [
        {
          "width": 160,
          "height": 90,
          "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m160x90"
        },
        {
          "width": 480,
          "height": 270,
          "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m480x270"
        },
        {
          "width": 640,
          "height": 360,
          "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m640x360"
        }
      ],
      "additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
      "editable_additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "video_album_id": "vb0000000000000000",
      "video_album_name": "LINE MUSIC PR Movie",
      "label_id": "bl0000000000000000",
      "label_name": "LINE MUSIC",
      "sub_label_name": "LINE MUSIC CORPORATION",
      "page_url": "https://music.line.me/launch?target=playSingleVideo&item=mv0000000000000000&cc=JP&v=1&lang=ja",
      "video_album_disc_no": 1,
      "video_album_track_no": 1,
      "play_duration": 195,
      "play_count": 12345,
      "favorite_count": 12345,
      "search_access_count": 12345,
      "genre": "邦楽",
      "streaming_status": {
        "deleted": true,
        "publish_status": "NOT_PUBLISHED",
        "publish_start_time": "2021-04-01T00:00:00.000Z",
        "publish_end_time": "2021-04-30T23:59:59.000Z"
      },
      "isrc": "JPQ123456789",
      "product_number": "CODE-00001",
      "grid": "A1-2425G-ABC1234002-M",
      "rights_information": {
        "lyricist": "The lyricist",
        "translator": "The translator",
        "composer": "The composer",
        "arranger": "The arranger",
        "artist": "The artist",
        "ivt_type": "I",
        "lyric_translation_type": 1,
        "il_type": "I",
        "medley_type": "M"
      },
      "last_update_time": "2021-04-01T12:34:56.000Z"
    }
  ],
  "total_count": 1000,
  "limit": 10,
  "offset": 0,
  "order": "DESC"
}

# ビデオトラックの情報を取得する

ビデオトラックIDを指定しビデオトラックの情報を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/video-tracks/{id}

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# パスパラメータ

項目名	型	必須	説明
id	String	○	取得したいビデオトラックのID

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/video-tracks/mv0000000000000000"

# レスポンス

ビデオトラックオブジェクトの内容が返ります。
詳しくは、「ビデオトラックオブジェクト」を参照してください。

# レスポンス例

{
  "id": "mv0000000000000000",
  "name": "LINE MUSIC PR Movie",
  "images": [
    {
      "width": 160,
      "height": 90,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m160x90"
    },
    {
      "width": 480,
      "height": 270,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m480x270"
    },
    {
      "width": 640,
      "height": 360,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m640x360"
    }
  ],
  "additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "editable_additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "video_album_id": "vb0000000000000000",
  "video_album_name": "LINE MUSIC PR Movie",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": "https://music.line.me/launch?target=playSingleVideo&item=mv0000000000000000&cc=JP&v=1&lang=ja",
  "video_album_disc_no": 1,
  "video_album_track_no": 1,
  "play_duration": 195,
  "play_count": 12345,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "isrc": "JPQ123456789",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "rights_information": {
    "lyricist": "The lyricist",
    "translator": "The translator",
    "composer": "The composer",
    "arranger": "The arranger",
    "artist": "The artist",
    "ivt_type": "I",
    "lyric_translation_type": 1,
    "il_type": "I",
    "medley_type": "M"
  },
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# ビデオトラックカタログの情報を取得する

ビデオトラックカタログの情報を取得します。
ビデオトラックカタログの詳しくは、「LINE MUSIC Analytics カタログ定義書」を参照してください。

# HTTPリクエスト

GET https://api-music.line.me/v1/video-track-catalogs

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/video-track-catalogs"

# レスポンス

項目名	型	Not Null	説明
catalogs	カタログオブジェクトの配列	○	カタログのリスト詳しくは、「カタログオブジェクト」を参照してください。

# レスポンス例

{
  "catalogs": [
    {
      "date": "2021-08-01",
      "label_id": "bl0000000000000000",
      "url": "https://lmj-label-catalog.line-objects.com/20210801/lm_videos_bl0000000000000001_20210801.zip?AWSAccessKeyId=keyvalue&Expires=1619174343&Signature=testsignature",
      "url_expires": "2021-08-02T12:34:56.000Z"
    }
  ]
}

# ランキング

# トラックのリアルタイムランキングを取得する

トラックのリアルタイムのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/track/real-time

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/track/real-time"

# レスポンス

トラックランキングオブジェクトの内容が返ります。
詳しくは、「トラックランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "track_id": "mt0000000000000000",
      "track_name": "CLOSING FRIDAY",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "track_isrc": "JPQ123456789",
      "album_upc": "4000000000000"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# トラックのデイリーランキングを取得する

トラックのデイリーのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/track/daily

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/track/daily"

# レスポンス

トラックランキングオブジェクトの内容が返ります。
詳しくは、「トラックランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "track_id": "mt0000000000000000",
      "track_name": "CLOSING FRIDAY",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "track_isrc": "JPQ123456789",
      "album_upc": "4000000000000"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# トラックのウィークリーランキングを取得する

トラックのウィークリーのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/track/weekly

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/track/weekly"

# レスポンス

トラックランキングオブジェクトの内容が返ります。
詳しくは、「トラックランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "track_id": "mt0000000000000000",
      "track_name": "CLOSING FRIDAY",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "track_isrc": "JPQ123456789",
      "album_upc": "4000000000000"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# アルバムのリアルタイムランキングを取得する

アルバムのリアルタイムのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/album/real-time

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/album/real-time"

# レスポンス

アルバムランキングオブジェクトの内容が返ります。
詳しくは、「アルバムランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "album_upc": "4000000000000",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# アルバムのデイリーランキングを取得する

アルバムのデイリーのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/album/daily

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/album/daily"

# レスポンス

アルバムランキングオブジェクトの内容が返ります。
詳しくは、「アルバムランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "album_upc": "4000000000000"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# アルバムのウィークリーランキングを取得する

アルバムのウィークリーのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/album/weekly

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/album/weekly"

# レスポンス

アルバムランキングオブジェクトの内容が返ります。
詳しくは、「アルバムランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "album_upc": "4000000000000"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# ビデオトラックのリアルタイムランキングを取得する

ビデオトラックのリアルタイムのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/video-track/real-time

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/video-track/real-time"

# レスポンス

ビデオトラックランキングオブジェクトの内容が返ります。
詳しくは、「ビデオトラックランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "video_track_id": "mv0000000000041b62",
      "video_track_name": "LINE MUSIC PR Movie",
      "artist_id": "mi000000000ed0e9a6",
      "artist_name": "LINE MUSIC CORPORATION",
      "video_album_id": "vb000000000002ad08",
      "video_album_name": "LINE MUSIC PR Movie",
      "video_track_isrc": "JPQ123456789",
      "video_album_upc": "4000223456789"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# ビデオトラックのデイリーランキングを取得する

ビデオトラックのデイリーのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/video-track/daily

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/video-track/daily"

# レスポンス

ビデオトラックランキングオブジェクトの内容が返ります。
詳しくは、「ビデオトラックランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "video_track_id": "mv0000000000041b62",
      "video_track_name": "LINE MUSIC PR Movie",
      "artist_id": "mi000000000ed0e9a6",
      "artist_name": "LINE MUSIC CORPORATION",
      "video_album_id": "vb000000000002ad08",
      "video_album_name": "LINE MUSIC PR Movie",
      "video_track_isrc": "JPQ123456789",
      "video_album_upc": "4000223456789"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# ビデオトラックのウィークリーランキングを取得する

ビデオトラックのウィークリーのランキングを取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/ranking/video-track/weekly

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/ranking/video-track/weekly"

# レスポンス

ビデオトラックランキングオブジェクトの内容が返ります。
詳しくは、「ビデオトラックランキングオブジェクト」を参照してください。

# レスポンス例

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "video_track_id": "mv0000000000041b62",
      "video_track_name": "LINE MUSIC PR Movie",
      "artist_id": "mi000000000ed0e9a6",
      "artist_name": "LINE MUSIC CORPORATION",
      "video_album_id": "vb000000000002ad08",
      "video_album_name": "LINE MUSIC PR Movie",
      "video_track_isrc": "JPQ123456789",
      "video_album_upc": "4000223456789"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# レポート

# 日次レポートの最新日付を取得する

作成された日次レポートの最新の日付を取得します。

# HTTPリクエスト

GET https://api-music.line.me/v1/reports/daily-reports/latest-date

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/reports/daily-reports/latest-date"

# レスポンス

項目名	型	Not Null	説明
latest_date	Date	○	日次レポートが作成された日付

# レスポンス例

{
  "latest_date": "2021-08-01"
}

# 日次レポート情報を取得する

指定した日付のレポート情報を取得します。
日次レポートの詳しくは、「LINE MUSIC Analytics データ連携定義書」を参照してください。

# HTTPリクエスト

GET https://api-music.line.me/v1/reports/daily-reports

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# クエリパラメータ

項目名	型	必須	デフォルト	説明
date	Date	○		対象となるレポートの日付

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/reports/daily-reports?date=2021-08-01"

# レスポンス

項目名	型	Not Null	説明
reports	レポートオブジェクトの配列	○	レポートのリスト詳しくは、「レポートオブジェクト」を参照してください。

# レスポンス例

{
  "reports": [
    {
      "date": "2021-08-01",
      "label_id": "bl0000000000000000",
      "url": "https://lmj-label-report.line-objects.com/20210801/LMA_bl0000000000000000_20210801.zip?AWSAccessKeyId=keyvalue&Expires=1619174343&Signature=testsignature",
      "url_expires": "2021-08-02T12:34:56.000Z"
    }
  ]
}

# 日次レポート更新履歴のリストを取得する

日次レポートが更新された履歴のリストを取得します。
日次レポートが更新された履歴のリストは、日次レポート更新履歴オブジェクトのlast_update_timeプロパティの降順でソートされます。

履歴のリストには下記の履歴が含まれます。

新規に日次レポートが作成された履歴
データの修正があり日次レポートの内容に変更があった履歴

# HTTPリクエスト

GET https://api-music.line.me/v1/reports/report-update-histories

# リクエストヘッダー

項目名	型	必須	説明
Authorization	String	○	アクセストークンを設定してください。詳しくは、「アクセストークン」を参照してください。

# クエリパラメータ

項目名	型	必須	デフォルト	説明
limit	Number		10	1回で取得するデータの件数 1〜100の値を指定してください。
offset	Number		0	取得するデータの開始位置 0から始まります。 0〜100000の値を指定してください。

# リクエスト例

curl \
  -H "Authorization:Bearer ${ACCESS_TOKEN}" \
  "https://api-music.line.me/v1/reports/report-update-histories?offset=10&limit=30"

# レスポンス

項目名	型	Not Null	説明
histories	日次レポート更新履歴オブジェクトの配列	○	詳しくは、「日次レポート更新履歴オブジェクト」を参照してください。リストの最大件数はlimitで指定した件数になります。
limit	Number	○	検索で実行されたデータの件数クエリパラメータの`limit`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。
offset	Number	○	検索で実行されたデータの開始位置クエリパラメータの`offset`と同じ値が設定されます。クエリパラメータで指定しなかった場合は、デフォルトの値が設定されます。

# レスポンス例

{
  "histories": [
    {
      "date": "2021-09-01",
      "last_update_time": "2021-12-16T02:42:55.000Z"
    },
    {
      "date": "2021-12-15",
      "last_update_time": "2021-12-15T21:15:23.000Z"
    }
  ],
  "limit": 30,
  "offset": 0
}

# オブジェクト

この章ではレスポンスで使われているJSONオブジェクトについて記載します。

# アーティストオブジェクト

アーティストの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
id	String	○	アーティストごとに付与された一意のID
name	String	○	アーティスト名
images	画像オブジェクトの配列	○	LINE MUSIC上で表示される画像情報詳しくは、「画像オブジェクト」を参照してください。
description	String		アーティストの説明
additional_name	String		Additional Name
editable_additional_name	String		Editable Additional Name
label_id	String	○	レーベルごとに付与された一意のID
label_name	String		レーベル名
page_url	String	○	LINE MUSICのWebサイト上でのURL
album_counts	登録数オブジェクト	○	アルバムに関する登録数の情報詳しくは、「登録数オブジェクト」を参照してください。
video_album_counts	登録数オブジェクト	○	ビデオアルバムに関する登録数の情報詳しくは、「登録数オブジェクト」を参照してください。
track_counts	登録数オブジェクト	○	トラックに関する登録数の情報詳しくは、「登録数オブジェクト」を参照してください。
video_track_counts	登録数オブジェクト	○	ビデオトラックに関する登録数の情報詳しくは、「登録数オブジェクト」を参照してください。
display_status	String	○	表示ステータス下記のいずれかの値が返ります。 `VISIBLE` : 表示 `HIDDEN` : 非表示 `UNKNOWN` : 不明
main_artist_id	String	○	メインアーティストのID メインアーティストについては「メインアーティストとは」を参照してください。
main_artist_name	String	○	メインアーティストのアーティスト名
main_artist_favorite_count	Number	○	メインアーティストのお気に入り件数
main_artist_search_access_count	Number	○	メインアーティストの検索回数

# サンプル

{
  "id": "mi0000000000000000",
  "name": "LINE MUSIC CORPORATION",
  "images": [
    {
      "width": 160,
      "height": 160,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m160x160"
    },
    {
      "width": 470,
      "height": 470,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m470x470"
    },
    {
      "width": 630,
      "height": 630,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m630x630"
    }
  ],
  "description": "LINEで使われている音や楽曲を提供します。\n普段、LINEの着信などで気になる曲が入っているかもしれません。\n",
  "additional_name": "LINE MUSIC CORPORATION,ラインミュージックコーポレーション",
  "editable_additional_name": "LINE MUSIC CORPORATION,ラインミュージックコーポレーション",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "page_url": "https://music.line.me/launch?target=artist&item=mi0000000000000000&cc=JP&v=1",
  "album_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "video_album_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "track_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "video_track_counts": {
    "total_count": 30,
    "published_count": 20,
    "unpublished_count": 10
  },
  "display_status": "VISIBLE",
  "main_artist_id": "mi0000000000000000",
  "main_artist_name": "LINE MUSIC CORPORATION",
  "main_artist_favorite_count": 12345,
  "main_artist_search_access_count": 12345
}

# アルバムオブジェクト

アルバムの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
id	String	○	アルバムごとに付与された一意のID
name	String	○	アルバム名
images	画像オブジェクトの配列	○	LINE MUSIC上で表示される画像情報詳しくは、「画像オブジェクト」を参照してください。
description	String		アルバムの説明
additional_name	String		Additional Name
editable_additional_name	String		Editable Additional Name
artist_id	String	○	アーティストごとに付与された一意のID
artist_name	String	○	アーティスト名
label_id	String	○	レーベルごとに付与された一意のID
label_name	String		レーベル名
sub_label_name	String		サブレーベル名
page_url	String	○	LINE MUSICのWebサイト上でのURL
disc_count	Number	○	アルバムのディスク枚数
track_count	Number	○	アルバムの収録トラック数
favorite_count	Number	○	お気に入り件数
search_access_count	Number	○	検索回数
genre	String		アルバムのジャンル
release_time	DateTime		パッケージ発売日時
streaming_status	ストリーミングオブジェクト	○	ストリーミングに関する情報詳しくは、「ストリーミングオブジェクト」を参照してください。
purchase_status	ダウンロード販売オブジェクト	○	ダウンロード販売に関する情報詳しくは、「ダウンロード販売オブジェクト」を参照してください。
price	Number	○	販売価格
upc	String		UPC
product_number	String		品番
grid	String		GRID
package_id	String		パッケージID
last_update_time	DateTime	○	変更日時

# サンプル

{
  "id": "mb0000000000000000",
  "name": "CLOSING FRIDAY",
  "images": [
    {
      "width": 160,
      "height": 160,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m160x160"
    },
    {
      "width": 470,
      "height": 470,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m470x470"
    },
    {
      "width": 630,
      "height": 630,
      "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m630x630"
    }
  ],
  "description": "このアルバムはLINEで使われているメロディを収録したものです。\n普段、LINEの着信などで気になる曲が入っているかもしれません。\n",
  "additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "editable_additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": "https://music.line.me/launch?target=album&item=mb0000000000000000&cc=JP&v=1",
  "disc_count": 2,
  "track_count": 12,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "release_time": "2021-04-01T00:00:00.000Z",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "purchase_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "purchase_target": "ALBUM",
    "price_code": "STAP",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "price": 120,
  "upc": "4000000000000",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "package_id": "PKG-00001",
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# ビデオアルバムオブジェクト

ビデオアルバムの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
id	String	○	ビデオアルバムごとに付与された一意のID
name	String	○	ビデオアルバム名
images	画像オブジェクトの配列	○	LINE MUSIC上で表示される画像情報詳しくは、「画像オブジェクト」を参照してください。
description	String		ビデオアルバムの説明
additional_name	String		Additional Name
editable_additional_name	String		Editable Additional Name
artist_id	String	○	アーティストごとに付与された一意のID
artist_name	String	○	アーティスト名
label_id	String	○	レーベルごとに付与された一意のID
label_name	String		レーベル名
sub_label_name	String		サブレーベル名
page_url	String		LINE MUSICのWebサイト上でのURL
disc_count	Number	○	ビデオアルバムのディスク枚数
video_track_count	Number	○	ビデオアルバムの収録ビデオトラック数
favorite_count	Number	○	お気に入り件数
search_access_count	Number	○	検索回数
genre	String		ビデオアルバムのジャンル
release_time	DateTime		パッケージ発売日時
streaming_status	ストリーミングオブジェクト	○	ストリーミングに関する情報詳しくは、「ストリーミングオブジェクト」を参照してください。
upc	String		UPC
product_number	String		品番
grid	String		GRID
package_id	Number		パッケージID
last_update_time	DateTime	○	変更日時

# サンプル

{
  "id": "vb0000000000000000",
  "name": "LINE MUSIC PR Movie",
  "images": [
    {
      "width": 160,
      "height": 90,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m160x90"
    },
    {
      "width": 480,
      "height": 270,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m480x270"
    },
    {
      "width": 640,
      "height": 360,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m640x360"
    }
  ],
  "description": "無料ユーザーも全楽曲を毎月フル再生できるようになりました！  \n是非この機会に登録してみてください。\n",
  "additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "editable_additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": null,
  "disc_count": 2,
  "video_track_count": 12,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "release_time": "2021-04-01T00:00:00.000Z",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "upc": "4000000000000",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "package_id": "PKG-00001",
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# トラックオブジェクト

トラックの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
id	String	○	トラックごとに付与された一意のID
name	String	○	トラック名
additional_name	String		Additional Name
editable_additional_name	String		Editable Additional Name
artist_id	String	○	アーティストごとに付与された一意のID
artist_name	String	○	アーティスト名
album_id	String	○	トラックが含まれるアルバムごとに付与された一意のID
album_name	String	○	トラックが含まれるアルバムの名前
label_id	String	○	レーベルごとに付与された一意のID
label_name	String		レーベル名
sub_label_name	String		サブレーベル名
page_url	String	○	LINE MUSICのWebサイト上でのURL
album_disc_no	Number	○	トラックが含まれるアルバムのディスク番号
album_track_no	Number	○	トラックが含まれるアルバムのトラック番号
play_duration	Number	○	楽曲の尺を秒数で表したもの
play_count	Number	○	総再生回数
favorite_count	Number	○	お気に入り件数
search_access_count	Number	○	検索回数
genre	String		トラックのジャンル
streaming_status	ストリーミングオブジェクト	○	ストリーミングに関する情報詳しくは、「ストリーミングオブジェクト」を参照してください。
purchase_status	ダウンロード販売オブジェクト	○	ダウンロード販売に関する情報詳しくは、「ダウンロード販売オブジェクト」を参照してください。
price	Number		販売価格
isrc	String		ISRC
product_number	String		品番
grid	String		GRID
rights_information	著作者情報オブジェクト		このトラックの著作者に関する情報詳しくは、「著作者情報オブジェクト」を参照してください。
last_update_time	DateTime	○	変更日時

# サンプル

{
  "id": "mt0000000000000000",
  "name": "CLOSING FRIDAY",
  "additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "editable_additional_name": "CLOSING FRIDAY,クロージングフライデー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "album_id": "mb0000000000000000",
  "album_name": "CLOSING FRIDAY",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": "https://music.line.me/launch?target=track&item=mb0000000000000000&subitem=mt0000000000000000&cc=JP&v=1",
  "album_disc_no": 1,
  "album_track_no": 1,
  "play_duration": 195,
  "play_count": 12345,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "purchase_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "purchase_target": "ALBUM",
    "price_code": "STAP",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "price": 120,
  "isrc": "JPQ123456789",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "rights_information": {
    "lyricist": "The lyricist",
    "translator": "The translator",
    "composer": "The composer",
    "arranger": "The arranger",
    "artist": "The artist",
    "ivt_type": "I",
    "lyric_translation_type": 1,
    "il_type": "I",
    "medley_type": "M"
  },
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# ビデオトラックオブジェクト

ビデオトラックの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
id	String	○	ビデオトラックごとに付与された一意のID
name	String	○	ビデオトラック名
images	画像オブジェクトの配列	○	LINE MUSIC上で表示される画像情報詳しくは、「画像オブジェクト」を参照してください。
additional_name	String		Additional Name
editable_additional_name	String		Editable Additional Name
artist_id	String	○	アーティストごとに付与された一意のID
artist_name	String	○	アーティスト名
video_album_id	String	○	ビデオトラックが含まれるビデオアルバムごとに付与された一意のID
video_album_name	String	○	ビデオトラックが含まれるビデオアルバムの名前
label_id	String	○	レーベルごとに付与された一意のID
label_name	String		レーベル名
sub_label_name	String		サブレーベル名
page_url	String		LINE MUSICのWebサイト上でのURL
video_album_disc_no	Number	○	ビデオトラックが含まれるビデオアルバムのディスク番号
video_album_track_no	Number	○	ビデオトラックが含まれるビデオアルバムのビデオトラック番号
play_duration	Number	○	動画の尺を秒数で表したもの
play_count	Number	○	総再生回数
favorite_count	Number	○	お気に入り件数
search_access_count	Number	○	検索回数
genre	String		ビデオトラックのジャンル
streaming_status	ストリーミングオブジェクト	○	ストリーミングに関する情報詳しくは、「ストリーミングオブジェクト」を参照してください。
isrc	String		ISRC
product_number	String		品番
grid	String		GRID
rights_information	著作者情報オブジェクト		このビデオトラックの著作者に関する情報詳しくは、「著作者情報オブジェクト」を参照してください。
last_update_time	DateTime	○	変更日時

# サンプル

{
  "id": "mv0000000000000000",
  "name": "LINE MUSIC PR Movie",
  "images": [
    {
      "width": 160,
      "height": 90,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m160x90"
    },
    {
      "width": 480,
      "height": 270,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m480x270"
    },
    {
      "width": 640,
      "height": 360,
      "url": "https://obs.line-scdn.net/r/musicjp/i/i7658192c8186t0b6c3de7/m640x360"
    }
  ],
  "additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "editable_additional_name": "LINE MUSIC PR Movie,ラインミュージックピーアールムービー",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "video_album_id": "vb0000000000000000",
  "video_album_name": "LINE MUSIC PR Movie",
  "label_id": "bl0000000000000000",
  "label_name": "LINE MUSIC",
  "sub_label_name": "LINE MUSIC CORPORATION",
  "page_url": "https://music.line.me/launch?target=playSingleVideo&item=mv0000000000000000&cc=JP&v=1&lang=ja",
  "video_album_disc_no": 1,
  "video_album_track_no": 1,
  "play_duration": 195,
  "play_count": 12345,
  "favorite_count": 12345,
  "search_access_count": 12345,
  "genre": "邦楽",
  "streaming_status": {
    "deleted": true,
    "publish_status": "NOT_PUBLISHED",
    "publish_start_time": "2021-04-01T00:00:00.000Z",
    "publish_end_time": "2021-04-30T23:59:59.000Z"
  },
  "isrc": "JPQ123456789",
  "product_number": "CODE-00001",
  "grid": "A1-2425G-ABC1234002-M",
  "rights_information": {
    "lyricist": "The lyricist",
    "translator": "The translator",
    "composer": "The composer",
    "arranger": "The arranger",
    "artist": "The artist",
    "ivt_type": "I",
    "lyric_translation_type": 1,
    "il_type": "I",
    "medley_type": "M"
  },
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# 登録数オブジェクト

LINE MUSICに登録されている楽曲や動画などの数を表すオブジェクトです。

項目名	型	Not Null	説明
total_count	Number	○	合計の件数
published_count	Number	○	公開中の件数
unpublished_count	Number	○	非公開の件数

# サンプル

{
  "total_count": 30,
  "published_count": 20,
  "unpublished_count": 10
}

# 画像オブジェクト

画像の情報を保持するオブジェクトです。

項目名	型	Not Null	説明
witdh	Number	○	画像の幅
height	Number	○	画像の高さ
url	String	○	画像のURL

# サンプル

{
  "width": 470,
  "height": 470,
  "url": "https://obs.line-scdn.net/r/musicjp/c/c19cb9976t07f9da53/m470x470"
}

# ストリーミングオブジェクト

ストリーミングの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
deleted	Boolean	○	削除済みフラグ
publish_status	String	○	ストリーミングの公開ステータス詳しくは、「ストリーミングの公開ステータス」を参照してください。
publish_start_time	DateTime		公開開始日時
publish_end_time	DateTime		公開終了日時

# ストリーミングの公開ステータス

ストリーミングの公開ステータスは対象の楽曲がどのような効果状態かを表すステータスです。
このステータスは以下のいずれか値になります。

NOT_PUBLISHED : 公開前
PUBLISH_WITHIN_24H : 24時間以内に公開予定
PUBLISHED :公開中
UNPUBLISHED : 配信停止
UNKNOWN : 不明

# サンプル

{
  "deleted": true,
  "publish_status": "NOT_PUBLISHED",
  "publish_start_time": "2021-04-01T00:00:00.000Z",
  "publish_end_time": "2021-04-30T23:59:59.000Z"
}

# ダウンロード販売オブジェクト

ダウンロード販売の情報を保持するオブジェクトです。

項目名	型	Not Null	説明
deleted	Boolean	○	削除済みフラグ
publish_status	String	○	ダウンロード販売の公開ステータス詳しくは、「ダウンロード販売の公開ステータス」を参照してください。
purchase_target	String	○	ダウンロード販売対象を表すコード詳しくは、「ダウンロード販売の対象コード」を参照してください。
price_code	String		価格コード
publish_start_time	DateTime		公開開始日時
publish_end_time	DateTime		公開終了日時

# ダウンロード販売の公開ステータス

ダウンロード販売の公開ステータスは対象の楽曲がどのような効果状態かを表すステータスです。
このステータスは以下のいずれか値になります。

NOT_PUBLISHED : 公開前
PUBLISH_WITHIN_24H : 24時間以内に公開予定
PUBLISHED :公開中
UNPUBLISHED : 配信停止
UNKNOWN : 不明

# ダウンロード販売の対象コード

ダウンロード販売対象となっているものを表すコードです。
このコードは以下のいずれか値になります。

ALBUM : アルバムのみ
TRACK : トラックのみ
ALBUM_AND_TRACK : アルバム / トラックの両方
NONE : どちらも対象ではない

ビデオアルバムの場合、ALBUMはビデオアルバムをTRACKはビデオトラックを表します。

# サンプル

{
  "deleted": true,
  "publish_status": "NOT_PUBLISHED",
  "purchase_target": "ALBUM",
  "price_code": "STAP",
  "publish_start_time": "2021-04-01T00:00:00.000Z",
  "publish_end_time": "2021-04-30T23:59:59.000Z"
}

# エンベッドオブジェクト

エンベッドの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
url	String	○	HTMLタグに埋め込まれれているURL
iframe_tag	String	○	埋め込み用のHTMLタグ

# サンプル

{
  "url": "https://music.line.me/webapp/embed/track/mt0000000000000000?width=0&height=0&isPC=true&autoPlay=false",
  "iframe_tag": "<iframe id='linemusic' src='https://music.line.me/webapp/embed/track/mt0000000000000000?width=0&height=0&isPC=true&autoPlay=false' width='0' height='0' frameborder='no' scrolling='no' marginwidth='0' marginheight='0' allow='autoplay' allowfullscreen></iframe>"
}

# 著作者情報オブジェクト

楽曲や動画の著作者に関する情報を保持するオブジェクトです。

項目名	型	説明
lyricist	String	作詞者
translator	String	翻訳者
composer	String	作曲者
arranger	String	編曲者
artist	String	アーティスト
ivt_type	String	IVT区分詳しくは、「IVT区分」を参照してください。
lyric_translation_type	Number	歌詞翻訳区分詳しくは、「歌詞翻訳区分」を参照してください。
il_type	String	IL区分詳しくは、「IL区分」を参照してください。
medley_type	String	メドレー区分詳しくは、「メドレー区分」を参照してください。

# IVT区分

著作権に関する区分です。
この区分は以下のいずれか値になります。

I : 曲のみ利用
V : 詩曲ともに利用
T : 詩のみ利用
UNKOWN : 上記以外

# 歌詞翻訳区分

歌詞翻訳に関する区分です。
この区分はIVT区分が V / T のときに設定されます。

1 : 原詞利用
2 : 訳詞利用
3 : 不明

# IL区分

音源の使用に関する区分です。

I : IMPORTED（海外音源使用）
L : LOCAL（国内音源使用）
UNKOWN : 上記以外

# メドレー区分

メドレーに関する区分です。

M : メドレー楽曲
UNKOWN : 上記以外

# サンプル

{
  "lyricist": "The lyricist",
  "translator": "The translator",
  "composer": "The composer",
  "arranger": "The arranger",
  "artist": "The artist",
  "ivt_type": "I",
  "lyric_translation_type": 1,
  "il_type": "I",
  "medley_type": "M"
}

# トラックランキングオブジェクト

トラックのランキング情報を保持するオブジェクトです。

項目名	型	Not Null	説明
from	DateTime	○	ランキングの集計期間のFROM
to	DateTime	○	ランキングの集計期間のTO
items	トラックランキング詳細オブジェクトの配列	○	TOP100に含まれるトラックのリスト詳しくは、「トラックランキング詳細オブジェクト」を参照してください。
last_update_time	DateTime	○	変更日時

# fromとtoについて

集計対象となる期間はfrom<= 集計期間 < toとなります。
LINE MUSIC Analyticsの画面上ではtoの値は1分少なく表示されますが、表示の仕方が異なるだけで集計された結果に差異はありません。

# サンプル

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "track_id": "mt0000000000000000",
      "track_name": "CLOSING FRIDAY",
      "artist_id": "mi0000000000000000",
      "artist_name": "LINE MUSIC CORPORATION",
      "album_id": "mb0000000000000000",
      "album_name": "CLOSING FRIDAY",
      "track_isrc": "JPQ123456789",
      "album_upc": "4000000000000"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# トラックランキング詳細オブジェクト

ランキングにランクインしたトラックの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
rank	Number	○	順位
track_id	String	○	トラックごとに付与された一意のID
track_name	String	○	トラック名
artist_id	String	○	アーティストごとに付与された一意のID
artist_name	String	○	アーティスト名
album_id	String	○	トラックが含まれるアルバムごとに付与された一意のID
album_name	String	○	トラックが含まれるアルバムの名前
track_isrc	String		トラックのISRC
album_upc	String		アルバムのUPC

# サンプル

{
  "rank": 1,
  "track_id": "mt0000000000000000",
  "track_name": "CLOSING FRIDAY",
  "artist_id": "mi0000000000000000",
  "artist_name": "LINE MUSIC CORPORATION",
  "album_id": "mb0000000000000000",
  "album_name": "CLOSING FRIDAY",
  "track_isrc": "JPQ123456789",
  "album_upc": "4000000000000"
}

# アルバムランキングオブジェクト

アルバムのランキング情報を保持するオブジェクトです。

項目名	型	Not Null	説明
from	DateTime	○	ランキングの集計期間のFROM
to	DateTime	○	ランキングの集計期間のTO
items	アルバムランキング詳細オブジェクトの配列	○	TOP100に含まれるアルバムのリスト詳しくは、「アルバムランキング詳細オブジェクト」を参照してください。
last_update_time	DateTime	○	変更日時

# fromとtoについて

# サンプル

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "album_id": "mb000000000160c955",
      "album_name": "CLOSING FRIDAY",
      "album_upc": "4000223456789",
      "artist_id": "mi000000000ed0e9a6",
      "artist_name": "LINE MUSIC CORPORATION"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# アルバムランキング詳細オブジェクト

ランキングにランクインしたアルバムの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
rank	Number	○	順位
album_id	String	○	アルバムごとに付与された一意のID
album_name	String	○	アルバム名
album_upc	String		アルバムのUPC
artist_id	String	○	アーティストごとに付与された一意のID
artist_name	String	○	アーティスト名

# サンプル

{
  "rank": 1,
  "album_id": "mb000000000160c955",
  "album_name": "CLOSING FRIDAY",
  "album_upc": "4000223456789",
  "artist_id": "mi000000000ed0e9a6",
  "artist_name": "LINE MUSIC CORPORATION"
}

# ビデオトラックランキングオブジェクト

ビデオトラックのランキング情報を保持するオブジェクトです。

項目名	型	Not Null	説明
from	DateTime	○	ランキングの集計期間のFROM
to	DateTime	○	ランキングの集計期間のTO
items	ビデオトラックランキング詳細オブジェクトの配列	○	TOP100に含まれるビデオトラックのリスト詳しくは、「ビデオトラックランキング詳細オブジェクト」を参照してください。
last_update_time	DateTime	○	変更日時

# fromとtoについて

# サンプル

{
  "from": "2021-04-01T00:00:00.000Z",
  "to": "2021-04-01T23:59:59.000Z",
  "items": [
    {
      "rank": 1,
      "video_track_id": "mv0000000000041b62",
      "video_track_name": "LINE MUSIC PR Movie",
      "artist_id": "mi000000000ed0e9a6",
      "artist_name": "LINE MUSIC CORPORATION",
      "video_album_id": "vb000000000002ad08",
      "video_album_name": "LINE MUSIC PR Movie",
      "video_track_isrc": "JPQ123456789",
      "video_album_upc": "4000223456789"
    }
  ],
  "last_update_time": "2021-04-01T12:34:56.000Z"
}

# ビデオトラックランキング詳細オブジェクト

ランキングにランクインしたビデオトラックの情報を保持するオブジェクトです。

項目名	型	Not Null	説明
rank	Number	○	順位
video_track_id	String	○	ビデオトラックごとに付与された一意のID
video_track_name	String	○	ビデオトラック名
video_artist_id	String	○	アーティストごとに付与された一意のID
video_artist_name	String	○	アーティスト名
video_album_id	String	○	ビデオトラックが含まれるビデオアルバムごとに付与された一意のID
video_album_name	String	○	ビデオトラックが含まれるビデオアルバムの名前
video_track_isrc	String		ビデオトラックのISRC
video_album_upc	String		ビデオアルバムのUPC

# サンプル

{
  "rank": 1,
  "video_track_id": "mv0000000000041b62",
  "video_track_name": "LINE MUSIC PR Movie",
  "artist_id": "mi000000000ed0e9a6",
  "artist_name": "LINE MUSIC CORPORATION",
  "video_album_id": "vb000000000002ad08",
  "video_album_name": "LINE MUSIC PR Movie",
  "video_track_isrc": "JPQ123456789",
  "video_album_upc": "4000223456789"
}

# レポートオブジェクト

レポートを取得するための情報を保持するオブジェクトです。

項目名	型	Not Null	説明
date	Date	○	集計対象となった日付
label_id	String	○	レーベルごとに付与された一意のID
url	String	○	レポートの実体が置かれているURL
url_expires	DateTime	○	URLの有効期限

# サンプル

{
  "date": "2021-08-01",
  "label_id": "bl0000000000000000",
  "url": "https://lmj-label-report.line-objects.com/20210801/LMA_bl0000000000000000_20210801.zip?AWSAccessKeyId=keyvalue&Expires=1619174343&Signature=testsignature",
  "url_expires": "2021-08-02T12:34:56.000Z"
}

# 日次レポート更新履歴オブジェクト

日次レポートの更新履歴の情報を保持するオブジェクトです。

項目名	型	Not Null	説明
date	Date	○	集計対象となった日付
last_update_time	DateTime	○	変更日時

# サンプル

{
  "date": "2021-09-01",
  "last_update_time": "2021-12-16T02:42:55.000Z"
}

# カタログオブジェクト

カタログを取得するための情報を保持するオブジェクトです。

項目名	型	Not Null	説明
date	Date	○	集計対象となった日付
label_id	String	○	レーベルごとに付与された一意のID
url	String	○	カタログの実体が置かれているURL
url_expires	DateTime	○	URLの有効期限

# サンプル

{
  "date": "2021-08-01",
  "label_id": "bl0000000000000000",
  "url": "https://lmj-label-catalog.line-objects.com/20210801/lm_tracks_bl0000000000000001_20210801.zip?AWSAccessKeyId=keyvalue&Expires=1619174343&Signature=testsignature",
  "url_expires": "2021-08-02T12:34:56.000Z"
}

# LINE MUSIC Analytics APIリファレンス

# 目次

# 共通仕様

# レート制限

# ステータスコード

# アクセストークン

# 日時型のフォーマット

# エラーレスポンス

# エラー詳細オブジェクト

# レスポンス例

# アクセストークン

# アクセストークンを取得する

# HTTPリクエスト

# リクエストヘッダー

# 認証するためのトークン

# リクエストボディ

# リクエスト例

# レスポンス

# レスポンス例

# アーティスト

# アーティストのリストを取得する

# HTTPリクエスト

# リクエストヘッダー

# クエリパラメータ

# リクエスト例

# レスポンス

# レスポンス例

# アーティストの情報を取得する

# HTTPリクエスト

# リクエストヘッダー

# パスパラメータ

# リクエスト例

# レスポンス

# レスポンス例

# メインアーティストとは

# アルバム

# アルバムのリストを取得する

# HTTPリクエスト

# リクエストヘッダー

# クエリパラメータ

# 必須項目について

# リクエスト例

# レスポンス

# レスポンス例

# アルバムの情報を取得する

# HTTPリクエスト

# リクエストヘッダー

# パスパラメータ

# リクエスト例

# レスポンス

# レスポンス例

# アルバムのエンベッド情報を取得する

# HTTPリクエスト

# リクエストヘッダー

# パスパラメータ

# リクエスト例

# レスポンス

# レスポンス例

# ビデオアルバム

# ビデオアルバムのリストを取得する

# HTTPリクエスト

# リクエストヘッダー

# クエリパラメータ

# 必須項目について

# リクエスト例

# レスポンス

# レスポンス例

# ビデオアルバムの情報を取得する

# HTTPリクエスト

# リクエストヘッダー

# パスパラメータ

# リクエスト例

# レスポンス

# レスポンス例

# トラック

# トラックのリストを取得する

# HTTPリクエスト

# リクエストヘッダー

# クエリパラメータ

# 必須項目について