tiktok · insight · contentsolari:read

solari insight tiktok content aggregate

TikTok 포스트 개수를 셀 때 사용해요.

MCP 도구: solari_insight_tiktok_content_aggregate
CLI: solari insight tiktok content aggregate
권한: solari:read로그인한 SOLARI 계정이면 쓸 수 있어요.로그인한 SOLARI 계정이면 쓸 수 있어요.
Required plan: Free
Credit: 0

개요

계정, 형식, 해시태그, 멘션, 키워드별로 틱톡 포스트 수를 더해요.

언제 쓰나 — 업로드 리듬, 해시태그 비중, 평균 재생이 필요할 때 사용해요. 포스트 자체는 content search예요.

무엇이 나오나 — 그룹별 개수예요. 큰 그룹이 먼저 와요. 다른 지표는 요청한 것만 채워져요.

파라미터

regionenum선택: KR, JP, US, TW기본값 "KR"값KRJPUSTW
group_byenum선택: 개수를 어떻게 나눌지값accountpost_typehashtagmentioncaption_keyword
intervalenum선택: 이 달력 간격으로 시계열을 붙여요값dayweekmonth
metricsstring[]선택: post_count 외에 받을 지표값like_sumlike_avgcomment_sumcomment_avgview_sumview_avgshare_sumshare_avgcollect_sumcollect_avgfollower_avgaccount_count
querystring선택: 캡션과 대본에서 찾을 키워드
usernamesstring[]선택: 이 TikTok 사용자명만
hashtagsstring[]선택: 이 해시태그를 모두 가진 포스트만
mentionsstring[]선택: 이 사용자명을 모두 멘션한 포스트만
post_typesstring[]선택: 이 형식만값videocarousel
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가 없으면 합계 하나예요
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: 공유와 저장 합계예요. 요청한 경우에만 와요
metrics.follower_avgnumber | null: 작성자 팔로워 수의 평균이에요
metrics.account_countinteger | null: 그룹 안의 서로 다른 계정 수예요
seriesobject[] | null: 기간별 내역이에요. interval을 넣은 경우에만 와요

예시

요청

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

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요.

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

MCP 호출로 쓰면

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

주의사항

view_*는 재생 수예요. share_*와 collect_*는 Instagram과 달리 값이 채워져요.
KR, JP, US, TW의 대략 최근 6개월이에요. 더 오래된 since는 잘려요.

기계가 읽는 형식: /docs/tools/insight-tiktok-content-aggregate.md

개요

파라미터

응답

예시

주의사항

관련 도구