tiktok · fetch · postsolari:read
solari fetch tiktok post search
TikTok の動画をキーワードでライブ検索します。
- MCP ツール
- solari_fetch_tiktok_post_search
- CLI
- solari fetch tiktok post search
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
キーワードで TikTok 自体の動画を検索します。結果は TikTok の関連度順で、動画 id、URL、投稿者、キャプション、投稿日時、再生・いいね・コメント・シェア数、長さ、カバー画像だけの薄い一覧です。何も保存せず、どのヒットも URL で fetch tiktok post を呼べば収集できます。
どんなときに使うか — あるテーマ、ブランド、フレーズについて人々が TikTok に何を投稿しているか知りたいが、起点となるハンドルがないときに使います。
返される内容 — TikTok の順序で最大 limit 件の動画、次のページ用の cursor、最初の動画を収集する fetch コマンドです。
パラメータ
- querystring必須
- 検索するキーワードやフレーズ。≤ 100 chars
- limitinteger任意
- 1 ページあたり最大何件まで。既定値
201–30 - cursorstring任意
- 同じ query の前のページで受け取った next_cursor。最初のページでは省略します。≤ 1024 chars
レスポンス
Response
- querystring
- 検索に使ったキーワード。
- itemsobject[]
- 一致した動画。TikTok の関連度順。
- totalinteger
- このページの動画の数。
- has_moreboolean
- TikTok に次のページがあれば true。
- next_cursorstring | null
- 同じ query と一緒に cursor として渡す値。最後のページなら null。
- notestring | null
- 注意点があるときだけ入ります。たとえば一致する動画がないとき。
- nextstring
- 最初の動画を収集する fetch コマンド。結果があるときだけ。
items[]
- video_idstring
- TikTok の公開数値 id。
- urlstring
- 公開動画の URL。そのまま fetch tiktok post に渡せます。
- usernamestring | null
- 投稿者のハンドル。URL に含まれるときだけ。
- captionstring | null
- キャプション。
- posted_attimestamp | null
- 投稿日時(UTC)。
- play_countinteger | null
- 再生数。
- like_countinteger | null
- いいね数。
- comment_countinteger | null
- コメント数。
- share_countinteger | null
- シェア数。
- duration_secondsinteger | null
- 動画の長さ(秒)。
- cover_urlstring | null
- カバー画像の URL。期限切れになることがあるので早めに使ってください。
例
リクエスト
$ solari fetch tiktok post search query="green tea ceramide" limit=1レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"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"
}MCP で呼び出す場合
{
"name": "solari_fetch_tiktok_post_search",
"arguments": {
"query": "green tea ceramide",
"limit": 1
}
}注意点
- 結果は TikTok の関連度ランキングなので、ゆるく関連するだけの動画が混ざることがあります。使う前に caption と username を確認してください。
- 何も保存せず、ヒットに post_id はありません。ヒットの url で fetch tiktok post を呼ぶと、投稿者と一緒に投稿全体を収集して保存します。
- has_more が true なら、next_cursor を同じ query と一緒に cursor として渡すと次のページを受け取れます。cursor は別の query には使えません。
- 呼び出しごとに TikTok へライブで問い合わせます。数秒かかり、cache はありません。items が空で note があれば、一致する公開動画がありません。