instagram · insight · contentsolari:read

solari insight instagram content aggregate

Instagram の投稿数を数えるときに使います。

MCP ツール: solari_insight_instagram_content_aggregate
CLI: solari insight instagram content aggregate
アクセス権: solari:readサインイン済みの SOLARI アカウントであれば利用できます。サインイン済みの SOLARI アカウントであれば利用できます。
Required plan: Free
Credit: 0

概要

アカウント、形式、ハッシュタグ、メンション、キーワードごとに投稿数を足します。答えが数字のときに使います。

どんなときに使うか — 規模、平均、どのハッシュタグが先頭かが必要なときに使います。投稿そのものは content search です。

何が返るか — グループごとの件数です。大きいグループが先に来ます。ほかの指標は頼んだものだけ入ります。

パラメータ

regionenum任意: KR、JP、US、TW。既定値 "KR"値KRJPUSTW
group_byenum任意: 件数の分け方。値accountpost_typehashtagmentioncaption_keywordtranscription_keyword
intervalenum任意: この暦の間隔で時系列を付けます。値dayweekmonth
metricsstring[]任意: post_count 以外に欲しい指標。値like_sumlike_avgcomment_sumcomment_avgview_sumview_avgfollower_avgaccount_count
querystring任意: キャプションと文字起こしで探すキーワード。
usernamesstring[]任意: これらの Instagram ユーザー名だけ。
hashtagsstring[]任意: これらのハッシュタグをすべて持つ投稿だけ。
mentionsstring[]任意: これらのユーザー名をすべてメンションした投稿だけ。
post_typesstring[]任意: これらの形式だけ。
sincestring任意: この UTC 日付以降の投稿だけ (YYYY-MM-DD)。pattern ^\d{4}-\d{2}-\d{2}$
untilstring任意: この UTC 日付以前の投稿だけ (YYYY-MM-DD)。pattern ^\d{4}-\d{2}-\d{2}$
limitinteger任意: 返すグループの数。≥ 1

レスポンス

Response

regionstring: 集計した国。
sincedate: 実際に使った開始日。
untildate | null: 実際に使った終了日。
group_bystring | null: 適用したグループ化。
intervalstring | null: 適用した時間間隔。
total_postsinteger: フィルタに一致した投稿。
truncatedboolean: limit より多くのグループがあったとき true。
bucketsobject[]: グループです。大きい順です。

buckets[]

keystring: グループの値。group_by を省略すると、合計が 1 つだけです。
metrics.post_countinteger: 投稿数。常に入ります。
metrics.like_sum / like_avgnumber | null: いいねの合計と平均。頼んだときだけ入ります。
metrics.comment_sum / comment_avgnumber | null: コメントの合計と平均。頼んだときだけ入ります。
metrics.view_sum / view_avgnumber | null: 再生数の合計と平均。頼んだときだけ入ります。
metrics.share_sum / collect_sumnumber | null: TikTok 専用。ここでは常に null。
metrics.follower_avgnumber | null: 投稿者の平均フォロワー数。
metrics.account_countinteger | null: グループ内のユニークアカウント数。
seriesobject[] | null: 期間ごとの内訳。interval を付けたとき。

例

リクエスト

$ solari insight 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_insight_instagram_content_aggregate",
  "arguments": {
    "group_by": "hashtag",
    "query": "이니스프리",
    "metrics": [
      "like_avg",
      "view_sum",
      "account_count"
    ],
    "limit": 5
  }
}

注意点

metrics に名前を付けないと post_count だけが入ります。
KR、JP、US、TW のだいたい直近 6 ヶ月です。それより古い since は切り詰められます。
interval だけなら期間ごとに1枠です。group_by と一緒だと、グループごとに時系列が付きます。

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

概要

パラメータ

レスポンス

例

注意点

関連ツール