NetEase Cloud MusicプレイリストAPI

Q: トラックに対するリスナーの声を読むには？

トラックのtrack_idを曲IDとしてNetEase Cloud Music Comments機能に渡してください。この機能はsong?id=を含む曲のリンクも受け付けます。コメントは1曲ずつ取得され、曲IDの代わりにプレイリストIDを使うことはできません。

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

NetEase Cloud Musicのプレイリストの曲を、playlist_idまたはリンクから順番どおりに一覧表示します。各曲のアーティスト、アルバム、再生時間、リリース日が含まれます。再生時間の単位はミリ秒です。一覧にある曲がすべての地域で再生できるとは限りません。

NetEase Cloud Music Playlistは、playlist_idで公開プレイリストを1つ読み取り、トラックごとに1件を返します。各件には、曲順、曲名と別名、アーティスト、アルバム、長さ、リリース日時、Explicitフラグ、曲のリンクが含まれ、プレイリストの名前、種類、カバー、トラック数、再生数、保存数、最終更新日時がすべての件に繰り返し入ります。キュレーションされたリストやユーザー作成のリストの中身と、そのリストがどれだけ注目されているかを把握でき、プレイリストへの売り込み、音楽マーケティング、カタログ調査、どの曲がプレイリストに採用されているかの追跡に使えます。

数値のIDか、playlist?id=または/playlist/<ID>を含むプレイリストのリンクを渡してください。duration_msはミリ秒単位なので、1000で割ると秒になります。playlist_play_countはプレイリスト全体の再生数で、個々のトラックの再生数ではありません。track_aliasには、曲にサブタイトルや外国語のタイトルがある場合にそれが入ります。snapshotted_atには各件を読み取った日時が記録されます。

料金は1,000リクエストあたり$0.56（1回あたり$0.000556）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのNetEase Cloud Music プレイリストエンドポイント（netease_music/playlist）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにnetease_music、actionにplaylistを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - playlist_id: playlistアクションで使うNetEase Cloud MusicのプレイリストIDを指定します。数値のプレイリストID、またはplaylist?id=か/playlist/IDを含むURLを受け付けます。このパラメータは曲IDとは別のもので、toplistアクションでは使用されません。
- 任意パラメータ：
  - limit: この呼び出しで返す最大行数で、1〜100の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。（デフォルト：20）
