# SoundCloud 单曲详情 API (soundcloud.track)

- Canonical page: [https://everyinfra.com/soundcloud-api/track](https://everyinfra.com/soundcloud-api/track?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "soundcloud", "action": "track", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

SoundCloud 单曲详情按曲目 `url` 读取一首曲目：标题、描述 `text`、流派 `genre`、标签 `tags`、时长、发布时间，以及播放量 `play_count`、点赞数、评论数、转发数、下载数 `download_count`，音乐人的名称、主页、头像、粉丝数和认证状态，还有版权许可 `license`。它回答「这首曲子表现如何、谁做的、许可是什么」，适合评估曲目热度，或者二创前核对许可。

`url` 要传具体的曲目链接。`license` 里有 CC 协议的类型，但它只是核对权利的线索，不是统一的可商用授权。`tags` 在曲目没有标签时是空数组，不是 null；点赞、评论、转发数为 null 表示平台不公开，不等于 0。

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=soundcloud&action=track

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | track 使用具体曲目链接；artist 使用 soundcloud.com/作者 主页，给曲目链接时会截取作者路径；playlist 使用含 /sets/ 的完整歌单 URL。非歌单 URL 会转为歌单搜索，结果不保证是原目标。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。 |
| url | 该记录在原平台上的可访问链接。 |
| title | 标题。平台无标题概念时（如纯文本帖）为 null。 |
| text | 正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。 |
| genre | 流派。 |
| tags | 标签数组。无标签时为空数组，不是 null。 |
| duration_sec | 时长，**单位秒**（注意与别的平台 duration_ms 毫秒不同）。 |
| duration_seconds | 时长，单位秒。非视频/音频内容为 null。 |
| 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）。 |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "soundcloud",
  "action": "track",
  "params": {
    "url": "https://soundcloud.com/beabadoobee/coffee"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "soundcloud",
        "action": "track",
        "params": {
            "url": "https://soundcloud.com/beabadoobee/coffee",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "soundcloud",
  "action": "track",
  "results": {
    "id": 342790792,
    "url": "https://soundcloud.com/beabadoobee/coffee",
    "title": "Coffee",
    "text": "An original song by me!\nProducing and harmonising by pig : soundcloud.com/pigsongs\nWhistling by Tara!\nCover art by guess who?",
    "genre": "Trap",
    "tags": [
      "Green eyes"
    ],
    "duration_sec": 127,
    "artist_name": "beabadoobee",
    "artist_url": "https://soundcloud.com/beabadoobee",
    "artist_avatar_url": "https://i1.sndcdn.com/•••",
    "artist_follower_count": 209186,
    "artist_verified": true,
    "play_count": 5232921,
    "like_count": 104395,
    "comment_count": 1463,
    "repost_count": 2362,
    "download_count": 0,
    "artwork_url": "https://i1.sndcdn.com/artworks-000243010786-l9rsfp-large.jpg",
    "license": "all-rights-reserved",
    "posted_at": "2017-09-17T19:52:03+00:00",
    "platform": "soundcloud"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### `license` 写了 Creative Commons，就能直接商用吗？

不能这样判断。`license` 是曲目的版权许可类型，含 CC 协议，是核对权利的线索，不是统一的可商用或可任意再利用的授权。All Rights Reserved 和不同的 Creative Commons 条件各不相同，具体用途是否允许，要查对应的许可条件。

### 单曲详情和播放列表那一页怎么分工？

单曲详情读一首曲目，有播放量、下载数、评论数、标签、许可和音乐人的粉丝数；播放列表读一个歌单，有曲目数和是否专辑。歌单那一页没有曲目明细，要先拿到曲目链接，再用这一页读单曲。

### 时长字段是什么单位？

`duration_sec` 的单位是秒，要注意别的平台的 duration_ms 是毫秒，跨平台合并数据前先统一单位。`duration_seconds` 同样是秒，非视频或音频内容时为 null。

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=soundcloud
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
