tiktok · catalog · accountsolari:read
solari catalog tiktok account posts
TikTok アカウントの投稿。
- MCP ツール
- solari_catalog_tiktok_account_posts
- CLI
- solari catalog tiktok account posts
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
TikTok アカウントの投稿を一覧で返します。include_transcript は、話している内容が必要なときだけ有効にしてください。
どんなときに使うか — プロフィールのプレビューより多くの投稿が必要なとき、または期間や形式で絞り込みたいとき。
返される内容 — 投稿の一覧。指定すると動画の文字起こしも含みます。
パラメータ
- account_idstring任意
- TikTok の account_id（SOLARI アカウントの UUID）。これか username のどちらかを指定します。uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- usernamestring任意
- TikTok のユーザー名。account_id を指定した場合は無視されます。≤ 64 chars
- limitinteger任意
- 1 ページあたりの投稿数。既定値
121–200 - offsetinteger任意
- スキップする投稿数。既定値
0≥ 0 - sincestring任意
- この UTC 日付（YYYY-MM-DD）以降の投稿のみ。pattern ^\d{4}-\d{2}-\d{2}$
- untilstring任意
- この UTC 日付（YYYY-MM-DD）以前の投稿のみ。pattern ^\d{4}-\d{2}-\d{2}$
- post_typeenum任意
- video または carousel に絞り込みます。値
videocarousel - include_transcriptboolean任意
- 動画の文字起こしを含めます。既定値
false
レスポンス
Response
- foundboolean
- username が TikTok に存在しない場合は false。
- account_id / usernamestring
- 特定したアカウント。
- totalinteger
- フィルターに合う投稿の数。
- has_moreboolean
- 次のページがあるかどうか。
- itemsobject[]
- 投稿の一覧（新しい順）。
- fetched_on_demandboolean
- 現時点で最新の投稿しか取得できていない場合は true。
items[]
- post_iduuid
- TikTok の投稿 ID。Instagram の投稿 ID とは別物です。
- video_idstring
- TikTok の URL に含まれる公開の数値 ID。
- urlstring
- 公開パーマリンク。
- account_iduuid
- 投稿者の account_id。
- usernamestring
- 投稿者のユーザー名。
- post_typestring
- video または carousel。
- posted_attimestamp
- 投稿日時（UTC）。
- captionstring
- キャプション。
- duration_secondsinteger
- 動画の長さ。
- width / heightinteger
- 解像度。
- play_countinteger
- 再生数。
- like_countinteger
- いいね数。
- comment_countinteger
- コメント数。
- share_countinteger
- シェア数。
- collect_countinteger
- 保存数。
- is_adboolean
- TikTok の広告フラグ。
- is_pinnedboolean
- プロフィールに固定されているかどうか。
- aigc_label_typestring | null
- AI 生成コンテンツのラベル（TikTok が付けている場合）。
- original_language_codestring | null
- 元の言語。
- cover_urlstring
- カバー画像の URL。
- video_urlstring
- 動画ファイルの URL。
- imagesstring[]
- カルーセルの各スライド。動画の場合は空です。
- hashtagsstring[]
- キャプション内のハッシュタグ。
- mentionsstring[]
- キャプションでメンションされているユーザー名。
- transcriptstring | null
- 動画の文字起こし。account posts と content batch では include_transcript=true のときだけ返ります。
- assetsobject[]
- メディアファイル（掲載順）。それぞれに asset_url、media_type、video_duration があります。
- assets[].asset_urlstring | null
- フルサイズの画像または動画の直接ダウンロードリンク。ファイルが保存されていない場合は null。
例
リクエスト
$ solari catalog tiktok account posts username=innisfree_official limit=2レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。
{
"found": true,
"account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
"username": "innisfree_official",
"total": 87,
"has_more": true,
"items": [
{
"post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
"video_id": "7680375687139642645",
"url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
"account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
"username": "innisfree_official",
"post_type": "video",
"posted_at": "2026-09-02T12:00:00Z",
"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 Green Tea Ceramide Mist: Touch-free, fa …",
"duration_seconds": 23,
"width": 1080,
"height": 1920,
"play_count": 493,
"like_count": 37,
"comment_count": 2,
"share_count": 0,
"collect_count": 3,
"is_ad": false,
"is_pinned": false,
"aigc_label_type": null,
"original_language_code": null,
"cover_url": "https://smr-images-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/cover.jpg",
"video_url": "https://smr-images-a.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
"images": [],
"hashtags": [],
"mentions": [],
"transcript": null
},
"… 1 more"
],
"fetched_on_demand": false
}MCP で呼び出す場合
{
"name": "solari_catalog_tiktok_account_posts",
"arguments": {
"username": "innisfree_official",
"limit": 2
}
}注意点
- 動画の文字起こしはデータ量が大きいため、include_transcript は既定で無効です。
- カタログだけを読みます。アカウントがまだカタログにない場合は、solari fetch tiktok posts username=… を実行してから再試行してください。