- レコードのリストを返します。各レコードの主なフィールド: rank、track_id、track_name、track_alias、duration_ms、artists、artist_ids、album_id、album_name、album_cover_url、published_at、is_explicit。フィールドは全部で23個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=netease_musicを参照してください。.
- リクエストボディの例：
{
  "platform": "netease_music",
  "action": "playlist",
  "params": {
    "playlist_id": "3778678"
  }
}
- 料金：1,000リクエストあたり$0.56。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`netease_music`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`playlist`	機能の識別子です。値は固定です。
`playlist_id`	body.params	`string`	はい	-	playlistアクションで使うNetEase Cloud MusicのプレイリストIDを指定します。数値のプレイリストID、またはplaylist?id=か/playlist/IDを含むURLを受け付けます。このパラメータは曲IDとは別のもので、toplistアクションでは使用されません。
`limit`	body.params	`integer (1–100)`	いいえ	`20`	この呼び出しで返す最大行数で、1〜100の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "netease_music",
  "action": "playlist",
  "params": {
    "playlist_id": "3778678"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "netease_music",
  "action": "playlist",
  "results": [
    {
      "rank": 1,
      "track_id": 3342319503,
      "track_name": "明知故犯",
      "duration_ms": 166416,
      "artists": "Max李玄",
      "artist_ids": "57539469",
      "album_id": 357748854,
      "album_name": "失温",
      "album_cover_url": "http://p3.music.126.net/H2DFRdwP2y5SuCAn-Tuikw==/109951172568091306.jpg",
      "is_explicit": false,
      "popularity_score": 100,
      "track_url": "https://music.163.com/song?id=3342319503",
      "playlist_id": 3778678,
      "playlist_name": "原创榜",
      "playlist_type": "toplist",
      "playlist_cover_url": "https://p4.music.126.net/0SUEG8yDACfx0Bw2MYFv4Q==/109951170048519512.jpg",
      "playlist_track_count": 200,
      "playlist_play_count": 14152643584,
      "playlist_subscribed_count": 13177436,
      "playlist_updated_at": "2026-09-26T00:30:24.072000+00:00",
      "snapshotted_at": "2026-09-26T09:57:42.809000+00:00",
      "platform": "netease_music"
    },
    {
      "rank": 2,
      "track_id": 1973665667,
      "track_name": "海屿你",
      "track_alias": "求你别离开我",
      "duration_ms": 295940,
      "artists": "马也_Crabbit",
      "artist_ids": "13288861",
      "album_id": 150006421,
      "album_name": "海屿你",
      "album_cover_url": "http://p3.music.126.net/Enhy6dPn4gpyqrKhVEQvgA==/109951170483249998.jpg",
      "published_at": "2022-08-19T16:00:00+00:00",
      "is_explicit": false,
      "popularity_score": 100,
      "track_url": "https://music.163.com/song?id=1973665667",
      "playlist_id": 3778678,
      "playlist_name": "原创榜",
      "playlist_type": "toplist",
      "playlist_cover_url": "https://p4.music.126.net/0SUEG8yDACfx0Bw2MYFv4Q==/109951170048519512.jpg",
      "playlist_track_count": 200,
      "playlist_play_count": 14152643584,
      "playlist_subscribed_count": 13177436,
      "playlist_updated_at": "2026-09-26T00:30:24.072000+00:00",
      "snapshotted_at": "2026-09-26T09:57:42.810000+00:00",
      "platform": "netease_music"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`rank`	プラットフォーム上の意味のまま
`track_id`	プラットフォーム上の意味のまま
`track_name`	プラットフォーム上の意味のまま
`track_alias`	プラットフォーム上の意味のまま
`duration_ms`	プラットフォーム上の意味のまま
`artists`	プラットフォーム上の意味のまま
`artist_ids`	プラットフォーム上の意味のまま
`album_id`	プラットフォーム上の意味のまま
`album_name`	プラットフォーム上の意味のまま
`album_cover_url`	プラットフォーム上の意味のまま
`published_at`	プラットフォーム上の意味のまま
`is_explicit`	プラットフォーム上の意味のまま
`popularity_score`	プラットフォーム上の意味のまま
`track_url`	プラットフォーム上の意味のまま
`playlist_id`	プラットフォーム上の意味のまま
`playlist_name`	プラットフォーム上の意味のまま
`playlist_type`	プラットフォーム上の意味のまま
`playlist_cover_url`	プラットフォーム上の意味のまま
`playlist_track_count`	プラットフォーム上の意味のまま
`playlist_play_count`	プラットフォーム上の意味のまま
`playlist_subscribed_count`	プラットフォーム上の意味のまま
`playlist_updated_at`	プラットフォーム上の意味のまま
`snapshotted_at`	プラットフォーム上の意味のまま
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。

FAQ

`playlist_id`はどこで確認できますか？

ブラウザでプレイリストを開き、そのリンクを確認してください。playlist?id=または/playlist/の後に続く数字がIDです。その数字を渡しても、リンク全体を渡しても構いません。曲IDは渡さないでください。曲とプレイリストは別々に採番されているため、曲IDではリストは見つかりません。

`popularity_score`は再生回数ですか？

いいえ。NetEase独自の0〜100の人気スコアで、リスト内のトラック同士を比較して順位付けするのに役立ちます。リスト自体が集めている注目度を知るには、playlist_play_countと、リストを保存したユーザー数であるplaylist_subscribed_countを参照してください。

トラックに対するリスナーの声を読むには？

トラックのtrack_idを曲IDとしてNetEase Cloud Music Comments機能に渡してください。この機能はsong?id=を含む曲のリンクも受け付けます。コメントは1曲ずつ取得され、曲IDの代わりにプレイリストIDを使うことはできません。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

NetEase Cloud Music：チャートコンテナと内部の楽曲リンク ↗
NetEase Cloud Musicの公式チャートページではチャートと楽曲リストが区別されており、各トラックには個別の`song?id=`リンクが使われています。ここでは、`playlist_id`はプレイリストまたはチャートのコンテナを指定し、`song_id`はトラックを識別します。チャートページがあるからといって、APIが完全またはリアルタイムに対応していることを意味するわけではありません。
確認日：2026-09-04