万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

Spotify

Spotify API

检索 Spotify 曲目、艺人、专辑、歌单与播客，区分发行物、歌单创建者和节目单集，整理公开元数据及可得的听众、曲目指标，不涉及播放控制。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

7

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Spotify 能力清单

action必填参数可选参数单次条数模式单价返回字段
profileurl——同步$1.39 / 千次id · url · name · type · release_date · label · artists · image_url · track_count · tracks · platform
searchkeywordcontent_type默认 20 · 最多 100同步$1.39 / 千次id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform
artisturl——同步$1.39 / 千次id · url · name · bio · monthly_listener_count · follower_count · world_rank · genres · image_url · header_image_url · album_count · single_count · compilation_count · top_cities · top_tracks · related_artists · platform
trackurl——同步$1.39 / 千次id · url · name · artists · album_name · duration_ms · play_count · track_number · disc_number · is_explicit · release_date · preview_url · image_url · added_at · platform · album_id · album_type · label · content_rating
albumurl——同步$1.39 / 千次id · url · name · album_type · artists · release_date · label · copyright · track_count · image_url · tracks · platform
playlisturl——同步$1.39 / 千次id · url · name · text · owner_name · save_count · follower_count · track_count · image_url · tracks · platform
podcastkeywordcontent_type默认 20 · 最多 100同步$1.39 / 千次id · url · type · name · text · artists · album_name · owner_name · publisher · image_url · duration_ms · play_count · follower_count · monthly_listener_count · track_count · episode_count · release_date · is_explicit · preview_url · rank · platform

Spotify 每个接口分别做什么

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

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

怎么调用 Spotify 主页或对象详情 API？

profile

使用 platform="spotify"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 id、url、name、type、release_date、label 等 11 个字段。

Spotify profile 的参数分别是什么意思？

url必填
artist / track / album / playlist 使用对应的 open.spotify.com 链接，也支持在 url 中传 spotify:类型:ID 或裸 ID；目标种类由 action 决定，不要跨类型混用。旧 profile 仅直接接收完整链接，读取专辑/单曲播放资料，不是用户个人档案。

Spotify 官方将资源 URL、URI、ID 和用户标识区分。这里旧 profile 只接收完整发行记录链接，不因为名称相似就变成官方用户档案接口，也不自动具备其他 action 的 URI 解析能力。官方来源：Spotify：资源 URL、URI 和用户标识不能混用来源核查：

Spotify 特有返回字段与含义（5）
artists
参与艺人列表。
tracks
曲目列表。
track_count
曲目总数。
release_date
发行日期。
label
唱片公司。

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

artist

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

Spotify 将月听众定义为最近 28 天的听众，包含主动与程序推荐来源；月活跃听众只是其中主动收听的子集。本页 monthly_listener_count 不应解释成该子集、播放次数或关注人数。官方来源：Spotify：月听众与月活跃听众的不同口径来源核查：

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

url必填
artist / track / album / playlist 使用对应的 open.spotify.com 链接，也支持在 url 中传 spotify:类型:ID 或裸 ID；目标种类由 action 决定，不要跨类型混用。旧 profile 仅直接接收完整链接，读取专辑/单曲播放资料，不是用户个人档案。
Spotify 特有返回字段与含义（10）
monthly_listener_count
月听众数。这是 Spotify 上衡量艺人热度的核心指标。
album_count
专辑数量。
single_count
单曲数量。
compilation_count
合辑数量。
related_artists
相关艺人推荐。
top_tracks
热门曲目。
genres
音乐流派标签。
header_image_url
主页头图。
world_rank
全球排名。
top_cities
听众最多的城市。

怎么调用 Spotify 单曲详情 API？

track

使用 platform="spotify"、action="track" 调用“单曲详情”能力；返回单个对象，主要包含 id、url、name、artists、album_name、duration_ms 等 19 个字段。

