solari instagram content aggregate

概要

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

パラメータ

regionenum任意

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

group_byenum任意

グループ化する軸。省略すると、絞り込み後の集合全体を単一の合計バケットに集計します。値accountpost_typehashtagmentioncaption_keywordtranscription_keyword

intervalenum任意

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

metricsstring[]任意

常に返るpost_count以外に取得する追加メトリクス。メトリクスの値はスナップショットであり、実際の最新値より遅れることがあります。値like_sumlike_avgcomment_sumcomment_avgview_sumview_avgfollower_avgaccount_count

querystring任意

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

usernamesstring[]任意

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

hashtagsstring[]任意

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

mentionsstring[]任意

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

post_typesstring[]任意

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

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 instagram content aggregate group_by=hashtag query="이니스프리" metrics='["like_avg","view_sum","account_count"]' limit=5

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

{
  "region": "KR",
  "since": "2026-03-04",
  "until": null,
  "group_by": "hashtag",
  "interval": null,
  "total_posts": 1647,
  "truncated": true,
  "buckets": [
    {
      "key": "이니스프리",
      "metrics": {
        "post_count": 772,
        "like_sum": null,
        "like_avg": 320.7240932642487,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 9400953,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 587
      },
      "series": null
    },
    {
      "key": "광고",
      "metrics": {
        "post_count": 548,
        "like_sum": null,
        "like_avg": 373.04021937842776,
        "comment_sum": null,
        "comment_avg": null,
        "view_sum": 5463711,
        "view_avg": null,
        "share_sum": null,
        "share_avg": null,
        "collect_sum": null,
        "collect_avg": null,
        "follower_avg": null,
        "account_count": 381
      },
      "series": null
    },
    "… 3 more"
  ]
}

MCP 呼び出しとして

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

注意点

• post_countは常に返ります。それ以外はmetricsで指定しない限りnull。
• mentionsで絞り込みaccountでグループ化すると、「どのアカウントがこのハンドルをタグ付けしたか」が分かります。
• インデックスの対象はKR、JP、US、TWで、範囲はおよそ直近6か月。sinceのデフォルトは183日前で、これが受け付けられる下限でもあります。それより古い値は切り詰められ、適用された値がレスポンスに返されます。
• interval単独では期間ごとに1バケットを返します。group_byと組み合わせると、各グループが時系列を持ちます。
• 投稿そのものが答えになる場合はcontent searchをお使いください。

関連ツール

• solari_instagram_content_searchキャプション、クリエイターのbio、動画の文字起こしを横断するキーワード検索。
• solari_tiktok_content_aggregateTikTok 投稿を列挙せずに集計します。

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