社交内容 · 数据 API

SoundCloud API

分别搜索 SoundCloud 曲目、账号和歌单，按链接核对曲目信息、上传者资料与集合摘要，保留时长、流派和许可说明，便于整理音频目录。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

SoundCloud 能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
search	keyword	—	默认 20 · 最多 100	同步	$1.39 / 千次	id · url · title · text · genre · tags · duration_sec · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform
search_users	keyword	—	默认 20 · 最多 50	同步	$1.39 / 千次	id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform
search_playlists	keyword	—	默认 20 · 最多 50	同步	$1.39 / 千次	id · title · url · text · genre · track_count · duration_sec · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform
track	url	—	—	同步	$1.39 / 千次	id · url · title · text · genre · tags · duration_sec · artist_name · artist_url · artist_avatar_url · artist_follower_count · artist_verified · play_count · like_count · comment_count · repost_count · download_count · artwork_url · license · posted_at · platform
artist	url	—	—	同步	$1.39 / 千次	id · username · name · url · bio · avatar_url · city · country · follower_count · following_count · track_count · playlist_count · like_count · is_verified · is_pro · created_at · platform
playlist	url	keyword, query	—	同步	$1.39 / 千次	id · title · url · text · genre · track_count · duration_sec · like_count · repost_count · is_album · artwork_url · artist_name · artist_url · artist_verified · posted_at · platform

SoundCloud 每个接口分别做什么

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

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

怎么调用 SoundCloud 关键词搜索 API？

search

使用 platform="soundcloud"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、text、genre、tags 等 21 个字段。

SoundCloud search 的参数分别是什么意思？

keyword必填: search 查曲目，search_users 查作者，search_playlists 查歌单；三者虽同用关键词，返回对象不同。playlist 仅在未识别到 /sets/ 歌单 URL 时把此字段作为搜索词，不等于精确歌单详情。
官方搜索说明区分单条音频、账号和歌单；账号还可能属于乐队或听众。EveryInfra 以不同 action 查询这些对象，不因为网页具备日期、时长或个性化筛选，就声明本接口也支持这些选项。官方来源：SoundCloud：Tracks、People 与 Playlists 是不同检索对象来源核查：2026-09-04

SoundCloud 特有返回字段与含义（11）

artist_name: 音乐人名称。
artist_url: 音乐人主页。
artist_avatar_url: 音乐人头像。
artist_follower_count: 音乐人粉丝数。
artist_verified: 音乐人是否认证。
artwork_url: 封面图。
genre: 流派。
duration_sec: 时长，单位秒（注意与别的平台 duration_ms 毫秒不同）。
play_count: 播放量。
download_count: 下载数。
license: 版权许可类型（含 CC 协议，做二创前必看）。

怎么调用 SoundCloud 用户搜索 API？

search_users

使用 platform="soundcloud"、action="search_users" 调用“用户搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、username、name、url、bio、avatar_url 等 17 个字段。

SoundCloud search_users 的参数分别是什么意思？

keyword必填: search 查曲目，search_users 查作者，search_playlists 查歌单；三者虽同用关键词，返回对象不同。playlist 仅在未识别到 /sets/ 歌单 URL 时把此字段作为搜索词，不等于精确歌单详情。
官方搜索说明区分单条音频、账号和歌单；账号还可能属于乐队或听众。EveryInfra 以不同 action 查询这些对象，不因为网页具备日期、时长或个性化筛选，就声明本接口也支持这些选项。官方来源：SoundCloud：Tracks、People 与 Playlists 是不同检索对象来源核查：2026-09-04

SoundCloud 特有返回字段与含义（3）

track_count: 曲目数。
playlist_count: 歌单数。
is_pro: 是否为 Pro 付费账号。

怎么调用 SoundCloud 播放列表搜索 API？

search_playlists

使用 platform="soundcloud"、action="search_playlists" 调用“播放列表搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、title、url、text、genre、track_count 等 16 个字段。

官方说明歌单是可包含自己或他人曲目的集合，并可设置为专辑等形态。因此集合创建者不一定是每首曲目的作者；本接口返回集合摘要，不复制官方编辑歌单的功能。官方来源：SoundCloud：歌单、专辑与曲目归属来源核查：2026-09-04

SoundCloud search_playlists 的参数分别是什么意思？

keyword必填: search 查曲目，search_users 查作者，search_playlists 查歌单；三者虽同用关键词，返回对象不同。playlist 仅在未识别到 /sets/ 歌单 URL 时把此字段作为搜索词，不等于精确歌单详情。

