tiktok · fetch · postsolari:read

solari fetch tiktok post search

Find TikTok videos by keyword, live. Start here on TikTok.

MCP tool

solari_fetch_tiktok_post_search

Access

solari:read

Plans

Free Trial
Plus
Pro
Enterprise

Credit

Overview

Search TikTok itself for videos matching a keyword, in TikTok's own relevance order. Start here for any TikTok topic, because the TikTok catalog is small. Hits are saved as thin records; fetch tiktok post completes any hit by its URL.

When to use it — Whenever you want what people post on TikTok about a topic, brand, or phrase. Use it before catalog content search.

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

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.
Hits are saved as thin records and carry no post_id. fetch tiktok post with a hit's url collects 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.
There is no date filter. For a date range, use catalog tiktok content search with since and until.

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

Overview

Parameters

Response

Example

Notes

Related tools