官方曲目文档区分 track 与 album 对象，也单列内容署名、下载和模型使用限制。这里的元数据查询不提供完整音频下载或模型训练许可；官方额外字段及 market 参数也不自动成为 EveryInfra 契约。官方来源：Spotify：曲目、所属专辑与内容使用边界来源核查：

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

url必填
artist / track / album / playlist 使用对应的 open.spotify.com 链接，也支持在 url 中传 spotify:类型:ID 或裸 ID；目标种类由 action 决定，不要跨类型混用。旧 profile 仅直接接收完整链接，读取专辑/单曲播放资料，不是用户个人档案。

Spotify 官方区分资源 URL、URI 与 ID，并说明裸 ID 本身不携带资源类型；EveryInfra 的 url 必须与 track、album 或 playlist action 的资源路径匹配，不能把同一 ID 在不同资源类型间自动转换，也不能据此扩展到其他 Spotify URL。官方来源：Spotify：裸 ID 不携带资源类型来源核查：

Spotify 特有返回字段与含义（12）
artists
参与艺人列表。
release_date
发行日期。
label
唱片公司。
album_name
专辑名称。
duration_ms
时长，单位毫秒（不是秒，除以 1000 才是秒）。
preview_url
30 秒试听片段链接，可能为 null。
play_count
播放次数。
is_explicit
是否含限制级内容。
album_id
专辑 ID。
album_type
专辑类型（album/single/compilation）。
track_number
该曲在专辑中的序号。
content_rating
内容分级。

怎么调用 Spotify 专辑 API？

album

使用 platform="spotify"、action="album" 调用“专辑”能力；返回单个对象，主要包含 id、url、name、album_type、artists、release_date 等 12 个字段。

Spotify album 的参数分别是什么意思？

url必填
artist / track / album / playlist 使用对应的 open.spotify.com 链接，也支持在 url 中传 spotify:类型:ID 或裸 ID；目标种类由 action 决定，不要跨类型混用。旧 profile 仅直接接收完整链接，读取专辑/单曲播放资料，不是用户个人档案。

Spotify 官方区分资源 URL、URI 与 ID，并说明裸 ID 本身不携带资源类型；EveryInfra 的 url 必须与 track、album 或 playlist action 的资源路径匹配，不能把同一 ID 在不同资源类型间自动转换，也不能据此扩展到其他 Spotify URL。官方来源：Spotify：裸 ID 不携带资源类型来源核查：

Spotify 特有返回字段与含义（7）
artists
参与艺人列表。
tracks
曲目列表。
track_count
曲目总数。
release_date
发行日期。
label
唱片公司。
album_type
专辑类型（album/single/compilation）。
copyright
版权信息。

怎么调用 Spotify 播放列表 API？

playlist

使用 platform="spotify"、action="playlist" 调用“播放列表”能力；返回单个对象，主要包含 id、url、name、text、owner_name、save_count 等 11 个字段。

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

url必填
artist / track / album / playlist 使用对应的 open.spotify.com 链接，也支持在 url 中传 spotify:类型:ID 或裸 ID；目标种类由 action 决定，不要跨类型混用。旧 profile 仅直接接收完整链接，读取专辑/单曲播放资料，不是用户个人档案。

Spotify 官方区分资源 URL、URI 与 ID，并说明裸 ID 本身不携带资源类型；EveryInfra 的 url 必须与 track、album 或 playlist action 的资源路径匹配，不能把同一 ID 在不同资源类型间自动转换，也不能据此扩展到其他 Spotify URL。官方来源：Spotify：裸 ID 不携带资源类型来源核查：

Spotify 特有返回字段与含义（4）
tracks
曲目列表。
track_count
曲目总数。
owner_name
歌单创建者（歌单类结果用）。
save_count
收藏次数。

怎么调用 Spotify 播客 API？

podcast

使用 platform="spotify"、action="podcast" 调用“播客”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、type、name、text、artists 等 21 个字段。

Spotify podcast 的参数分别是什么意思？

