Platform availability
- 24h health
- Normal
Last 30 days
Available capabilities
Each NetEase Cloud Music action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Music chartstoplist | Get the tracks on NetEase Cloud Music charts, each with rank, artists, album, duration and heat score, plus the chart's name, play count and last update. | $0.56 per 1,000 requests | Normal |
Playlistplaylist | List the tracks of a NetEase Cloud Music playlist in order, from its playlist_id or link, with artists, album, duration and release date for each. | $0.56 per 1,000 requests | Normal |
Commentscomments | Read the comments on a NetEase Cloud Music song from its song_id or song link, with likes, reply counts, hot flags and the parent comment for each reply. | $0.56 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each NetEase Cloud Music action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
toplistMusic charts Get the tracks on NetEase Cloud Music charts, each with rank, artists, album, duration and heat score, plus the chart's name, play count and last update. | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | rank · track_id · track_name · track_alias · duration_ms · artists · artist_ids · album_id · album_name · album_cover_url · published_at · is_explicit · popularity_score · track_url · playlist_id · playlist_name · playlist_type · playlist_cover_url · playlist_track_count · playlist_play_count · playlist_subscribed_count · playlist_updated_at · snapshotted_at · platform | |
playlistPlaylist List the tracks of a NetEase Cloud Music playlist in order, from its | playlist_id | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $0.56 per 1,000 requests | rank · track_id · track_name · track_alias · duration_ms · artists · artist_ids · album_id · album_name · album_cover_url · published_at · is_explicit · popularity_score · track_url · playlist_id · playlist_name · playlist_type · playlist_cover_url · playlist_track_count · playlist_play_count · playlist_subscribed_count · playlist_updated_at · snapshotted_at · platform |
commentsComments Read the comments on a NetEase Cloud Music song from its | song_id | sort | Sync delivery | — | $0.56 per 1,000 requests | id · song_id · song_name · url · text · like_count · reply_count · is_hot · is_reply · parent_comment_id · author_name · author_avatar_url · posted_at · platform |
What do the NetEase Cloud Music toplist parameters mean?
Get the tracks on NetEase Cloud Music charts, each with rank, artists, album, duration and heat score, plus the chart's name, play count and last update. popularity_score runs from 0 to 100 and is not a play count, and rank reflects that snapshot only.
This action has no business parameters. Send only the platform and action identifiers.
What do the NetEase Cloud Music playlist parameters mean?
List the tracks of a NetEase Cloud Music playlist in order, from its playlist_id or link, with artists, album, duration and release date for each. Duration is in milliseconds, and a listed track is not guaranteed to be playable in every region.
playlist_idRequired- 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.NetEase Cloud Music: Chart Containers and Internal Song Links — The official NetEase Cloud Music chart page separates charts from song lists, with each track using its own `song?id=` link. Here, `playlist_id` targets a playlist or chart container, while `song_id` identifies a track; the chart page does not imply complete or real-time API coverage. · Checked
What do the NetEase Cloud Music comments parameters mean?
Read the comments on a NetEase Cloud Music song from its song_id or song link, with likes, reply counts, hot flags and the parent comment for each reply. Sorting accepts hot (the default), recommend or time, and pinned comments can appear under any order.
song_idRequired- 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.NetEase Cloud Music: Comment Queries Should Target Songs, Not Charts — Official chart song lists link to their respective song pages, which serves to verify that songs and charts are distinct objects. This source does not explain comment sorting or reply scope, which remains governed by the verified contract above. · Checked
sortOptional- 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.
How to use the NetEase Cloud Music API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"netease_music","action":"toplist","params":{}}'
NetEase Cloud Music API questions
What can I retrieve with the NetEase Cloud Music API?
Set platform to netease_music. The current catalog lists music charts, playlist, and comments. These action names identify different NetEase Cloud Music objects or views; they are not interchangeable search modes.
Which input starts a NetEase Cloud Music `toplist` request?
The toplist action has no required business input. Send the platform and action identifiers, plus only the optional parameters you need.
Which fields can NetEase Cloud Music `toplist` return?
Its declared schema includes rank, track_id, track_name, and track_alias. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every NetEase Cloud Music action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.