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 and get_tiktok_videos for one creator, search_tiktok_hashtag for a tag, get_tiktok_trending 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
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:
{
"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
This page as Markdown: /docs/tools/search_tiktok.md. Something wrong or missing: hello@parel.si.