keyword必填
search 的音乐检索词，类型由 content_type 选择；podcast 默认搜索播客节目，不是单集详情查询。
content_type可选
search 使用 tracks、artists、albums、playlists；podcast 仅使用 podcasts_shows（节目）或 podcast_episodes_individual_episodes（单集）。不可跨 action 混用。

官方使用节目页组织其可用单集，并分别介绍关注节目和保存单集。这里仅解释层级关系，不复制 Spotify 客户端播放、离线下载或订阅付费内容的能力。官方来源：Spotify：播客节目与单集是不同对象来源核查：

查看全部 2 个允许值

podcast_episodes_individual_episodespodcasts_shows

Spotify 特有返回字段与含义（13）
artists
参与艺人列表。
track_count
曲目总数。
release_date
发行日期。
album_name
专辑名称。
duration_ms
时长，单位毫秒（不是秒，除以 1000 才是秒）。
publisher
发行方（播客用）。
episode_count
剧集数量（播客用）。
preview_url
30 秒试听片段链接，可能为 null。
monthly_listener_count
月听众数。这是 Spotify 上衡量艺人热度的核心指标。
play_count
播放次数。
rank
排行榜名次。
is_explicit
是否含限制级内容。
owner_name
歌单创建者（歌单类结果用）。
Spotify profile 调用流程一次 Spotify profile 调用的全过程：向 POST /api/v1/social 发送 platform="spotify"、action="profile"，以及必填参数 url;返回结构化 JSON，含 id、url、name、type、release_date 等字段；返回单个对象，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "spotify"action: "profile"urlEveryInfra$1.39 / 千次2 · 响应 · 对象idurlnametyperelease_date
一次 Spotify profile 调用的全过程：向 POST /api/v1/social 发送 platform="spotify"、action="profile"，以及必填参数 url;返回结构化 JSON，含 id、url、name、type、release_date 等字段；返回单个对象，计费 $1.39 / 千次，失败与空结果不计费。

Spotify 原始字段名

EveryInfra 统一字段名

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

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

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

  • tracks
  • monthly_listener_count
  • preview_url
  • world_rank
  • album_count
  • single_count
  • compilation_count
  • top_cities
  • top_tracks
  • related_artists
  • track_number
  • disc_number
  • added_at
  • album_type
  • copyright
  • save_count

返回字段含义

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

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
type
记录类型，取值随能力而定（如 video / image / text）。
release_date
发行日期。
label
唱片公司。
artists
参与艺人列表。
image_url
图片链接。多图能力可能返回 image_urls 数组。
track_count
曲目总数。
tracks
曲目列表。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
text
正文内容，已去除 HTML 标签。长文可能被截断。
album_name
专辑名称。
owner_name
歌单创建者（歌单类结果用）。
publisher
发行方（播客用）。
duration_ms
时长，单位毫秒（不是秒，除以 1000 才是秒）。
play_count
播放次数。
follower_count
粉丝数。null 表示不公开，不等于 0。
monthly_listener_count
月听众数。这是 Spotify 上衡量艺人热度的核心指标。
episode_count
剧集数量（播客用）。
is_explicit
是否含限制级内容。
preview_url
30 秒试听片段链接，可能为 null。
rank
排行榜名次。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
world_rank
全球排名。
genres
音乐流派标签。
header_image_url
主页头图。
album_count
专辑数量。
single_count
单曲数量。
compilation_count
合辑数量。
top_cities
听众最多的城市。
top_tracks
热门曲目。
related_artists
相关艺人推荐。
track_number
该曲在专辑中的序号。
album_id
专辑 ID。
album_type
专辑类型（album/single/compilation）。
content_rating
内容分级。
copyright
版权信息。
save_count
收藏次数。

当前目录另列出 disc_number · added_at，这些字段尚无逐项释义；请先核对 Spotify 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

替换为实际专辑完整链接；旧 profile 读取发行资料，不是用户个人档案。

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

spotify_profile.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"spotify","action":"profile","params":{"url":"https://open.spotify.com/album/<ALBUM_ID>"}}'

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

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