SoundCloud 特有返回字段与含义（8）

artist_name: 音乐人名称。
artist_url: 音乐人主页。
artist_verified: 音乐人是否认证。
artwork_url: 封面图。
genre: 流派。
duration_sec: 时长，单位秒（注意与别的平台 duration_ms 毫秒不同）。
track_count: 曲目数。
is_album: 是否为专辑。

怎么调用 SoundCloud 单曲详情 API？

track

使用 platform="soundcloud"、action="track" 调用“单曲详情”能力；返回单个对象，主要包含 id、url、title、text、genre、tags 等 21 个字段。

SoundCloud track 的参数分别是什么意思？

url必填: track 使用具体曲目链接；artist 使用 soundcloud.com/作者主页，给曲目链接时会截取作者路径；playlist 使用含 /sets/ 的完整歌单 URL。非歌单 URL 会转为歌单搜索，结果不保证是原目标。

SoundCloud 特有返回字段与含义（11）

artist_name: 音乐人名称。
artist_url: 音乐人主页。
artist_avatar_url: 音乐人头像。
artist_follower_count: 音乐人粉丝数。
artist_verified: 音乐人是否认证。
artwork_url: 封面图。
genre: 流派。
duration_sec: 时长，单位秒（注意与别的平台 duration_ms 毫秒不同）。
play_count: 播放量。
download_count: 下载数。
license: 版权许可类型（含 CC 协议，做二创前必看）。

怎么调用 SoundCloud 艺人或创作者资料 API？

artist

使用 platform="soundcloud"、action="artist" 调用“艺人或创作者资料”能力；返回单个对象，主要包含 id、username、name、url、bio、avatar_url 等 17 个字段。

SoundCloud 的 Profiles/People 分类包含音乐人、乐队、创作者及听众。这里的 artist 是本网关的查询名称，不把任意主页都认证为专业艺人。官方来源：SoundCloud：主页可能属于音乐人、乐队或听众来源核查：2026-09-04

SoundCloud artist 的参数分别是什么意思？

url必填: track 使用具体曲目链接；artist 使用 soundcloud.com/作者主页，给曲目链接时会截取作者路径；playlist 使用含 /sets/ 的完整歌单 URL。非歌单 URL 会转为歌单搜索，结果不保证是原目标。

SoundCloud 特有返回字段与含义（3）

track_count: 曲目数。
playlist_count: 歌单数。
is_pro: 是否为 Pro 付费账号。

怎么调用 SoundCloud 播放列表 API？

playlist

使用 platform="soundcloud"、action="playlist" 调用“播放列表”能力；返回单个对象，主要包含 id、title、url、text、genre、track_count 等 16 个字段。

官方把歌单描述为一组曲目，并介绍如何调整专辑或歌单形态。这里只引用对象关系；本接口未返回 tracks 明细，官方歌单容量也不是本接口的输出数量保证。官方来源：SoundCloud：集合信息与曲目明细不是一回事来源核查：2026-09-04

SoundCloud playlist 的参数分别是什么意思？

url必填: track 使用具体曲目链接；artist 使用 soundcloud.com/作者主页，给曲目链接时会截取作者路径；playlist 使用含 /sets/ 的完整歌单 URL。非歌单 URL 会转为歌单搜索，结果不保证是原目标。
keyword可选: search 查曲目，search_users 查作者，search_playlists 查歌单；三者虽同用关键词，返回对象不同。playlist 仅在未识别到 /sets/ 歌单 URL 时把此字段作为搜索词，不等于精确歌单详情。
query可选: playlist 回落搜索的关键词兼容输入，低于 keyword；不改变 url 的公开必填要求。

SoundCloud 特有返回字段与含义（8）

artist_name: 音乐人名称。
artist_url: 音乐人主页。
artist_verified: 音乐人是否认证。
artwork_url: 封面图。
genre: 流派。
duration_sec: 时长，单位秒（注意与别的平台 duration_ms 毫秒不同）。
track_count: 曲目数。
is_album: 是否为专辑。

一次 SoundCloud search 调用的全过程：向 POST /api/v1/social 发送 platform="soundcloud"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、text、genre 等字段；返回列表，单次最多 100 条，计费 $1.39 / 千次，失败与空结果不计费。

SoundCloud 原始字段名

EveryInfra 统一字段名

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

