Spotify API
Spotify 单曲 API
按单曲 URL 或 ID 获取 Spotify 单曲的播放次数、热度、时长和专辑信息。
POST/v1/run/spotify.track
可用率
100.00%
30d · 3 次调用
请求数
3
30d
响应时间
2.2s
中位数 · 30d
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"albumName": "Example title",
"artistName": "Example title",
"durationMs": 13,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"name": "Example title",
"playcount": 12500,
"popularity": 42,
"releaseDate": "2024-01-15T09:30:00Z",
"shareUrl": "https://example.com/page",
"trackNumber": 42,
"uri": "example"
},
"found": true,
"reason": "not_found"
}响应类型定义
interface SpotifyTrackResponse {
data: {
albumName?: string;
artistName?: string;
durationMs: number;
id: string;
image?: string;
name: string;
playcount: number;
popularity: number;
releaseDate?: string;
shareUrl: string;
trackNumber: number;
uri: string;
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/spotify.track
curl -X POST https://api.getanyapi.com/v1/run/spotify.track \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| id | string | Spotify 单曲 ID(可替代 url)。 |
| url | string | "https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT"Spotify 单曲 URL(例如 https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT)。 |
| 响应 | ||
| data | object | |
| data.albumName | string | Name of the album the track appears on. |
| data.artistName | string | Name of the primary artist. |
| data.durationMs | integer | Populated whenever the provider has data for the entity. |
| data.id | string | Populated whenever the provider has data for the entity. |
| data.image | string | URL of the cover art image. |
| data.name | string | Populated whenever the provider has data for the entity. |
| data.playcount | integer | |
| data.popularity | integer | |
| data.releaseDate | string | Album release date as an ISO 8601 string. |
| data.shareUrl | string | Populated whenever the provider has data for the entity. |
| data.trackNumber | integer | Populated whenever the provider has data for the entity. |
| data.uri | string | Populated whenever the provider has data for the entity. |
| found | boolean | |
| reason | "not_found" | Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost. |
| 价格 | ||
| 每次请求价格 | USD | US$0.0012 |
| 价格(/千次请求) | USD | US$1.20 |
常见问题
关于 Spotify 单曲 API
AnyAPI 的 Spotify 单曲 API 只需一次 POST 请求 /v1/run/spotify.track,就以统一格式的 JSON 返回 Spotify 数据。按单曲 URL 或 ID 获取 Spotify 单曲的播放次数、热度、时长和专辑信息。无论哪个数据源提供服务,AnyAPI 都返回同一套统一的 schema。费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Spotify 单曲 API 调用中有 100.0% 成功,响应时间中位数为 2.2 秒,共测量 3 次调用。
费用:每千次请求 US$1.20 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
按单曲 URL 或 ID 获取 Spotify 单曲的播放次数、热度、时长和专辑信息。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 Spotify 单曲 API 调用中有 100.0% 成功,响应时间中位数为 2.2 秒,共测量 3 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。