fields.preview.json
{
  "id": null,
  "url": null,
  "name": null,
  "type": null,
  "release_date": null,
  "label": null,
  "artists": null,
  "image_url": null,
  "track_count": null,
  "tracks": null,
  "platform": null
}

常见用例

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

用旧 profile 接口读取 Spotify 发行记录，不查询用户档案

兼容已有专辑或单曲播放资料接入，先确认 profile 这个名称在本页的实际含义。

查看 profile 的 url 参数 →
  • url 直接填写对应专辑或单曲的完整 open.spotify.com 链接；旧 profile 不做 URI 或裸 ID 归一，也不是 Spotify 用户个人资料接口。返回 name、type、release_date、label 与 artists 描述发行记录。
  • tracks 是实际整理的曲目列表，当前最多保留前 50 条；track_count 是这份列表的长度，不保证发行物总曲目数。播放量和时长属于 tracks 内部曲目，不能因字段表平铺展示就当作顶层值。

按对象类型搜索 Spotify 曲目、艺人、专辑或歌单

用 search 先找正确资源类型，再进入对应详情接口。

查看 search 的 content_type 参数 →
  • keyword 是检索词，content_type 的 tracks、artists、albums、playlists 分别对应曲目、艺人、专辑和歌单。它不是一次同时返回四类对象的数组参数；要找播客请用 podcast，不要把播客类型放入这个 action。
  • 返回 type / id / url 后再核对对象；artists、owner_name、album_name 各自适用于不同结果。play_count、follower_count、monthly_listener_count 并非每种对象都有，缺失不补零，也不互相换算。

区分 Spotify 艺人的月听众、粉丝与曲目播放量

用 artist 观察公开艺人资料，不把统计对象不同的热度指标混成一个数字。

查看 artist 的 url 参数 →
  • url 使用 artist 链接，或在此字段传对应的 spotify:artist:ID / 裸 ID；不能跨类型传 track 或 playlist 标识。monthly_listener_count 对应月听众概念，不是播放次数，也不是月活跃听众或粉丝数。
  • follower_count、world_rank 与 top_cities / top_tracks / related_artists 分别保留。城市听众位于 top_cities 子项，热门曲目也只是返回的子集；排名统计范围和刷新时间未在本接口完整说明，不把它当作保证实时的官方全球排行榜。

按 Spotify 曲目标识关联所属专辑与唱片资料

用 track 读取单曲，并将曲目与发行物分开存储。

查看 track 的 url 参数 →
  • url 填 track 链接、对应 spotify:track:ID 或 ID（不带前缀）；album_id 指向所属专辑，不是当前曲目 ID。album_type、label 与 content_rating 分别保留专辑形态、唱片资料和内容分级信息。
  • 当前生成字段表遗漏了曲目基础字段，本轮没有补造字段声明；接口整理的曲目信息仍需按实际响应核对。内容分级不是版权许可，本页不提供完整音频下载、播放控制或绕过地区限制的功能。

整理 Spotify 专辑发行信息及曲目列表

用 album 保留专辑、参与艺人和收录曲目的关系。

查看 album 的 url 参数 →
  • url 使用 album 链接、对应 URI 或裸专辑 ID，不是歌单链接。album_type 是发行形态，artists 是参与艺人名称列表，release_date 保留返回精度，不为只有年月的值编造具体日期。
  • tracks 当前最多整理前 100 条，track_count 可能来自总量也可能由已取列表计算，不能保证两者代表完整专辑。copyright 是返回的版权文本，不是授权证明；各曲目时长以 duration_ms 毫秒表示，嵌套播放次数不能当成专辑销量。

核对 Spotify 歌单收藏指标与已收录曲目

用 playlist 读取歌单摘要和有限曲目集合，不把它当作专辑或编辑接口。

