# NetEase Cloud Music Music charts API (netease_music.toplist)

- Canonical page: [https://everyinfra.com/en/netease-music-api/toplist](https://everyinfra.com/en/netease-music-api/toplist?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "netease_music", "action": "toplist", "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 charts reads NetEase's official charts and needs no parameters. Each row is one track on a chart: its `rank`, title and alternate title, performing artists, album and cover, duration, release date, explicit marker and NetEase heat score, together with the chart's name, ID, cover, play count, saves and last update. Use it to follow which songs lead on NetEase Cloud Music, for chart reports, music marketing, A&R scouting or spotting songs on the rise.

Charts move quickly, so keep `snapshotted_at`, the moment each row was read, with every copy you store, and compare runs by it. `playlist_name` names the chart a row belongs to and `rank` is the position on that chart. `popularity_score` is NetEase's heat score from 0 to 100, not a count of plays, and `duration_ms` is in milliseconds.

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| 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": "toplist",
  "params": {}
}'
```

```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": "toplist",
        "params": {},
    },
    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": "toplist",
  "results": [
    {
      "rank": 1,
      "track_id": 3425638996,
      "track_name": "互删 (我走以后)",
      "duration_ms": 211686,
      "artists": "江辰",
      "artist_ids": "12641765",
      "album_id": 394443308,
      "album_name": "互删 (我走以后)",
      "album_cover_url": "http://p3.music.126.net/nfDVr6WopOJax11vq5brPQ==/109951173820334666.jpg",
      "published_at": "2026-08-28T16:00:00+00:00",
      "is_explicit": false,
      "popularity_score": 100,
      "track_url": "https://music.163.com/song?id=3425638996",
      "playlist_id": 3779629,
      "playlist_name": "飙升榜",
      "playlist_type": "toplist",
      "playlist_cover_url": "https://p4.music.126.net/5guhqPBTcIrrhLBotgaT6w==/109951170048511751.jpg",
      "playlist_track_count": 100,
      "playlist_play_count": 3218496768,
      "playlist_subscribed_count": 2805127,
      "playlist_updated_at": "2026-09-26T04:32:03.946000+00:00",
      "snapshotted_at": "2026-09-26T09:57:26.623000+00:00",
      "platform": "netease_music"
    },
    {
      "rank": 2,
      "track_id": 3433437362,
      "track_name": "两难pt.2",
      "duration_ms": 259956,
      "artists": "加木",
      "artist_ids": "49320722",
      "album_id": 397217802,
      "album_name": "两难pt.2",
      "album_cover_url": "http://p3.music.126.net/jr4V-LHARj4EGtLeDCLB_Q==/109951173909480514.jpg",
      "is_explicit": false,
      "popularity_score": 100,
      "track_url": "https://music.163.com/song?id=3433437362",
      "playlist_id": 3779629,
      "playlist_name": "飙升榜",
      "playlist_type": "toplist",
      "playlist_cover_url": "https://p4.music.126.net/5guhqPBTcIrrhLBotgaT6w==/109951170048511751.jpg",
      "playlist_track_count": 100,
      "playlist_play_count": 3218496768,
      "playlist_subscribed_count": 2805127,
      "playlist_updated_at": "2026-09-26T04:32:03.946000+00:00",
      "snapshotted_at": "2026-09-26T09:57:26.625000+00:00",
      "platform": "netease_music"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Can I choose which chart to read?

The capability takes no parameters and returns the official charts as NetEase publishes them; `playlist_name` and `playlist_id` on each row tell you which chart you are looking at. To read a different public list, pass its numeric ID to the NetEase Cloud Music Playlist capability.

### How fresh is the chart data?

Each row carries two times: `snapshotted_at`, when the row was read, and `playlist_updated_at`, when NetEase last updated the chart. Quote `playlist_updated_at` as the chart's date, and keep `snapshotted_at` to show when you took your copy.

### How do I measure a song's movement up or down the chart?

Read the chart on a schedule and store `rank` per `track_id` together with `snapshotted_at`. The change in rank between two runs is the movement; a `track_id` that appears for the first time is a new entry, and one that disappears has dropped off.

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