网易云音乐 API

读取网易云音乐榜单和指定歌单的曲目次序、歌手与专辑信息，再按歌曲 ID 整理乐评和点赞数；歌单统计与单曲热度分开记录。

请求发到 POST https://api.everyinfra.com/api/v1/social，platform 填 netease_music，action 填下方列表里的能力名，例如 toplist。

3 个能力
$0.56 / 千次
失败和空结果都不收费

免费开始文档

平台运行状态

24h 健康值: 正常

30 天趋势

网易云音乐能力清单

能力	做什么	24 小时运行状态 · 全部正常
榜单`toplist`	用 toplist 观察榜单内容，避免把多个榜单混成一张统一排名。	正常
播放列表`playlist`	用 playlist 读取一个指定歌单的条目，不把歌单统计误归到单曲。	正常
评论`comments`	用 comments 查询歌曲讨论，不拿歌单 ID 当歌曲 ID。	正常

网易云音乐每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

所有能力都是同步调用。

能力	必填参数	可选参数	单次条数	返回字段
toplist	—	—	默认 20 · 最多 100	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
playlist	playlist_id	—	默认 20 · 最多 100	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
comments	song_id	sort	默认 50 · 最多 1000	id · song_id · song_name · url · text · like_count · reply_count · is_hot · is_reply · parent_comment_id · author_name · author_avatar_url · posted_at · platform

怎么调用网易云音乐榜单 API？

toplist

使用 platform="netease_music"、action="toplist" 调用“榜单”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 rank、track_id、track_name、track_alias、duration_ms、artists 等 24 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

网易云音乐官方榜单页将榜单容器与其中的歌曲条目分开呈现。该来源只证明榜单和歌曲对象存在，不证明 EveryInfra 返回全榜、实时更新、固定排序算法或所有地区均可访问。官方来源：网易云音乐：官方榜单与歌曲列表来源核查：2026-09-05

这个能力没有业务参数，只传 platform 与 action。

网易云音乐返回字段与含义（23）

track_id: 曲目 ID。
track_name: 曲目名。
track_alias: 曲目别名（副标题/外文名）。
track_url: 曲目链接。
album_id: 专辑 ID。
album_name: 专辑名。
album_cover_url: 专辑封面。
artists: 艺人列表。
artist_ids: 艺人 ID 列表。
duration_ms: 时长，单位毫秒（除以 1000 才是秒）。
published_at: 发行时间。
popularity_score: 网易云热度分，0–100 分制，不是播放量。
rank: 榜单名次。
is_explicit: 是否含限制级内容。
playlist_id: 歌单 ID。
playlist_name: 歌单名。
playlist_cover_url: 歌单封面。
playlist_type: 歌单类型。
playlist_track_count: 歌单曲目数。
playlist_play_count: 歌单播放量。
playlist_subscribed_count: 歌单收藏数。
playlist_updated_at: 歌单最近更新时间。
snapshotted_at: 该条数据的抓取时刻。榜单类数据变化快，用它判断新鲜度。

怎么调用网易云音乐播放列表 API？

playlist

使用 platform="netease_music"、action="playlist" 调用“播放列表”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 rank、track_id、track_name、track_alias、duration_ms、artists 等 24 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

网易云音乐 playlist 的参数分别是什么意思？

playlist_id必填: playlist 的网易云歌单数字 ID，也可传含 playlist?id= 或 /playlist/ID 的歌单链接；不是歌曲 ID。toplist 获取官方榜单，不需要此字段。
网易云官方榜单页将榜单与歌曲列表分开，每首歌有自己的 song?id= 链接。这里 playlist_id 定位歌单或榜单容器，track_id 定位歌曲；榜单页展示不等于本接口保证全榜、全量或实时覆盖。官方来源：网易云音乐：榜单容器与其中的歌曲链接来源核查：2026-09-04

网易云音乐返回字段与含义（23）

