试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"data": {
"items": [
{
"albumName": "Example title",
"artistName": "Example title",
"durationMs": 13,
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"name": "Example title",
"playCount": 12500,
"previewUrl": "https://example.com/page",
"releaseDate": "2024-01-15T09:30:00Z",
"trackNumber": 42,
"type": "general",
"url": "https://example.com/page"
}
]
},
"found": true,
"reason": "not_found"
}响应类型定义
interface SpotifyPlayCountResponse {
data: {
items: {
albumName?: string;
artistName?: string;
durationMs?: number;
id: string;
image?: string;
name: string;
playCount: number;
previewUrl?: string;
releaseDate?: string;
trackNumber?: number;
type?: string;
url: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/spotify.play_count
curl -X POST https://api.getanyapi.com/v1/run/spotify.play_count \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| url | string | "https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT"要获取播放次数的 Spotify 单曲、专辑或艺人 URL（例如 https://open.spotify.com/track/3n3Ppam7vgaVa1iaRUc9Lp）。 |
| 响应 | ||
| data | object | |
| data.items | object[] | Play-count records for the requested Spotify entity (one per track). Populated whenever the provider has data for the entity. |
| data.items[].albumName | string | Name of the album the track belongs to. Empty when the upstream omits it. |
| data.items[].artistName | string | Name of the primary artist. Empty when the upstream omits it. |
| data.items[].durationMs | integer | Track duration in milliseconds. |
| data.items[].id | string | The Spotify entity ID. Populated whenever the provider has data for the entity. |
| data.items[].image | string | URL of the cover art image. |
| data.items[].name | string | The track (or entity) name. Populated whenever the provider has data for the entity. |
| data.items[].playCount | integer | Total number of streams/plays for the track. Populated whenever the provider has data for the entity. |
| data.items[].previewUrl | string | URL of the 30-second audio preview. |
| data.items[].releaseDate | string | Release date as an ISO 8601 string. |
| data.items[].trackNumber | integer | Position of the track within its album. |
| data.items[].type | string | The Spotify entity type (e.g. "track"). |
| data.items[].url | string | Canonical open.spotify.com URL for the entity, with tracking query params stripped. Populated whenever the provider has data for the entity. |
| found | boolean | Whether the track/album/artist was found and returned play-count records. |
| 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.0033 |
| 价格（/千次请求） | USD | US$3.30 |
常见问题
关于 Spotify 播放次数 API
AnyAPI 的 Spotify 播放次数 API 只需一次 POST 请求 /v1/run/spotify.play_count，就以统一格式的 JSON 返回 Spotify 数据。获取 Spotify 单曲、专辑或艺人 URL 的播放次数和统计数据。无论哪个数据源提供服务，AnyAPI 都返回同一套统一的 schema。费用：每千次请求 US$3.30 起，以美元计价，无需订阅，也没有每月最低消费。
费用：每千次请求 US$3.30 起，以美元计价，无需订阅，也没有每月最低消费。你只需为一个美元钱包充值，每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用，我们按成本原价转嫁，不加价；错误响应会显示收取的金额。
获取 Spotify 单曲、专辑或艺人 URL 的播放次数和统计数据。响应是统一格式的 JSON，外层结构与每个 AnyAPI 接口相同，所以解析另一个接口只需换一个 URL，别的都不用改。