社交内容 · 数据 API

网易云音乐 API

Q: 网易云音乐 API 怎么收费？

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

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

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

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

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 网易云音乐 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

读取网易云音乐榜单和指定歌单的曲目次序、歌手与专辑信息，再按歌曲 ID 整理乐评和点赞数；歌单统计与单曲热度分开记录。调用 POST /api/v1/social ；返回结构化 JSON，$0.56 / 千次；失败不计费。

免费开始看文档

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

网易云音乐能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
toplist	—	—	默认 20 · 最多 100	同步	$0.56 / 千次	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	同步	$0.56 / 千次	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	—	同步	$0.56 / 千次	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

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

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

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

怎么调用网易云音乐榜单 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" 调用“评论”能力；返回列表，主要包含 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 统一字段名

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

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

全站 89 个平台的当前目录中，这 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 omg_你的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 通 89 个平台。

网易云音乐 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 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择网易云音乐的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 3 个能力。无需信用卡。

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

开始调用网易云音乐 API

加微信领 $1 免费额度，先选一个网易云音乐接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始

网易云音乐 API

网易云音乐 能力清单

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

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

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