for agents
← All tools
instagram · insight · contentsolari:read

solari insight instagram content aggregate

Use this to count Instagram posts.

MCP tool
solari_insight_instagram_content_aggregate
CLI
solari insight instagram content aggregate
Access
solari:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
Credit
1

Overview

Add up tracked posts by account, format, hashtag, mention, or keyword — for questions that need a number.

When to use it — When you need volume, averages, or which hashtag leads. For the posts themselves, use content search.

What comes back — Counts per group, largest first. Extra metrics only if you ask for them.

Parameters

regionenumoptional
KR, JP, US, or TW.default "KR"ValuesKRJPUSTW
group_byenumoptional
How to split the counts.Valuesaccountpost_typehashtagmentioncaption_keywordtranscription_keyword
intervalenumoptional
Add a time series at this calendar interval.Valuesdayweekmonth
metricsstring[]optional
Extra metrics besides post_count.Valueslike_sumlike_avgcomment_sumcomment_avgview_sumview_avgfollower_avgaccount_count
querystringoptional
Keyword filter over captions and transcripts.
usernamesstring[]optional
Only these Instagram usernames.
hashtagsstring[]optional
Only posts that have all of these hashtags.
mentionsstring[]optional
Only posts that mention all of these usernames.
post_typesstring[]optional
Only these formats.
sincestringoptional
Only posts on or after this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
untilstringoptional
Only posts on or before this UTC date (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
limitintegeroptional
How many groups to return.default 201–50

Response

Response

regionstring
Region aggregated.
sincedate
Start date actually used.
untildate | null
End date actually used.
group_bystring | null
Grouping applied.
intervalstring | null
Time interval applied.
total_postsinteger
Number of posts matching the filters.
truncatedboolean
true if more groups existed than limit.
bucketsobject[]
Groups, largest first.

buckets[]

keystring
Group value. A single total when group_by is omitted.
metrics.post_countinteger
Post count. Always present.
metrics.like_sum / like_avgnumber | null
Like total and mean, when requested.
metrics.comment_sum / comment_avgnumber | null
Comment total and mean, when requested.
metrics.view_sum / view_avgnumber | null
View total and mean, when requested.
metrics.share_sum / collect_sumnumber | null
TikTok-only. Always null here.
metrics.follower_avgnumber | null
Mean follower count of authors.
metrics.account_countinteger | null
Distinct accounts in the group.
seriesobject[] | null
Per-period breakdown, when interval is set.

Example

Request

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

Response · Long strings and repeated array entries are trimmed for readability.

{
  "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"
  ]
}

As an MCP call

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

Notes

  • Only post_count is filled unless you name other metrics.
  • Coverage is KR, JP, US, and TW, about the last six months. An earlier since is moved up to the oldest date available.
  • interval alone makes one bucket per period. Combined with group_by, each group gets a series.

Related tools

Machine-readable: /docs/tools/insight-instagram-content-aggregate.md