SoundCloud 的独有字段名（当前目录）

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

genre
artist_name
artist_url
artist_avatar_url
artist_follower_count
artist_verified
download_count
artwork_url
license
playlist_count
is_album

返回字段含义

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

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
genre: 流派。
tags: 标签数组。无标签时为空数组，不是 null。
duration_sec: 时长，单位秒（注意与别的平台 duration_ms 毫秒不同）。
artist_name: 音乐人名称。
artist_url: 音乐人主页。
artist_avatar_url: 音乐人头像。
artist_follower_count: 音乐人粉丝数。
artist_verified: 音乐人是否认证。
play_count: 播放量。
like_count: 点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count: 评论数。null 表示不公开，不等于 0。
repost_count: 转发数（区别于引用转发）。null 表示不公开。
download_count: 下载数。
artwork_url: 封面图。
license: 版权许可类型（含 CC 协议，做二创前必看）。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
username: 用户名（@handle）。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
bio: 个人简介，账号自己填写的文本。可能含换行和 emoji。
avatar_url: 头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
city: 城市名，用原平台的语言书写，未做中英归一。
country: 国家或地区。可能是全称也可能是 ISO 代码，取决于平台，未归一。
follower_count: 粉丝数。null 表示不公开，不等于 0。
following_count: 关注数。null 表示不公开，不等于 0。
track_count: 曲目数。
playlist_count: 歌单数。
is_verified: 是否为平台认证账号（蓝V等）。null 表示无法判定。
is_pro: 是否为 Pro 付费账号。
created_at: 创建时间，格式同 posted_at。
is_album: 是否为专辑。

请求填写示例

这里按音频主题检索；歌单、用户资料需传各自目标。

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

soundcloud_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"soundcloud","action":"search","params":{"keyword":"ambient piano"}}'

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

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

fields.preview.json

{
  "id": null,
  "url": null,
  "title": null,
  "text": null,
  "genre": null,
  "tags": null,
  "duration_sec": null,
  "artist_name": null,
  "artist_url": null,
  "artist_avatar_url": null,
  "artist_follower_count": null,
  "artist_verified": null,
  "play_count": null,
  "like_count": null,
  "comment_count": null,
  "repost_count": null,
  "download_count": null,
  "artwork_url": null,
  "license": null,
  "posted_at": null,
  "platform": null
}

常见用例

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

按曲目关键词发现 SoundCloud 音频条目

用 search 查具体音频上传记录，音乐人和歌单分别走其他搜索入口。

查看 search 的 keyword 参数 →

keyword 可以是曲名、音乐人名或主题词，但此 action 返回曲目，不是用户或歌单对象。id / url 定位曲目，artist_name / artist_url 关联上传者，genre / tags 保留流派和标签线索。
duration_sec 的单位是秒，不是 Spotify 的毫秒。play_count、like_count、repost_count 与 download_count 分别是播放、点赞、转发和下载计数，不是独立听众数；本接口不提供音频文件或评论正文。

在 SoundCloud 搜索音乐人、乐队或听众主页

用 search_users 找账号候选，不把名称相近的账号直接认定为同一音乐人。

查看 search_users 的 keyword 参数 →

keyword 是账号检索词，不是精确用户 ID；返回 id、username、name 与 url 后，再核对 bio、city、country 和主页。SoundCloud 主页也可能属于听众，搜索命中不等于专业艺人认证。
track_count 与 playlist_count 是曲目数和歌单数，不是作品列表；follower_count 不提供粉丝名单。is_verified 与 is_pro 是不同标记，不能用付费账号标记推断认证身份或当前套餐名称。

按主题查找 SoundCloud 歌单和专辑集合

用 search_playlists 找合集，不把歌单标题误当成单曲标题。

查看 search_playlists 的 keyword 参数 →

keyword 搜歌单主题或标题；id / title / url 对应集合，artist_name / artist_url 对应关联账号。歌单可收录自己或他人的曲目，集合创建者不一定是所有曲目的作者。
is_album 是返回的专辑标记，track_count 是收录数量，duration_sec 是集合时长。本响应没有 tracks 曲目明细数组，也没有创建、改序或加歌操作。

核对一首 SoundCloud 曲目的许可与互动资料

用 track 读取曲目元数据，区分许可说明、下载次数和下载授权。

查看 track 的 url 参数 →

url 填具体 soundcloud.com/作者/曲目链接，而不是作者主页或含 /sets/ 的歌单地址。返回 title、text、artwork_url 与 duration_sec，后者以秒表示音频时长。

