solari tiktok account posts

概要

1つのTikTokアカウントの投稿を新しい順に返します。ページネーションとフィルタに対応。アカウントはaccount_id（solari_tiktok_account_searchが返すTikTokアカウントのUUID）またはusername（TikTokハンドル）で指定してください。各アイテムはpost_id（SOLARIの投稿UUID）、video_id（公開されている数値のTikTok id）とurl、post_type（videoまたはcarousel）、posted_at、caption、duration_seconds、play/like/comment/share/collectの各カウント、is_ad、cover_url、images（カルーセルのスライド）、hashtags、mentions、およびinclude_transcript=trueのときはtranscriptを持ちます。文字起こしは長いため、include_transcriptはデフォルトで無効。発話内容が重要な場合のみ有効にしてください。レスポンスはfound、account_id、username、total、has_more、itemsを含みます。limitとoffsetでページングし、since/until（UTCの日付、両端を含む）とpost_typeで絞り込みます。未追跡のハンドルは最初のリクエスト時にライブ取得されます（10〜40秒かかります）。fetched_on_demand=trueは、バックグラウンドのクロールが完了するまで直近の投稿のみ利用できることを示します。found=falseは、そのハンドルがTikTokに存在しないことを意味します。サインイン済みのSOLARIアカウントであれば利用できます。

パラメータ

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ページあたりの投稿数。デフォルトは12。200を超える値は200に上限で切り詰められます。≥ 1

offsetinteger任意

ページネーションのオフセット。デフォルトは0。既定値 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

レスポンス

例

リクエスト

$ solari 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_tiktok_account_posts",
  "arguments": {
    "username": "innisfree_official",
    "limit": 2
  }
}

注意点

• 文字起こしは長いため、include_transcriptはデフォルトで無効。発話内容が重要な場合のみ有効にしてください。
• 1ページあたり最大200件。

関連ツール

• solari_tiktok_account_profileSOLARIが把握しているTikTokアカウント1件の全情報。
• solari_tiktok_content_detailTikTok投稿1件の全情報。
• solari_instagram_account_posts1つのアカウントの投稿を新しい順にページングします。

機械可読な形式: /docs/tools/tiktok-account-posts.md