# NetEase Cloud Music Comments API (netease_music.comments)

- Canonical page: [https://everyinfra.com/en/netease-music-api/comments](https://everyinfra.com/en/netease-music-api/comments?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "netease_music", "action": "comments", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 50, max 1000 per call (larger values are capped)
- Mode: sync; add "mode": "async" for slow tasks

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| song_id | not declared | yes | not declared | Specifies the NetEase Cloud Music track ID for the comments action. Accepts either a numeric song ID or a URL containing song?id= or /song/ID. A playlist ID cannot be substituted for a song ID. |
| sort | not declared | no | not declared | Sorts track comments for the comments action. Supported values are hot (default), recommend, and time. Compatibility aliases latest and new map to time sorting. The value newest is unsupported and falls back to hot. Pinned top comments may still appear in results regardless of sort selection. |
| limit | integer (1–1000) | no | 50 | The most rows to return in this call, an integer from 1 to 1000. The default applies when you leave it out, and a call can return fewer rows. Larger values are accepted and capped at the maximum. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| song_id | platform-native meaning |
| song_name | platform-native meaning |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| reply_count | Replies, usually replies to a comment. null means not disclosed. |
| is_hot | platform-native meaning |
| is_reply | platform-native meaning |
| parent_comment_id | platform-native meaning |
| author_name | Author's display name. |
| author_avatar_url | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example 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": "netease_music",
  "action": "comments",
  "params": {
    "song_id": "186016"
  }
}'
```

```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": "netease_music",
        "action": "comments",
        "params": {
            "song_id": "186016",
        },
    },
    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; the list keeps the first 2 of 50. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "netease_music",
  "action": "comments",
  "results": [
    {
      "id": "4956438",
      "song_id": "186016",
      "song_name": "晴天（Sunny Day）",
      "url": "https://music.163.com/song?id=186016",
      "text": "高一听的，那时候遇到了孩儿他妈，然后就这么幸福下来了",
      "like_count": 823154,
      "reply_count": 14,
      "is_hot": true,
      "is_reply": false,
      "author_name": "•••",
      "author_avatar_url": "http://p1.music.126.net/•••",
      "posted_at": "2014-10-17T07:22:54.252000+00:00",
      "platform": "netease_music"
    },
    {
      "id": "5453734",
      "song_id": "186016",
      "song_name": "晴天（Sunny Day）",
      "url": "https://music.163.com/song?id=186016",
      "text": "老子要听一辈子周杰伦！！！",
      "like_count": 400002,
      "reply_count": 2,
      "is_hot": true,
      "is_reply": false,
      "author_name": "•••",
      "author_avatar_url": "http://p1.music.126.net/•••",
      "posted_at": "2014-11-04T09:19:19.779000+00:00",
      "platform": "netease_music"
    }
  ],
  "count": 50,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

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