track_id: 曲目 ID。
track_name: 曲目名。
track_alias: 曲目别名（副标题/外文名）。
track_url: 曲目链接。
album_id: 专辑 ID。
album_name: 专辑名。
album_cover_url: 专辑封面。
artists: 艺人列表。
artist_ids: 艺人 ID 列表。
duration_ms: 时长，单位毫秒（除以 1000 才是秒）。
published_at: 发行时间。
popularity_score: 网易云热度分，0–100 分制，不是播放量。
rank: 榜单名次。
is_explicit: 是否含限制级内容。
playlist_id: 歌单 ID。
playlist_name: 歌单名。
playlist_cover_url: 歌单封面。
playlist_type: 歌单类型。
playlist_track_count: 歌单曲目数。
playlist_play_count: 歌单播放量。
playlist_subscribed_count: 歌单收藏数。
playlist_updated_at: 歌单最近更新时间。
snapshotted_at: 该条数据的抓取时刻。榜单类数据变化快，用它判断新鲜度。

怎么调用网易云音乐评论 API？

comments

使用 platform="netease_music"、action="comments" 调用“评论”能力；返回列表，默认 50 条、单次最多 1000 条，主要包含 id、song_id、song_name、url、text、like_count 等 14 个字段。

查看完整接口文档：参数、代码示例、响应样例与健康状态

网易云音乐 comments 的参数分别是什么意思？

song_id必填: comments 的歌曲数字 ID，也可传含 song?id= 或 /song/ID 的歌曲链接；歌单 ID 不能代替歌曲 ID。
官方榜单歌曲列表链接到各自的歌曲页面，这用于核对歌曲与榜单是不同对象。该来源不说明 EveryInfra 评论排序或回复范围，后者以上方说明为准。官方来源：网易云音乐：评论查询应定位歌曲，而不是榜单来源核查：2026-09-04
sort可选: 歌曲评论排序：hot 按热度（默认），recommend 按推荐，time 按时间；latest / new 是时间排序的兼容写法。不识别 newest，未知值按 hot 处理；热门置顶评论仍可能出现在结果中。

网易云音乐返回字段与含义（6）

song_id: 歌曲 ID。
song_name: 歌曲名。
is_hot: 是否为热门内容。
author_avatar_url: 评论作者头像。
is_reply: 该评论是否为回复。
parent_comment_id: 被回复的评论 ID，用于重建楼中楼。

一次网易云音乐 toplist 调用的全过程：向 POST /api/v1/social 发送 platform="netease_music"、action="toplist";返回结构化 JSON，含 rank、track_id、track_name、track_alias、duration_ms 等字段；返回列表，单次最多 100 条，计费 $0.56 / 千次，失败与空结果不计费。

网易云音乐原始字段名

EveryInfra 统一字段名

左边是网易云音乐数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

网易云音乐的独有字段名（当前目录）

全站 106 个平台的当前目录中，这 17 个字段名只在网易云音乐出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

track_id
track_name
track_alias
artist_ids
album_cover_url
popularity_score
track_url
playlist_name
playlist_type
playlist_cover_url
playlist_track_count
playlist_play_count
playlist_subscribed_count
playlist_updated_at
snapshotted_at
song_id
song_name

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

rank: 榜单名次。
track_id: 曲目 ID。
track_name: 曲目名。
track_alias: 曲目别名（副标题/外文名）。
duration_ms: 时长，单位毫秒（除以 1000 才是秒）。
artists: 艺人列表。
artist_ids: 艺人 ID 列表。
album_id: 专辑 ID。
album_name: 专辑名。
album_cover_url: 专辑封面。
published_at: 发行时间。
is_explicit: 是否含限制级内容。
popularity_score: 网易云热度分，0–100 分制，不是播放量。
track_url: 曲目链接。
playlist_id: 歌单 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）。
id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
song_id: 歌曲 ID。
song_name: 歌曲名。
url: 该记录在原平台上的可访问链接。
text: 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
like_count: 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
reply_count: 回复数，通常用于评论的子回复。null 表示不公开。
is_hot: 是否为热门内容。
is_reply: 该评论是否为回复。
parent_comment_id: 被回复的评论 ID，用于重建楼中楼。
author_name: 作者昵称（显示名）。
author_avatar_url: 评论作者头像。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。

请求填写示例

toplist 获取官方榜单，不需要歌单 ID 或歌曲 ID；它们属于其他接口。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

