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

# get_tiktok_trending

> TikTok's trending For You feed for a region: the viral videos of the moment with their numbers. ₹0.28 per call; a result that finds nothing is ₹0.

## What it does

What TikTok's For You feed is showing in a region right now: data with the trending videos, each with description, author, likes, comments, shares, plays, music and link.

Use it to see what is viral in a market this week and which sounds and formats are rising; [`get_tiktok_trending_hashtags`](https://parel.si/docs/tools/get_tiktok_trending_hashtags.md) gives the trending tags with their curves, [`search_tiktok`](https://parel.si/docs/tools/search_tiktok.md) searches by keyword. Flat price per call. Two to six seconds.

India: TikTok is blocked in India; read the markets you sell into (AE for the Gulf, GB, US).

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `region` | string | yes | Two-letter region whose For You feed to read ("US", "GB", "AE"). |

## What drives the cost

Flat per call; the feed as it stands, trimmed to the useful fields. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 57 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per call (`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_trending"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_tiktok_trending"` |
| 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_trending","input":{"region":"US"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "aweme_list": [
    {
      "aweme_id": "7673120354067402004",
      "desc": null,
      "create_time_utc": "2026-08-12T12:25:56.000Z",
      "region": "MM",
      "url": "https://www.tiktok.com/@www.com.2341/video/7673120354067402004",
      "is_ad": false,
      "author": {
        "unique_id": "a_user_33",
        "nickname": "a_user_33"
      },
      "statistics": {
        "play_count": 1186692,
        "digg_count": 218052,
        "comment_count": 196,
        "share_count": 10487,
        "collect_count": 16588
      },
      "video": {
        "duration": 0
      }
    },
    {
      "aweme_id": "7693269241973312788",
      "desc": "The beauty of Mufasa                                                                                                                                                                                                               #mufasa #lion…",
      "create_time_utc": "2026-10-05T19:34:01.000Z",
      "region": "JP",
      "url": "https://www.tiktok.com/@norage_ae/video/7693269241973312788",
      "is_ad": false,
      "author": {
        "unique_id": "a_user_34",
        "nickname": "a_user_35"
      },
      "statistics": {
        "play_count": 6142553,
        "digg_count": 496776,
        "comment_count": 4152,
        "share_count": 60356,
        "collect_count": 55901
      },
      "video": {
        "duration": 11000
      }
    },
    {
      "aweme_id": "7682396134693735698",
      "desc": "1080P 59.94FPS #makuovvmedia #1080p #60fps #edit #caredit #ultrace",
      "create_time_utc": "2026-09-06T12:20:42.000Z",
      "region": "KZ",
      "url": "https://www.tiktok.com/@makuovv.media/video/7682396134693735698",
      "is_ad": false,
      "author": {
        "unique_id": "a_user_36",
        "nickname": "A User 37"
      },
      "statistics": {
        "play_count": 3400928,
        "digg_count": 564577,
        "comment_count": 5745,
        "share_count": 65280,
        "collect_count": 80503
      },
      "video": {
        "duration": 11000
      }
    }
  ]
}
```

## Notes

- Flat per call; the feed as it stands, trimmed to the useful fields.
- region is the market whose feed you read.
- Pairs with get_tiktok_trending_hashtags.

## Siblings

- [`get_tiktok_trending_hashtags`](https://parel.si/docs/tools/get_tiktok_trending_hashtags.md)
- [`search_tiktok`](https://parel.si/docs/tools/search_tiktok.md)