从 SoundCloud 作者路径取得主页资料

用 artist 查询账号，不把曲目详情与作者档案混在一起。

查看 artist 的 url 参数 →

url 优先填写 soundcloud.com/作者主页；若填常规曲目链接，此 action 会截取首段作者路径，不会返回该曲目。非标准短链接不保证能解析，取得 url / username 后应核对目标。
bio、city、country、follower_count 和 track_count 描述账号；这里没有作者全部曲目、粉丝身份或听众画像。is_verified 与 is_pro 分别记录验证和历史付费标记，不用来替代版权或商业合作资质核验。

用 /sets/ 链接精确核对 SoundCloud 歌单

用 playlist 读取一个集合的摘要，避免把搜索候选当成原目标。

查看 playlist 的 url 参数 →

url 应包含 /sets/；不符合该路径时，请求会改按 keyword、query 或输入文字查找歌单，并只整理首个结果，不保证是原来的集合。请核对返回 id / title / url；当前公开必填项仍是 url。
track_count、duration_sec、is_album 与 artwork_url 是集合资料，不含每首曲目的列表或音频文件。歌单中出现某首曲目，也不表示歌单作者拥有该曲的全部权利。

SoundCloud API 常见问题

SoundCloud API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="soundcloud"、action 和 params。以 search 为例，必填 keyword，没有可选参数。这里按音频主题检索；歌单、用户资料需传各自目标。 SoundCloud 共 6 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

SoundCloud API 怎么收费？

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

SoundCloud API 一次能返回多少条数据？

SoundCloud 有 3 个列表接口，包括 search、search_users、search_playlists。其余 3 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

SoundCloud API 返回哪些字段？

当前目录为 search 列出 id、url、title、text、genre、tags 等 21 个字段名。按全站当前目录统计，11 个字段名只在 SoundCloud 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按曲目关键词发现 SoundCloud 音频条目」怎样接入 SoundCloud API？

用 search 查具体音频上传记录，音乐人和歌单分别走其他搜索入口。 keyword 可以是曲名、音乐人名或主题词，但此 action 返回曲目，不是用户或歌单对象。id / url 定位曲目，artist_name / artist_url 关联上传者，genre / tags 保留流派和标签线索。 duration_sec 的单位是秒，不是 Spotify 的毫秒。play_count、like_count、repost_count 与 download_count 分别是播放、点赞、转发和下载计数，不是独立听众数；本接口不提供音频文件或评论正文。

「在 SoundCloud 搜索音乐人、乐队或听众主页」怎样接入 SoundCloud API？

用 search_users 找账号候选，不把名称相近的账号直接认定为同一音乐人。 keyword 是账号检索词，不是精确用户 ID；返回 id、username、name 与 url 后，再核对 bio、city、country 和主页。SoundCloud 主页也可能属于听众，搜索命中不等于专业艺人认证。 track_count 与 playlist_count 是曲目数和歌单数，不是作品列表；follower_count 不提供粉丝名单。is_verified 与 is_pro 是不同标记，不能用付费账号标记推断认证身份或当前套餐名称。

「按主题查找 SoundCloud 歌单和专辑集合」怎样接入 SoundCloud API？

用 search_playlists 找合集，不把歌单标题误当成单曲标题。 keyword 搜歌单主题或标题；id / title / url 对应集合，artist_name / artist_url 对应关联账号。歌单可收录自己或他人的曲目，集合创建者不一定是所有曲目的作者。 is_album 是返回的专辑标记，track_count 是收录数量，duration_sec 是集合时长。本响应没有 tracks 曲目明细数组，也没有创建、改序或加歌操作。

「核对一首 SoundCloud 曲目的许可与互动资料」怎样接入 SoundCloud API？

用 track 读取曲目元数据，区分许可说明、下载次数和下载授权。 url 填具体 soundcloud.com/作者/曲目链接，而不是作者主页或含 /sets/ 的歌单地址。返回 title、text、artwork_url 与 duration_sec，后者以秒表示音频时长。 license 保留返回的许可类型；All Rights Reserved 与各类 Creative Commons 条件不同，仍须核对原曲页面及实际授权。download_count 只是次数，不是可下载文件地址，更不自动授予二创、商用或模型训练权。

可以先免费试用 SoundCloud API 吗？

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

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

开始调用 SoundCloud API

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

免费开始