netease_music_toplist.sh

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

记录字段预览（非真实响应）

仅展示 toplist 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "rank": null,
  "track_id": null,
  "track_name": null,
  "track_alias": null,
  "duration_ms": null,
  "artists": null,
  "artist_ids": null,
  "album_id": null,
  "album_name": null,
  "album_cover_url": null,
  "published_at": null,
  "is_explicit": null,
  "popularity_score": null,
  "track_url": null,
  "playlist_id": null,
  "playlist_name": null,
  "playlist_type": null,
  "playlist_cover_url": null,
  "playlist_track_count": null,
  "playlist_play_count": null,
  "playlist_subscribed_count": null,
  "playlist_updated_at": null,
  "snapshotted_at": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

整理网易云音乐榜单曲目，并保留榜单归属与快照时间

用 toplist 观察榜单内容，避免把多个榜单混成一张统一排名。

查看 toplist 接口说明

toplist 不需要 playlist_id 或关键词；每条记录用 playlist_id / playlist_name 区分所属榜单，rank 应放在该榜单范围内理解。track_id / track_name 对应歌曲，album_id 对应专辑，三种 ID 不互换。
snapshotted_at 是该条数据的快照时刻，playlist_updated_at 是歌单更新信息，published_at 是歌曲发行时间。popularity_score 是热度分，不是播放次数；playlist_play_count 属于歌单，不能当作该首歌曲播放量。

用网易云歌单 ID 获取曲目次序与专辑信息

用 playlist 读取一个指定歌单的条目，不把歌单统计误归到单曲。

查看 playlist 的 playlist_id 参数

playlist_id 填歌单数字 ID，或包含 playlist?id= / playlist/ID 的歌单链接；不能填 song?id= 的歌曲地址。返回 track_id 可用于后续歌曲评论查询，playlist_id 则继续表示容器。
duration_ms 是毫秒；artists 当前保留歌手名称文本，可能以 / 连接，不保证是数组。rank 在普通歌单里是条目次序，不自动代表全站热度排名；playlist_track_count 也不保证等于本次返回长度。

读取网易云歌曲乐评，区分热评、时间排序和回复数量

用 comments 查询歌曲讨论，不拿歌单 ID 当歌曲 ID。

查看 comments 的 song_id 参数

song_id 填歌曲数字 ID，或含 song?id= / song/ID 的歌曲链接；sort 默认 hot，recommend 为推荐，time 为时间，latest / new 是时间排序兼容值。newest 当前不识别并会回落 hot，热门评论仍可能混入时间序列。
id 是评论 ID，song_id 是歌曲 ID；like_count / reply_count 分别是点赞与回复数。当前不展开回复，is_reply / parent_comment_id 如有返回只记录现有关系，不保证拿到完整楼中楼；text 可能受长度限制，不能当成完整评论归档。

网易云音乐 API 常见问题

网易云音乐 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="netease_music"、action 和 params。以 toplist 为例，必填无参数，没有可选参数。toplist 获取官方榜单，不需要歌单 ID 或歌曲 ID；它们属于其他接口。网易云音乐共 3 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

网易云音乐 API 怎么收费？

$0.56 / 千次，网易云音乐全部 3 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次网易云音乐调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

网易云音乐 API 一次能返回多少条数据？

网易云音乐有 3 个列表接口，包括 toplist、playlist、comments。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

网易云音乐 API 返回哪些字段？

当前目录为 toplist 列出 rank、track_id、track_name、track_alias、duration_ms、artists 等 24 个字段名。按全站当前目录统计，17 个字段名只在网易云音乐出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「整理网易云音乐榜单曲目，并保留榜单归属与快照时间」怎样接入网易云音乐 API？

用 toplist 观察榜单内容，避免把多个榜单混成一张统一排名。 toplist 不需要 playlist_id 或关键词；每条记录用 playlist_id / playlist_name 区分所属榜单，rank 应放在该榜单范围内理解。track_id / track_name 对应歌曲，album_id 对应专辑，三种 ID 不互换。 snapshotted_at 是该条数据的快照时刻，playlist_updated_at 是歌单更新信息，published_at 是歌曲发行时间。popularity_score 是热度分，不是播放次数；playlist_play_count 属于歌单，不能当作该首歌曲播放量。

