> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_tiktok_videos

# 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`](https://parel.si/docs/tools/get_tiktok_video.md) for one video in full, [`get_tiktok_comments`](https://parel.si/docs/tools/get_tiktok_comments.md) for the reactions, [`get_tiktok_transcript`](https://parel.si/docs/tools/get_tiktok_transcript.md) 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

```bash
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:

```json
{
  "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

- [`get_tiktok_video`](https://parel.si/docs/tools/get_tiktok_video.md)
- [`get_tiktok_comments`](https://parel.si/docs/tools/get_tiktok_comments.md)
- [`get_tiktok_transcript`](https://parel.si/docs/tools/get_tiktok_transcript.md)
