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.

FieldTypeRequiredDescription
handlestringyesThe TikTok handle, without the @.
regionstringnoTwo-letter region for the request. Default GB; try US if a profile answers no videos.
sort_bystringnolatest (default) or popular.
user_idstringnoThe numeric user id, for faster answers.
max_cursorstringnoThe 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_tiktok_videos"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_tiktok_videos"
Confirmationnot 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.