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

# get_tiktok_trending_hashtags

> The hashtags trending on TikTok in a market and industry, with popularity curves and post counts. ₹4.06 per call; a result that finds nothing is ₹0.

## What it does

The hashtags trending on TikTok in one market, optionally within one industry (beauty, apparel, food and so on), over the last 7, 30 or 90 days: data with the ranked tags, each with its daily popularity curve, post count, video views and leading creators.

Use it to plan content and spot a category trend before it peaks; [`get_tiktok_trending`](https://parel.si/docs/tools/get_tiktok_trending.md) shows the videos, [`search_tiktok_hashtag`](https://parel.si/docs/tools/search_tiktok_hashtag.md) the videos under one tag. Flat price per call for up to twenty tags. Two to six seconds.

India: TikTok is blocked in India and the market list does not include it; read the markets you sell into.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `limit` | integer | no | How many hashtags, up to 20. Default 3.; min 1, max 20 |
| `period` | `7` or `30` or `90` | no | 7, 30 or 90 days. |
| `region` | `US` or `FR` or `DE` or `IT` or `ES` or `GB` or `AR` or `AU` or `BR` or `CA` or `CO` or `EG` or `ID` or `IL` or `JP` or `KR` or `MY` or `MX` or `PH` or `SA` or `SG` or `ZA` or `TW` or `TH` or `TR` or `AE` or `VN` | no | Two-letter market code ("US", "GB", "AE"). |
| `industry` | `apparel_accessories` or `baby_kids_maternity` or `beauty_personal_care` or `education` or `food_beverage` or `games` or `health` or `home_improvement` or `household_products` or `news_entertainment` or `pets` or `sports_outdoor` or `tech_electronics` or `travel` or `vehicle_transportation` | no | One industry, or leave empty for all: beauty_personal_care, apparel_accessories, food_beverage and so on. |

## What drives the cost

Flat per call for up to twenty tags; limit above 20 is refused as invalid_input (free). A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹4.06** per call (`cost_paise: 406`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹6.09 (`hold_paise: 609`); 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_hashtags"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_tiktok_trending_hashtags"` |
| 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_hashtags","input":{"limit":10,"period":7,"region":"US","industry":"beauty_personal_care"}}'
```

## What comes back

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

```json
{
  "items": [
    {
      "hashtag": "halloweentransition",
      "hashtagId": "34947232",
      "popularity": [
        {
          "atUtc": 1793145600,
          "value": 19.35837773013171
        },
        {
          "atUtc": 1793232000,
          "value": 30.777177657172984
        },
        {
          "atUtc": 1793318400,
          "value": 61.31304554818152
        }
      ],
      "posts": 28725,
      "rank": 1,
      "topCreators": [
        {
          "countryCode": "US",
          "followers": 29201,
          "handle": "a_user_38",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/1672fa1c881e77db953dafe824ece6df~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "A User 39",
          "rank": 1
        },
        {
          "countryCode": "US",
          "followers": 538417,
          "handle": "a_user_40",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/4e950c0e12c4af37be32d32abb07a2a9~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "A User 41",
          "rank": 2
        },
        {
          "countryCode": "US",
          "followers": 615618,
          "handle": "a_user_42",
          "image": "https://p19-common-sign.tiktokcdn.com/tos-maliva-avt-0068/fbd97c4752f72f5d73a0ba9963a3f1b0~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "A User 43",
          "rank": 3
        }
      ],
      "views": 92135491
    },
    {
      "hashtag": "sephorasale",
      "hashtagId": "13627244",
      "popularity": [
        {
          "atUtc": 1793145600,
          "value": 0
        },
        {
          "atUtc": 1793232000,
          "value": 36.04977081908119
        },
        {
          "atUtc": 1793318400,
          "value": 100
        }
      ],
      "posts": 14413,
      "rank": 2,
      "topCreators": [
        {
          "countryCode": "US",
          "followers": 38944,
          "handle": "a_user_44",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/71a0c00b90cb5a74327b79e69bee1b42~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "a_user_44",
          "rank": 1
        },
        {
          "countryCode": "US",
          "followers": 62840,
          "handle": "a_user_45",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/7326724208753377323~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "a_user_46",
          "rank": 2
        },
        {
          "countryCode": "US",
          "followers": 51012,
          "handle": "a_user_47",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/6f216424c5f585e54682f4d12bd3335c~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "a_user_48",
          "rank": 3
        }
      ],
      "views": 86684166
    },
    {
      "hashtag": "catrina",
      "hashtagId": "1380151",
      "popularity": [
        {
          "atUtc": 1793145600,
          "value": 0
        },
        {
          "atUtc": 1793232000,
          "value": 21.460820685701833
        },
        {
          "atUtc": 1793318400,
          "value": 58.846588226675955
        }
      ],
      "posts": 11431,
      "rank": 3,
      "topCreators": [
        {
          "countryCode": "US",
          "followers": 34110,
          "handle": "a_user_49",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/b61c95086ca82a53e9e576152b2aa803~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "A User 50",
          "rank": 1
        },
        {
          "countryCode": "US",
          "followers": 108951,
          "handle": "a_user_51",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/a3fd411d14603e55a33bab8d8ef1357b~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "a_user_52",
          "rank": 2
        },
        {
          "countryCode": "US",
          "followers": 254861,
          "handle": "a_user_53",
          "image": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/d3f523087078fecdba922e640622d42a~tplv-tiktokx-cropcenter:300:300.jpeg",
          "nickname": "a_user_54",
          "rank": 3
        }
      ],
      "views": 48849755
    }
  ]
}
```

## Notes

- Flat per call for up to twenty tags; limit above 20 is refused as invalid_input (free).
- industry narrows to one of the platform's categories; omit it for the overall board.
- Markets are TikTok's published list; India is not on it.

## Siblings

- [`get_tiktok_trending`](https://parel.si/docs/tools/get_tiktok_trending.md)
- [`search_tiktok_hashtag`](https://parel.si/docs/tools/search_tiktok_hashtag.md)
