instagram · insight · contentsolari:read
solari insight instagram content aggregate
Instagram の投稿を数えるときに使います。
- MCP ツール
- solari_insight_instagram_content_aggregate
- CLI
- solari insight instagram content aggregate
- アクセス権
- solari:read
- 対象プラン
- 無料トライアル
- Plus
- Pro
- Enterprise
- クレジット
- 1
概要
収集済みの投稿を、アカウント・形式・ハッシュタグ・メンション・キーワード別に集計します。数値で答える必要がある質問に使います。
どんなときに使うか — 投稿量や平均値、どのハッシュタグが多いかを知りたいとき。投稿そのものが必要な場合は、コンテンツ検索を使います。
返される内容 — グループごとの件数（多い順）。追加の指標は指定した場合のみ返します。
パラメータ
- 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 の username のみ。
- hashtagsstring[]任意
- 指定したハッシュタグをすべて含む投稿のみ。
- mentionsstring[]任意
- 指定した username をすべてメンションしている投稿のみ。
- 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任意
- 返すグループの数。既定値
201–50
レスポンス
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
}
}注意点
- ほかの指標を指定しない限り、値が入るのは post_count だけです。
- 対象は KR・JP・US・TW の直近およそ 6 か月です。それより前の since は、扱える最も古い日付に合わせます。
- interval だけを指定すると、期間ごとに 1 つの区間を作ります。group_by と組み合わせると、グループごとに時系列が付きます。