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

# search_tiktok

> TikTok videos for a keyword: description, author, likes, comments, shares, plays and link. ₹0.28 per call; a result that finds nothing is ₹0.

## What it does

Videos on TikTok matching a keyword, as TikTok's own search ranks them: data with search_item_list of about twenty videos a page, each with its description, creator (unique_id, nickname, follower_count), play, like (digg), comment, share and save counts, duration, date, whether it is an ad, and a link, plus a cursor for the next page; sort_by picks relevance, most liked or newest and date_posted narrows the window.

Use it to see what TikTok shows for a brand, a product or a trend; [`get_tiktok_profile`](https://parel.si/docs/tools/get_tiktok_profile.md) and [`get_tiktok_videos`](https://parel.si/docs/tools/get_tiktok_videos.md) for one creator, [`search_tiktok_hashtag`](https://parel.si/docs/tools/search_tiktok_hashtag.md) for a tag, [`get_tiktok_trending`](https://parel.si/docs/tools/get_tiktok_trending.md) for what is viral in a region. Flat price per page; nothing matching is free. Two to six seconds.

India: TikTok is blocked in India; the search is global, and Indian brands selling abroad and Indian creators elsewhere still appear.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The search text. |
| `cursor` | number | no | The cursor from the previous answer, for the next page. |
| `region` | string | no | Two-letter code of where the request comes from; it does not limit the videos to that country. |
| `sort_by` | `relevance` or `most-liked` or `date-posted` | no | relevance (default), most-liked or date-posted. |
| `date_posted` | `yesterday` or `this-week` or `this-month` or `last-3-months` or `last-6-months` or `all-time` | no | yesterday, this-week, this-month, last-3-months, last-6-months or all-time. |

## What drives the cost

Flat per page of about twenty videos; 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 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: "search_tiktok"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_tiktok"` |
| 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","input":{"query":"ayurvedic skincare","sort_by":"relevance"}}'
```

## What comes back

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

```json
{
  "search_item_list": [
    {
      "aweme_id": "7694816813623872800",
      "desc": "A simple kitchen mask that may leave your skin looking refreshed before a special event. #usa #ayurveda #naturalskincare #glowskin #homeremedies Not medical advice. For general wellness information only.",
      "create_time_utc": "2026-10-09T23:39:03.000Z",
      "region": "NL",
      "url": "https://www.tiktok.com/@askayurveda/video/7694816813623872800",
      "is_ad": false,
      "author": {
        "unique_id": "askayurveda",
        "nickname": "Ask Ayurveda",
        "follower_count": 87852,
        "verification_type": 0
      },
      "statistics": {
        "play_count": 10754,
        "digg_count": 245,
        "comment_count": 7,
        "share_count": 238,
        "collect_count": 197
      },
      "video": {
        "duration": 24725
      }
    },
    {
      "aweme_id": "7704694014548954398",
      "desc": "100x washed ghee is the ancient Ayurvedic secret your skincare routine is missing. 🌿✨ Ghee Sutra (Shata Dhauta Ghrita) deeply moisturizes, restores the skin barrier, and leaves you with the ultimate natural glow. Have you tried Ayurvedic s…",
      "create_time_utc": "2026-11-05T14:28:01.000Z",
      "region": "US",
      "url": "https://www.tiktok.com/@shankara.naturals/video/7704694014548954398",
      "is_ad": false,
      "author": {
        "unique_id": "shankara.naturals",
        "nickname": "Shankara Naturals",
        "follower_count": 246,
        "verification_type": 0
      },
      "statistics": {
        "play_count": 358,
        "digg_count": 3,
        "comment_count": 0,
        "share_count": 2,
        "collect_count": 0
      },
      "video": {
        "duration": 7872
      }
    },
    {
      "aweme_id": "7704524614923193631",
      "desc": "Because I’m trying to age like fine wine, not have my skin looking dry and tired 😭✨ Turmeric, Ayurvedic herbs and all that moisture in one little jar. The 30+ skincare girlies need to see this one! 💛 #SkincareOver30 #TurmericSkincare #Ayu…",
      "create_time_utc": "2026-11-05T03:30:37.000Z",
      "region": "US",
      "url": "https://www.tiktok.com/@danielleanderick/video/7704524614923193631",
      "is_ad": true,
      "author": {
        "unique_id": "a_user_21",
        "nickname": "A User 22",
        "follower_count": 8865,
        "verification_type": 0
      },
      "statistics": {
        "play_count": 11,
        "digg_count": 1,
        "comment_count": 0,
        "share_count": 0,
        "collect_count": 0
      },
      "video": {
        "duration": 8500
      }
    }
  ],
  "cursor": 30
}
```

## Notes

- Flat per page of about twenty videos; pass cursor for the next page. Answers are trimmed to the useful fields.
- region is where the request comes from, not a filter: the search is global.
- sort_by date-posted with date_posted this-week for the newest.

## Siblings

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