get_tiktok_videos
A creator's TikTok videos, latest or most popular first, with their numbers. ₹0.28 per page; a result that finds nothing is ₹0.
What it does
The videos of one TikTok account from its handle, newest first or most popular first (sort_by): data with each video's description, likes, comments, shares, plays, the music used, the date and a link, plus a max_cursor for the next page.
Use it to see what a creator or a brand posts and which videos took off; get_tiktok_video for one video in full, get_tiktok_comments for the reactions, get_tiktok_transcript for what was said. Flat price per page; an unknown account, or one with no videos, is free. Two to six seconds.
India: TikTok is blocked in India; set region to the market the account posts from.
Inputs
Generated from the contract captured from staging on 2026-11-05.
| Field | Type | Required | Description |
|---|---|---|---|
handle | string | yes | The TikTok handle, without the @. |
region | string | no | Two-letter region for the request. Default GB; try US if a profile answers no videos. |
sort_by | string | no | latest (default) or popular. |
user_id | string | no | The numeric user id, for faster answers. |
max_cursor | string | no | The cursor from the previous answer, for the next page. |
What drives the cost
Flat per page; pass max_cursor for the next page. Answers are trimmed to the useful fields. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.
Price today
| Price today | ₹0.28 per page (cost_paise: 28) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.42 (hold_paise: 42); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "get_tiktok_videos" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_tiktok_videos" |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |
Request
curl https://api.parel.si/v1/run \
-H "Authorization: Bearer $PAREL_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"get_tiktok_videos","input":{"handle":"stoolpresidente","sort_by":"popular"}}'
What comes back
data, as the live check of 2026-11-05 recorded it, trimmed:
{
"aweme_list": [
{
"aweme_id": "7132585624095198507",
"desc": "I knew he looked familiar",
"create_time_utc": "2022-08-16T21:15:04.000Z",
"region": "US",
"url": "https://www.tiktok.com/@a_public_figure/video/7132585624095198507",
"is_ad": false,
"author": {
"unique_id": "a_user_24",
"nickname": "A User 23",
"follower_count": 4789774,
"verification_type": 1
},
"statistics": {
"play_count": 22343829,
"digg_count": 3596576,
"comment_count": 16933,
"share_count": 169080,
"collect_count": 229454
},
"video": {
"duration": 40029
}
},
{
"aweme_id": "7461685861529455918",
"desc": "In honor of Tik Tok coming back, one of the most famous pizza reviews of all time",
"create_time_utc": "2025-01-19T17:52:17.000Z",
"region": "US",
"url": "https://www.tiktok.com/@a_public_figure/video/7461685861529455918",
"is_ad": false,
"author": {
"unique_id": "a_user_24",
"nickname": "A User 23",
"follower_count": 4789774,
"verification_type": 1
},
"statistics": {
"play_count": 29711353,
"digg_count": 3282331,
"comment_count": 8277,
"share_count": 349851,
"collect_count": 202131
},
"video": {
"duration": 31553
}
},
{
"aweme_id": "7288502507196681514",
"desc": "Did I get thrown off my game when she asked for that type of slice? Yes",
"create_time_utc": "2023-10-11T01:12:19.000Z",
"region": "US",
"url": "https://www.tiktok.com/@a_public_figure/video/7288502507196681514",
"is_ad": false,
"author": {
"unique_id": "a_user_24",
"nickname": "A User 23",
"follower_count": 4789774,
"verification_type": 1
},
"statistics": {
"play_count": 19310749,
"digg_count": 2446926,
"comment_count": 7993,
"share_count": 214323,
"collect_count": 101453
},
"video": {
"duration": 73494
}
}
],
"has_more": 1,
"max_cursor": 10
}
Notes
- Flat per page; pass max_cursor for the next page. Answers are trimmed to the useful fields.
- sort_by popular for the creator's best videos.
- If a profile that should have videos answers none, set region US.
Siblings
This page as Markdown: /docs/tools/get_tiktok_videos.md. Something wrong or missing: hello@parel.si.