TikTok Fetch User Play List
Fetches a user's playlist. Parameters: - `secUid` (required): The user's secUid. - `cursor` (optional, default `0`): Pagination cursor for the playlist. - `count` (optional, default `30`): Number of items to request per page. Returns the playlist data, which may include video URL lists, together with response and request metadata. Direct video CDN URLs may require `Cookie: tt_chain_token={tt_chain_token}`, using the token returned in the response. If a direct CDN URL returns HTTP 403, use the TikTok play URL in the video's `UrlList` without any Cookie.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed charge of 2.07 credits applies per 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 | 每页数量/Number per page | 30 |
cursor | integer | No | 翻页游标/Page cursor | 0 |
secUid | string | Yes | 用户secUid/User secUid | — |
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_tiktok_fetch_user_play_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"secUid": "xxx"
}
}'No response example available yet.

