solari tiktok content aggregate

概要

追跡中の TikTok 投稿に対する件数とエンゲージメントの集計。個別の投稿ではなく数値で答える問いにお使いください。アカウントごとの月間投稿数、あるトピックで優勢なハッシュタグ、フォーマット別の平均再生数など。account、post_type、hashtag、mention、caption_keyword でグループ化し、さらに各グループを day、week、month で分割できます。post_count は常に返ります。metrics を指定すると like/comment/view/share/collect の合計と平均 (view_* 系の指標は再生数を数える)、フォロワー数の平均、ユニークアカウント数が返ります。フリーテキストの query (キャプションと動画の文字起こしが対象)、usernames、hashtags、mentions、post_types (video、carousel) で対象を絞り込みます。mentions で絞り込み account でグループ化すると、特定のハンドルをタグ付けしたアカウントが分かります。カバー範囲は KR、JP、US、TW のリージョンで、おおよそ直近 6 か月分を保持します。それより古い since は切り詰められ、適用された値がレスポンスに返されます。バケットは大きい順。truncated=true は limit で返した数より多くのグループが存在したことを意味します。件数ではなく投稿そのものが必要な場合は solari_tiktok_content_search をお使いください。サインイン済みの SOLARI アカウントであれば利用できます。

パラメータ

regionenum任意

集計対象のリージョン。インデックスされているのはこの 4 リージョンのみ。既定値 "KR"値KRJPUSTW

group_byenum任意

グループ化する軸。省略すると、絞り込んだ集合全体を 1 つの合計バケットに集計します。値accountpost_typehashtagmentioncaption_keyword

intervalenum任意

分割するカレンダー間隔。単独で指定すると期間ごとに 1 バケットを返し、group_by と組み合わせると各グループが時系列を持ちます。値dayweekmonth

metricsstring[]任意

常に返る post_count に加えて取得する指標。view_* 系の指標は再生数を数えます。指標値はスナップショットであり、リアルタイムの数値より遅れることがあります。値like_sumlike_avgcomment_sumcomment_avgview_sumview_avgshare_sumshare_avgcollect_sumcollect_avgfollower_avgaccount_count

querystring任意

キャプションと動画の文字起こしに対して照合するフリーテキストのフィルタ。

usernamesstring[]任意

これらの TikTok ハンドルに限定します。

hashtagsstring[]任意

これらのハッシュタグをすべて含む投稿に限定します。

mentionsstring[]任意

これらのハンドルをすべてタグ付けしている投稿に限定します。group_by=account と組み合わせると、特定のハンドルをタグ付けしているアカウントをランキングできます。

post_typesstring[]任意

これらの投稿フォーマットに限定します。値videocarousel

sincestring任意

この UTC 日付以降の投稿のみ。YYYY-MM-DD 形式で当日を含みます。デフォルトは 183 日前で、これが受け付ける最も古い境界でもあります。pattern ^\d{4}-\d{2}-\d{2}$

untilstring任意

この UTC 日付以前の投稿のみ。YYYY-MM-DD 形式で当日を含みます。pattern ^\d{4}-\d{2}-\d{2}$

limitinteger任意

group_by を指定したときに返るグループの最大数、デフォルトは 20。50 を超える値は上限の 50 に切り詰められます。≥ 1

レスポンス

例

リクエスト

$ solari tiktok content aggregate group_by=account query="이니스프리" metrics='["view_sum","like_avg","account_count"]' limit=5

レスポンス · 読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。

{
  "region": "KR",
  "since": "2026-03-04",
  "until": null,
  "group_by": "account",
  "interval": null,
  "total_posts": 20,
  "truncated": true,
  "buckets": [
    {
      "key": "merryview_",
      "metrics": {
        "post_count": 2,
        "like_sum": null,
        "like_avg": 2378.5,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 179504,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 1
      },
      "series": null
    },
    {
      "key": "_kimdayun_",
      "metrics": {
        "post_count": 1,
        "like_sum": null,
        "like_avg": 1829,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 102000,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 1
      },
      "series": null
    },
    "… 3 more"
  ]
}

MCP 呼び出しとして

{
  "name": "solari_tiktok_content_aggregate",
  "arguments": {
    "group_by": "account",
    "query": "이니스프리",
    "metrics": [
      "view_sum",
      "like_avg",
      "account_count"
    ],
    "limit": 5
  }
}

注意点

• view_* 系の指標は再生数を数えます。
• Instagram 版と違い、share_* と collect_* には実際に値が入ります。また transcription_keyword によるグループ化はありません。
• インデックスは KR、JP、US、TW をおおよそ直近 6 か月分カバーします。since の下限は 183 日前。それより古い値は切り詰められ、適用値が返されます。

関連ツール

• solari_tiktok_content_searchTikTokのキャプションと動画の文字起こしを横断するキーワード検索。
• solari_instagram_content_aggregate投稿を列挙するのではなく数えます。アカウント、フォーマット、ハッシュタグ、メンション、キーワード単位。

機械可読な形式: /docs/tools/tiktok-content-aggregate.md