「用网易云歌单 ID 获取曲目次序与专辑信息」怎样接入网易云音乐 API？

用 playlist 读取一个指定歌单的条目，不把歌单统计误归到单曲。 playlist_id 填歌单数字 ID，或包含 playlist?id= / playlist/ID 的歌单链接；不能填 song?id= 的歌曲地址。返回 track_id 可用于后续歌曲评论查询，playlist_id 则继续表示容器。 duration_ms 是毫秒；artists 当前保留歌手名称文本，可能以 / 连接，不保证是数组。rank 在普通歌单里是条目次序，不自动代表全站热度排名；playlist_track_count 也不保证等于本次返回长度。

「读取网易云歌曲乐评，区分热评、时间排序和回复数量」怎样接入网易云音乐 API？

用 comments 查询歌曲讨论，不拿歌单 ID 当歌曲 ID。 song_id 填歌曲数字 ID，或含 song?id= / song/ID 的歌曲链接；sort 默认 hot，recommend 为推荐，time 为时间，latest / new 是时间排序兼容值。newest 当前不识别并会回落 hot，热门评论仍可能混入时间序列。 id 是评论 ID，song_id 是歌曲 ID；like_count / reply_count 分别是点赞与回复数。当前不展开回复，is_reply / parent_comment_id 如有返回只记录现有关系，不保证拿到完整楼中楼；text 可能受长度限制，不能当成完整评论归档。

可以先免费试用网易云音乐 API 吗？

可以。注册免费，在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，就能在控制台「余额与充值」领取 $1 额度（≈720 次数据调用），直接进赠送余额，不用输码，24 小⁠时内有效。请先选择网易云音乐的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

Behance API B站 API Bluesky API Dailymotion API DeviantArt API Discord API 豆瓣 API 抖音 API 全部 106 平台 ↗

开始调用网易云音乐 API

在 GitHub 给两个仓库点星领 $1 额度，注册后在控制台领取，24 小⁠时内有效，先选一个网易云音乐接口验证结果。

免费开始

网易云音乐 API

平台运行状态

网易云音乐 能力清单

网易云音乐 每个接口分别做什么

怎么调用 网易云音乐 榜单 API？

怎么调用 网易云音乐 播放列表 API？

网易云音乐 playlist 的参数分别是什么意思？

怎么调用 网易云音乐 评论 API？

网易云音乐 comments 的参数分别是什么意思？

网易云音乐 的独有字段名（当前目录）

返回字段含义

请求填写示例

记录字段预览（非真实响应）

常见用例

整理网易云音乐榜单曲目，并保留榜单归属与快照时间

用网易云歌单 ID 获取曲目次序与专辑信息

读取网易云歌曲乐评，区分热评、时间排序和回复数量

网易云音乐 API 常见问题

网易云音乐 API 怎么调用？

网易云音乐 API 怎么收费？

网易云音乐 API 一次能返回多少条数据？

网易云音乐 API 返回哪些字段？

「整理网易云音乐榜单曲目，并保留榜单归属与快照时间」怎样接入 网易云音乐 API？

「用网易云歌单 ID 获取曲目次序与专辑信息」怎样接入 网易云音乐 API？

「读取网易云歌曲乐评，区分热评、时间排序和回复数量」怎样接入 网易云音乐 API？

可以先免费试用 网易云音乐 API 吗？

更多社交内容 API

开始调用 网易云音乐 API

网易云音乐能力清单

网易云音乐每个接口分别做什么

怎么调用网易云音乐榜单 API？

怎么调用网易云音乐播放列表 API？

怎么调用网易云音乐评论 API？

网易云音乐的独有字段名（当前目录）

「整理网易云音乐榜单曲目，并保留榜单归属与快照时间」怎样接入网易云音乐 API？

「用网易云歌单 ID 获取曲目次序与专辑信息」怎样接入网易云音乐 API？

「读取网易云歌曲乐评，区分热评、时间排序和回复数量」怎样接入网易云音乐 API？

可以先免费试用网易云音乐 API 吗？

开始调用网易云音乐 API