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

# search_tiktok_hashtag

> The videos under a TikTok hashtag: description, author, likes, comments, shares, plays and link. ₹0.28 per page; a result that finds nothing is ₹0.

## What it does

The videos TikTok shows under a hashtag (without the #): data with each video's description, author, likes, comments, shares, plays, music and link, plus a cursor for the next page.

Use it to see what a campaign or trend tag looks like on TikTok; [`search_tiktok`](https://parel.si/docs/tools/search_tiktok.md) searches by keyword, [`get_tiktok_trending`](https://parel.si/docs/tools/get_tiktok_trending.md) shows the For You feed for a region, [`get_instagram_hashtag`](https://parel.si/docs/tools/get_instagram_hashtag.md) the same tag on Instagram. Flat price per page; a tag with no videos is free. Two to six seconds.

India: TikTok is blocked in India; region sets where the request comes from, not where the videos are from.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `cursor` | number | no | The cursor from the previous answer, for the next page. |
| `region` | string | no | Two-letter region for the request ("US"). |
| `hashtag` | string | yes | The hashtag, without the #. |

## What drives the cost

Flat per page; pass 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: "search_tiktok_hashtag"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_tiktok_hashtag"` |
| 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":"search_tiktok_hashtag","input":{"region":"US","hashtag":"skincare"}}'
```

## What comes back

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

```json
{
  "aweme_list": [
    {
      "aweme_id": "7341849029694737696",
      "desc": "This is the correct order to apply your AM skin routine! 💕🧴✨ #dermatologist #dradel #skintok #skincare #skincareroutine #skincaretips #morningroutine #skincaresteps #foryou #fyp #fypシ ",
      "create_time_utc": "2024-03-02T19:24:00.000Z",
      "region": "GB",
      "url": "https://www.tiktok.com/@aamnaadel/video/7341849029694737696",
      "is_ad": false,
      "author": {
        "unique_id": "a_user_31",
        "nickname": "A User 32",
        "follower_count": 0,
        "verification_type": 1
      },
      "statistics": {
        "play_count": 2813485,
        "digg_count": 92357,
        "comment_count": 1076,
        "share_count": 4379,
        "collect_count": 65689
      },
      "video": {
        "duration": 15467
      }
    },
    {
      "aweme_id": "7334703757374262574",
      "desc": "#CapCut the bouncy glass skin cream lives up to the hype ✨🤩🥰 #skincare #glassskin #glowyskincare #kbeauty #koreanskincare #skincare #acne #pores ",
      "create_time_utc": "2024-02-12T13:17:57.000Z",
      "region": "US",
      "url": "https://www.tiktok.com/@songofskin/video/7334703757374262574",
      "is_ad": false,
      "author": {
        "unique_id": "songofskin",
        "nickname": "Song Of Skin",
        "follower_count": 0,
        "verification_type": 1
      },
      "statistics": {
        "play_count": 972341,
        "digg_count": 11883,
        "comment_count": 104,
        "share_count": 2677,
        "collect_count": 6009
      },
      "video": {
        "duration": 18900
      }
    },
    {
      "aweme_id": "7334428130209172769",
      "desc": "Correct order of PM skincare routine from a derm #dermatologist #dradel #skincare #skincareroutine #skintok #skincareproducts #skincareroutine #skincaretips #nighttimeroutine #exfoliants #retinol #foryou #fyp #fypシ ",
      "create_time_utc": "2024-02-11T19:27:19.000Z",
      "region": "GB",
      "url": "https://www.tiktok.com/@aamnaadel/video/7334428130209172769",
      "is_ad": false,
      "author": {
        "unique_id": "a_user_31",
        "nickname": "A User 32",
        "follower_count": 0,
        "verification_type": 1
      },
      "statistics": {
        "play_count": 1137563,
        "digg_count": 37987,
        "comment_count": 481,
        "share_count": 1552,
        "collect_count": 29027
      },
      "video": {
        "duration": 20500
      }
    }
  ],
  "cursor": 20
}
```

## Notes

- Flat per page; pass cursor for the next page. Answers are trimmed to the useful fields.
- region is where the request comes from; it does not limit the videos to that country.
- A tag with no videos is free.

## Siblings

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