查看 playlist 的 url 参数 →
  • url 使用 playlist 链接、对应 URI 或裸歌单 ID；owner_name 是返回的歌单创建者信息，不是每首曲目的艺人。save_count 与 follower_count 按实际返回分别记录，不用其中一项自动补齐另一项。
  • tracks 当前最多整理前 100 条；加入歌单时间与歌曲发行时间是不同事件，缺失不编造。track_count 不保证等于本次返回数，这里没有添加、删除、修改顺序、播放歌单或获取私有账号数据的功能。

分别搜索 Spotify 播客节目与单集

用 podcast 查节目线索，先分清 show 与 episode 两级对象。

查看 podcast 的 content_type 参数 →
  • keyword 是检索词；默认 podcasts_shows 查播客节目，podcast_episodes_individual_episodes 表示单集搜索。返回 type / id / url 后核对层级，publisher 是出品方，episode_count 是节目集数，不是单集时长。
  • 目录还有音乐、艺人、歌单和有声书类覆盖值，但这些非默认类别的结果完整性尚未逐项验证，不能据此认定已具备独立有声书详情能力。本接口不提供节目全文、转写、付费单集解锁或完整音频下载。

Spotify API 常见问题

Spotify API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="spotify"、action 和 params。以 profile 为例，必填 url，没有可选参数。替换为实际专辑完整链接；旧 profile 读取发行资料，不是用户个人档案。 Spotify 共 7 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Spotify API 怎么收费？

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

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

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

Spotify API 返回哪些字段？

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

「用旧 profile 接口读取 Spotify 发行记录，不查询用户档案」怎样接入 Spotify API？

兼容已有专辑或单曲播放资料接入，先确认 profile 这个名称在本页的实际含义。 url 直接填写对应专辑或单曲的完整 open.spotify.com 链接；旧 profile 不做 URI 或裸 ID 归一，也不是 Spotify 用户个人资料接口。返回 name、type、release_date、label 与 artists 描述发行记录。 tracks 是实际整理的曲目列表，当前最多保留前 50 条；track_count 是这份列表的长度，不保证发行物总曲目数。播放量和时长属于 tracks 内部曲目，不能因字段表平铺展示就当作顶层值。

「按对象类型搜索 Spotify 曲目、艺人、专辑或歌单」怎样接入 Spotify API？

用 search 先找正确资源类型，再进入对应详情接口。 keyword 是检索词，content_type 的 tracks、artists、albums、playlists 分别对应曲目、艺人、专辑和歌单。它不是一次同时返回四类对象的数组参数；要找播客请用 podcast，不要把播客类型放入这个 action。 返回 type / id / url 后再核对对象；artists、owner_name、album_name 各自适用于不同结果。play_count、follower_count、monthly_listener_count 并非每种对象都有，缺失不补零，也不互相换算。

「区分 Spotify 艺人的月听众、粉丝与曲目播放量」怎样接入 Spotify API？

用 artist 观察公开艺人资料，不把统计对象不同的热度指标混成一个数字。 url 使用 artist 链接，或在此字段传对应的 spotify:artist:ID / 裸 ID；不能跨类型传 track 或 playlist 标识。monthly_listener_count 对应月听众概念，不是播放次数，也不是月活跃听众或粉丝数。 follower_count、world_rank 与 top_cities / top_tracks / related_artists 分别保留。城市听众位于 top_cities 子项，热门曲目也只是返回的子集；排名统计范围和刷新时间未在本接口完整说明，不把它当作保证实时的官方全球排行榜。

「按 Spotify 曲目标识关联所属专辑与唱片资料」怎样接入 Spotify API？

用 track 读取单曲，并将曲目与发行物分开存储。 url 填 track 链接、对应 spotify:track:ID 或 ID（不带前缀）；album_id 指向所属专辑，不是当前曲目 ID。album_type、label 与 content_rating 分别保留专辑形态、唱片资料和内容分级信息。 当前生成字段表遗漏了曲目基础字段，本轮没有补造字段声明；接口整理的曲目信息仍需按实际响应核对。内容分级不是版权许可，本页不提供完整音频下载、播放控制或绕过地区限制的功能。

可以先免费试用 Spotify API 吗？

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

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 Spotify API

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

免费开始