for agents
← All tools
tiktok · fetch · postsolari:read

solari fetch tiktok post search

Find TikTok videos by keyword, live.

MCP tool
solari_fetch_tiktok_post_search
CLI
solari fetch tiktok post search
Access
solari:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
Credit
1

Overview

Search TikTok itself for videos matching a keyword, in TikTok's own relevance order. Hits are thin: video id, URL, author, caption, posting time, play, like, comment, and share counts, duration, and cover image. Nothing is stored; fetch tiktok post collects any hit by its URL.

When to use it — When you want what people post on TikTok about a topic, brand, or phrase and have no handle to start from.

What comes back — Up to limit videos in TikTok's order, a cursor for the next page, and the fetch command to collect the first one.

Parameters

querystringrequired
Keyword or phrase to search for.≤ 100 chars
limitintegeroptional
How many videos per page, at most.default 201–30
cursorstringoptional
next_cursor from the previous page of the same query. Leave it out for the first page.≤ 1024 chars

Response

Response

querystring
The keyword the search ran on.
itemsobject[]
Matching videos, TikTok's relevance order.
totalinteger
Videos on this page.
has_moreboolean
true when TikTok has another page.
next_cursorstring | null
Pass it back as cursor with the same query. Null on the last page.
notestring | null
Caveat, when there is one: for example when nothing matched.
nextstring
Fetch command to collect the first video. Only when there is a hit.

items[]

video_idstring
Public numeric TikTok id.
urlstring
Public video URL. Pass it to fetch tiktok post.
usernamestring | null
Author handle, when the URL carries it.
captionstring | null
Caption text.
posted_attimestamp | null
Published at (UTC).
play_countinteger | null
Plays.
like_countinteger | null
Likes.
comment_countinteger | null
Comments.
share_countinteger | null
Shares.
duration_secondsinteger | null
Video length in seconds.
cover_urlstring | null
Cover image URL. It can expire, so use it promptly.

Example

Request

$ solari fetch tiktok post search query="green tea ceramide" limit=1

Response · Long strings and repeated array entries are trimmed for readability.

{
  "query": "green tea ceramide",
  "items": [
    {
      "video_id": "7680375687139642645",
      "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
      "username": "innisfree_official",
      "caption": "Deeply hydrated skin—NO OFF HOURS. 💚  wherever the day takes MINGYU—his hydration stays SUPERCHARGED ⚡️ Green Tea Ceramide Milk: Lightweight milky toner that won't clog your pores …",
      "posted_at": "2026-09-02T12:00:00Z",
      "play_count": 493,
      "like_count": 37,
      "comment_count": 2,
      "share_count": 0,
      "duration_seconds": 23,
      "cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/oQfAEIgDBRiLAeFsAQeZhIQ9CEfIAgBDpAqbfE~tplv-tiktokx-origin.image?…"
    }
  ],
  "total": 1,
  "has_more": true,
  "next_cursor": "eyJjIjoiMSIsInMiOiIyMDI2MDkyOTA2NDUxOEIzRDJGMDdBOUMxRTRCNkQ4RjAyIn0",
  "note": null,
  "next": "solari fetch tiktok post url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645"
}

As an MCP call

{
  "name": "solari_fetch_tiktok_post_search",
  "arguments": {
    "query": "green tea ceramide",
    "limit": 1
  }
}

Notes

  • Results follow TikTok's relevance ranking and may include loosely related videos. Read caption and username before using one.
  • Nothing is stored and hits carry no post_id. fetch tiktok post with a hit's url collects and stores the full post with its author.
  • When has_more is true, pass next_cursor as cursor with the same query for the next page. A cursor does not carry over to another query.
  • Every call asks TikTok live, takes a few seconds, and is not cached. An empty items list with a note means no public video matched.

Related tools

Machine-readable: /docs/tools/fetch-tiktok-post-search.md