List TikTok profile videos
tiktok_profile_videos_listList videos from a TikTok profile by handle, with pagination, sorting, and optional media hosting for direct delivery URLs.
Instructions
List videos from a TikTok profile by handle. Requires handle. Credits: 1 base; hostMedia=true adds +2 per hosted asset (up to 24 / 49 max). Failed assets are not surcharged.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"handle": "<handle>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "tiktok_profile_videos_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| trim | No | Optional flag for a smaller response with fewer fields. | |
| cursor | No | Pagination cursor returned by a previous response. | |
| handle | Yes | Required. TikTok handle whose videos should be listed. | |
| region | No | Optional ISO 3166-1 country code for the request. | |
| sortBy | No | Optional sort order for the returned TikTok videos. | |
| userId | No | Optional TikTok user id to speed up the request. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| hostMedia | No | When true, hosts source media for 90 days and returns delivery URLs in each video's `hostedMedia`. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| includePinned | No | Whether to include videos pinned to the top of the profile. Default: `true`. Set `false` to leave pinned videos out; pages can then come back shorter or empty, so keep following `hasMore` and `cursor`. Send the same value on every page. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |