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

solari insight tiktok content aggregate

Use this to count TikTok posts.

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

Overview

Add up tracked TikTok posts by account, format, hashtag, mention, or keyword.

When to use it — When you need cadence, hashtag mix, or average plays. 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_keyword
intervalenumoptional
Add a time series at this calendar interval.Valuesdayweekmonth
metricsstring[]optional
Extra metrics besides post_count.Valueslike_sumlike_avgcomment_sumcomment_avgview_sumview_avgshare_sumshare_avgcollect_sumcollect_avgfollower_avgaccount_count
querystringoptional
Keyword filter over captions and transcripts.
usernamesstring[]optional
Only these TikTok 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.Valuesvideocarousel
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
Play total and mean, when requested.
metrics.share_sum / collect_sumnumber | null
Share and save totals, when requested.
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 tiktok content aggregate group_by=account query="이니스프리" metrics='["view_sum","like_avg","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": "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"
  ]
}

As an MCP call

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

Notes

  • view_* is plays. share_* and collect_* are filled here, unlike Instagram.
  • Coverage is KR, JP, US, and TW, about the last six months. An earlier since is moved up to the oldest date available.

Related tools

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