Kuaishou Music Chart Ranking
omnial/kuaishou-app-fetch-music-ranking
Given a Kuaishou chart tab id, returns that chart's ranked songs: each track's title, artist, popularity count, duration, license and playback flags, plus the chart's update banner and pagination cursor. Two charts are known -- the hot-songs chart and the recommendation chart.
activeper callv2
Price
Up to $0.00205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.
Data source
Data from Kuaishou.
Use it
Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.
Connect once and your AI can find and run this tool, and any other it needs.
For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/kuaishou-app-fetch-music-ranking" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/kuaishou-app-fetch-music-ranking" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/kuaishou-app-fetch-music-ranking", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/kuaishou-app-fetch-music-ranking", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Oct 27, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"tab_id"
],
"properties": {
"count": {
"type": "integer",
"default": 20,
"description": "How many results to return, 1-50. Defaults to 20."
},
"tab_id": {
"type": "integer",
"description": "Which Kuaishou chart to fetch. 100002 is the hot-songs chart; 100063 is the recommendation chart."
},
"pcursor": {
"type": "string",
"description": "Pagination cursor. Leave blank on the first page; pass the previous response's pcursor value to fetch the next page."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"musics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The track's id."
},
"name": {
"type": "string",
"description": "The song's title."
},
"type": {
"type": "number",
"description": "Track type code."
},
"artist": {
"type": "string",
"description": "The artist's name."
},
"chorus": {
"type": "number",
"description": "Chorus start offset in milliseconds. Absent on tracks without one."
},
"genreId": {
"type": "number",
"description": "Genre id; 0 observed on both charts."
},
"duration": {
"type": "number",
"description": "Track length in seconds."
},
"hotCount": {
"type": "string",
"description": "Popularity as a localized count string, e.g. \"1990.8万\" (roughly 19.9M)."
},
"loudness": {
"type": "number",
"description": "Loudness in dB (LUFS), a negative value."
},
"audioType": {
"type": "number",
"description": "Audio format/type code."
},
"isOffline": {
"type": "boolean",
"description": "Whether the track is currently offline/unavailable."
},
"artistName": {
"type": "string",
"description": "The artist's credited display name. Present on the hot-songs chart, absent on the recommendation chart."
},
"isOriginal": {
"type": "boolean",
"description": "Whether the track is an original piece. Present on some hot-songs tracks, absent on others."
},
"uploadTime": {
"type": "number",
"description": "Publish time as epoch milliseconds. Present on the hot-songs chart only."
},
"musicianUid": {
"type": "number",
"description": "The musician's numeric public account id."
},
"durationInfo": {
"type": "array",
"items": {
"type": "object",
"properties": {
"scene": {
"type": "number"
},
"product": {
"type": "string"
},
"durationShooting": {
"type": "number"
},
"durationPlayTrail": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Per-scene playback duration metadata. One entry per scene; product is a platform label, scene a code, and the two duration fields are measurements in milliseconds."
},
"hasCopyright": {
"type": "boolean",
"description": "Whether the platform holds playback rights to this track."
},
"vocalStartTime": {
"type": "number",
"description": "Vocal start offset in milliseconds; -1 observed when not set."
},
"snippetDuration": {
"type": "number",
"description": "Length of the playable snippet in seconds."
},
"licensedPlayScene": {
"type": "array",
"items": {
"type": "number"
},
"description": "Scene codes this track is licensed for."
},
"copyrightTimeLimit": {
"type": "number",
"description": "Copyright-limited play window in seconds."
}
},
"additionalProperties": true
},
"description": "The ranked songs, in chart order."
},
"result": {
"type": "number",
"description": "A result/status code; typically 1."
},
"pcursor": {
"type": "string",
"description": "Pagination cursor. Pass it back as the input pcursor to fetch the next page."
},
"listTitleMessage": {
"type": "string",
"description": "Human-readable banner text for the chart, e.g. the date the chart was last updated."
}
},
"description": "One music chart page: a chart-level banner, a pagination cursor, and the ranked list of songs. Every per-song field is optional -- some tracks omit some fields (e.g. no chorus offset, no original flag).",
"additionalProperties": true
}