Kuaishou App Music Ranking
### Purpose Retrieve a page of ranked songs from a music chart. ### Inputs - `tab_id`: Ranking ID. `100002` is the hot-songs chart (default); `100063` is the Pi-plan recommendation chart. - `count`: Number of songs per page. Defaults to `20`; valid range is `1–50`. - `pcursor`: Pagination cursor. Leave empty for the first page; for subsequent pages, provide the `pcursor` returned by the previous response. ### Returns The ranking data, including the song list in `musics[]` and a cursor for continuing pagination when available.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 默认 20,范围 1-50 | 20 |
tab_id | integer | No | 100002=热歌榜(默认),100063=π计划推荐榜 | 100002 |
pcursor | string | No | 首次留空,翻页传上一页响应的 pcursor | "" |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_kuaishou_app_music_ranking' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {}
}'No response example available yet.

