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.

FieldTypeRequiredDescription
querystringyesThe search text.
cursornumbernoThe cursor from the previous answer, for the next page.
regionstringnoTwo-letter code of where the request comes from; it does not limit the videos to that country.
sort_byrelevance or most-liked or date-postednorelevance (default), most-liked or date-posted.
date_postedyesterday or this-week or this-month or last-3-months or last-6-months or all-timenoyesterday, 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 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_tiktok"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_tiktok"
Confirmationnot 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.