# NetEase Cloud Music Playlist API (netease_music.playlist)

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

NetEase Cloud Music Playlist reads one public playlist by `playlist_id` and returns a row for each track: its position, name and alias, artists, album, length, release time, explicit flag and song link, with the playlist's name, type, cover, track count, play count, saves and last update repeated on every row. Use it to see what a curated or user-made list contains and how much attention the list gets, for playlist pitching, music marketing, catalog research or tracking which songs win placements.

Pass the numeric ID or a playlist link that contains playlist?id= or /playlist/<ID>. `duration_ms` is in milliseconds, so divide by 1000 for seconds. `playlist_play_count` counts plays of the whole playlist, not of any one track, and `track_alias` holds a subtitle or foreign-language title when the song has one. `snapshotted_at` records when each row was read.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| playlist_id | not declared | yes | not declared | Specifies the NetEase Cloud Music playlist ID for the playlist action. Accepts either a numeric playlist ID or a URL containing playlist?id= or /playlist/ID. This parameter is distinct from song IDs and is not used by the toplist action. |
| limit | integer (1–100) | no | 20 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| rank | platform-native meaning |
| track_id | platform-native meaning |
| track_name | platform-native meaning |
| track_alias | platform-native meaning |
| duration_ms | platform-native meaning |
| artists | platform-native meaning |
| artist_ids | platform-native meaning |
| album_id | platform-native meaning |
| album_name | platform-native meaning |
| album_cover_url | platform-native meaning |
| published_at | platform-native meaning |
| is_explicit | platform-native meaning |
| popularity_score | platform-native meaning |
| track_url | platform-native meaning |
| playlist_id | platform-native meaning |
| playlist_name | platform-native meaning |
| playlist_type | platform-native meaning |
| playlist_cover_url | platform-native meaning |
| playlist_track_count | platform-native meaning |
| playlist_play_count | platform-native meaning |
| playlist_subscribed_count | platform-native meaning |
| playlist_updated_at | platform-native meaning |
| snapshotted_at | platform-native meaning |
| 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": "playlist",
  "params": {
    "playlist_id": "3778678"
  }
}'
```

```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": "playlist",
        "params": {
            "playlist_id": "3778678",
        },
    },
    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 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "netease_music",
  "action": "playlist",
  "results": [
    {
      "rank": 1,
      "track_id": 3342319503,
      "track_name": "明知故犯",
      "duration_ms": 166416,
      "artists": "Max李玄",
      "artist_ids": "57539469",
      "album_id": 357748854,
      "album_name": "失温",
      "album_cover_url": "http://p3.music.126.net/H2DFRdwP2y5SuCAn-Tuikw==/109951172568091306.jpg",
      "is_explicit": false,
      "popularity_score": 100,
      "track_url": "https://music.163.com/song?id=3342319503",
      "playlist_id": 3778678,
      "playlist_name": "原创榜",
      "playlist_type": "toplist",
      "playlist_cover_url": "https://p4.music.126.net/0SUEG8yDACfx0Bw2MYFv4Q==/109951170048519512.jpg",
      "playlist_track_count": 200,
      "playlist_play_count": 14152643584,
      "playlist_subscribed_count": 13177436,
      "playlist_updated_at": "2026-09-26T00:30:24.072000+00:00",
      "snapshotted_at": "2026-09-26T09:57:42.809000+00:00",
      "platform": "netease_music"
    },
    {
      "rank": 2,
      "track_id": 1973665667,
      "track_name": "海屿你",
      "track_alias": "求你别离开我",
      "duration_ms": 295940,
      "artists": "马也_Crabbit",
      "artist_ids": "13288861",
      "album_id": 150006421,
      "album_name": "海屿你",
      "album_cover_url": "http://p3.music.126.net/Enhy6dPn4gpyqrKhVEQvgA==/109951170483249998.jpg",
      "published_at": "2022-08-19T16:00:00+00:00",
      "is_explicit": false,
      "popularity_score": 100,
      "track_url": "https://music.163.com/song?id=1973665667",
      "playlist_id": 3778678,
      "playlist_name": "原创榜",
      "playlist_type": "toplist",
      "playlist_cover_url": "https://p4.music.126.net/0SUEG8yDACfx0Bw2MYFv4Q==/109951170048519512.jpg",
      "playlist_track_count": 200,
      "playlist_play_count": 14152643584,
      "playlist_subscribed_count": 13177436,
      "playlist_updated_at": "2026-09-26T00:30:24.072000+00:00",
      "snapshotted_at": "2026-09-26T09:57:42.810000+00:00",
      "platform": "netease_music"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Where do I find the `playlist_id`?

Open the playlist in a browser and look at its link: the number after playlist?id= or after /playlist/ is the ID. You can pass that number or the whole link. Do not pass a song ID; songs and playlists are numbered separately, and a song ID will not find the list.

### Is `popularity_score` a play count?

No. It is NetEase's own heat score on a scale from 0 to 100, useful for ranking the tracks in a list against each other. For the attention the list itself gets, read `playlist_play_count` and `playlist_subscribed_count`, the number of users who saved it.

### How do I read what listeners say about a track?

Pass the track's `track_id` as the song ID to the NetEase Cloud Music Comments capability, which also accepts a song link containing song?id=. Comments are read one song at a time, and a playlist ID cannot stand in for the song ID there.

## 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
