# solari insight tiktok content aggregate

> TikTok 게시물 수를 셀 때 쓰세요.

- **CLI**: `solari insight tiktok content aggregate`
- **MCP 도구**: `solari_insight_tiktok_content_aggregate`
- **권한**: `solari:read`
- **이용 가능 플랜**: 무료 체험 · Plus · Pro · Enterprise
- **크레딧**: 1

SOLARI가 수집하는 TikTok 게시물을 계정, 형식, 해시태그, 언급, 키워드별로 집계합니다.

**언제 쓰나요** — 게시 주기, 해시태그 구성, 평균 재생 수가 필요할 때 쓰세요. 게시물 자체가 필요하면 content search를 쓰세요.

**돌려주는 값** — 그룹별 개수. 큰 순서로 옵니다. 다른 지표는 요청할 때만 옵니다.

## 파라미터

- `region` (enum, 선택, 기본값 "KR") — KR, JP, US, TW 중 하나. 값: `KR`, `JP`, `US`, `TW`.
- `group_by` (enum, 선택) — 개수를 나눌 기준. 값: `account`, `post_type`, `hashtag`, `mention`, `caption_keyword`.
- `interval` (enum, 선택) — 이 달력 단위로 시계열을 함께 가져옵니다. 값: `day`, `week`, `month`.
- `metrics` (string[], 선택) — post_count 말고 더 받을 지표. 값: `like_sum`, `like_avg`, `comment_sum`, `comment_avg`, `view_sum`, `view_avg`, `share_sum`, `share_avg`, `collect_sum`, `collect_avg`, `follower_avg`, `account_count`.
- `query` (string, 선택) — 캡션과 영상 자막에서 찾을 키워드.
- `usernames` (string[], 선택) — 이 TikTok username의 게시물만.
- `hashtags` (string[], 선택) — 이 해시태그가 모두 들어 있는 게시물만.
- `mentions` (string[], 선택) — 이 username을 모두 언급한 게시물만.
- `post_types` (string[], 선택) — 이 형식의 게시물만. 값: `video`, `carousel`.
- `since` (string, 선택, pattern ^\d{4}-\d{2}-\d{2}$) — 이 날짜(UTC, YYYY-MM-DD) 이후에 올라온 게시물만 가져옵니다. 당일 포함.
- `until` (string, 선택, pattern ^\d{4}-\d{2}-\d{2}$) — 이 날짜(UTC, YYYY-MM-DD) 이전에 올라온 게시물만 가져옵니다. 당일 포함.
- `limit` (integer, 선택, 기본값 20, 1–50) — 가져올 그룹 수.

## 응답

### `Response`

- `region` (string) — 집계한 지역.
- `since` (date) — 실제로 적용된 시작일.
- `until` (date | null) — 실제로 적용된 종료일.
- `group_by` (string | null) — 적용된 그룹 기준.
- `interval` (string | null) — 적용된 시간 단위.
- `total_posts` (integer) — 필터에 맞는 게시물 수.
- `truncated` (boolean) — 그룹이 limit보다 많았으면 true.
- `buckets` (object[]) — 그룹 목록. 큰 순서.

### `buckets[]`

- `key` (string) — 그룹 값. group_by를 빼면 전체 합계 하나만 옵니다.
- `metrics.post_count` (integer) — 게시물 수. 항상 옵니다.
- `metrics.like_sum / like_avg` (number | null) — 좋아요 합계와 평균. 요청할 때만 옵니다.
- `metrics.comment_sum / comment_avg` (number | null) — 댓글 합계와 평균. 요청할 때만 옵니다.
- `metrics.view_sum / view_avg` (number | null) — 재생 수 합계와 평균. 요청할 때만 옵니다.
- `metrics.share_sum / collect_sum` (number | null) — 공유 수와 저장 수 합계. 요청할 때만 옵니다.
- `metrics.follower_avg` (number | null) — 작성자 평균 팔로워 수.
- `metrics.account_count` (integer | null) — 그룹에 속한 계정 수(중복 제외).
- `series` (object[] | null) — 기간별 내역. interval을 넣었을 때만 옵니다.

## 예시

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

_읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다._

```json
{
  "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 호출

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

## 주의사항

- view_*는 재생 수입니다. Instagram과 달리 share_*와 collect_*에도 값이 들어 있습니다.
- KR·JP·US·TW 지역의 최근 약 6개월을 다룹니다. since가 그보다 이르면 가장 오래된 날짜로 맞춥니다.

## 관련 도구

- [`solari_catalog_tiktok_content_search`](https://clip-pub.bzine.co/docs/tools/catalog-tiktok-content-search.md?lang=ko)
- [`solari_insight_instagram_content_aggregate`](https://clip-pub.bzine.co/docs/tools/insight-instagram-content-aggregate.md?lang=ko)