Spotify Recommendations
收藏RapidAPI2026-04-21 更新2026-04-21 收录
下载链接：
https://rapidapi.com/luisasalaazzarmx/api/spotify-recommendations
下载链接
链接失效反馈官方服务：
资源简介：
High quality recommendations from Spotify. Supports ISRC and Spotify IDs
创建时间：
2026-04-21
原始信息汇总
Spotify Recommendations API 数据集概述
基本信息
- API名称: Spotify Recommendations
- 类别: Music
- 提供者: Luisa Salazar
- 当前版本: v1
- 订阅者数量: 3
- 评分: 9.4 Popularity
- 服务等级: 100% Service Level
- 延迟: 337ms Latency
- 测试通过率: 100% Test
订阅计划
- BASIC: $0.00 / mo
- PRO: $10.00 / mo
- ULTRA: $30.00 / mo
- MEGA: $200.00 / mo
API 概述
提供来自 Spotify 的高质量音乐推荐。支持 ISRC 和 Spotify ID。
主要功能
- 双ID支持: 可传递包含 Spotify ID、ISRC 或两者混合的数组。
- 可定制输出: 控制返回的推荐曲目数量。
- 快速可靠: 针对快速响应时间进行优化，适用于实时应用程序。
端点
生成推荐
- 方法: POST
- 路径:
/recommendations - 描述: 根据提供的种子标识符获取推荐曲目列表。
请求头
| Key | Value | Required |
|---|---|---|
Content-Type |
application/json |
Yes |
Accept |
*/* |
No |
User-Agent |
your-app-name |
No |
请求体模式
请求体必须为包含以下参数的 JSON 对象：
| 字段 | 类型 | 描述 | 必需 | 示例 |
|---|---|---|---|---|
seedTrackIds |
Array of Strings |
用于生成推荐的基础种子曲目列表。可以是 Spotify ID 和 ISRC 的混合。 | Yes | ["QM4TW2244096", "2ZVSjes0VFYg9uJu4olsi4"] |
limit |
Integer |
目标返回的推荐曲目数量。 | No | 5 |
代码示例
cURL
bash curl -X POST https://1a01.birthday.wtf/recommendations --header User-Agent: yaak --header Accept: / --header Content-Type: application/json --data { "seedTrackIds": ["QM4TW2244096", "2ZVSjes0VFYg9uJu4olsi4"], "limit": 5 }
响应示例
成功请求将返回状态码 200 OK 及包含推荐曲目的 JSON 对象。
json
{
"success": true,
"limit": 5,
"recommendations": [
{
"id": "3n3Ppam7vgaVa1iaRUc9Lp",
"isrc": "USUM71700870",
"name": "Mr. Brightside",
"artists": [
{
"id": "0C0XlULifJtAxgZETuP21Z",
"name": "The Killers"
}
],
"album": "Hot Fuss",
"external_urls": {
"spotify": "https://open.spotify.com/track/3n3Ppam7vgaVa1iaRUc9Lp"
}
}
]
}
错误处理
| 状态码 | 原因 | 故障排除 |
|---|---|---|
| 400 Bad Request | 无效负载或缺少必需参数。 | 确保 seedTrackIds 格式为字符串数组。 |
| 404 Not Found | 一个或多个种子 ID 无法解析。 | 检查 ISRC 和 Spotify ID 的拼写。 |
| 500 Server Error | 内部服务器错误。 | 请稍后重试请求。 |
