---
title: "Query Analysis Group By Count"
slug: "analytics-cloudsearch-analysisgroupbycount"
tags: ["Cloud Search"]
updated: 2026-07-23T09:04:32Z
published: 2026-07-23T09:04:32Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-analysisgroupbycount"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Analysis Group By Count

사용된 검색 Query들을 분석하여 field별 Group By 된 Count 집계를 합니다.

- city1: 도시 구분필드1 ex) 서울특별시, 경기도, 충청북도
- city2: 도시 구분필드2 ex) 강남구, 서초, 구로구
- city3: 도시 구분필드2 ex) 역삼동, 정자동, 서초동
- country: 국가
- word: 검색 Query를 형태소분석한 word

```
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/analysis/count_group_by
```

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string |  | 생성되어져 있는 Domain 이름 |

### 요청 바디

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| from | Yes | string |  | 시작 시간(UTC, ex: 20161027T171340Z ) |
| to | Yes | string |  | 종료 시간(UTC, ex: 20161027T171340Z ) |
| groupBy | Yes | [GroupBySchema](/docs/common-apidatatype-csanalysisgroupnyschema) |  | groupBy 설정 |
| aggregate | Yes | [AggregateSchema](/docs/common-apidatatype-csanalysisaggregatebyschema) |  | aggregate 설정 |

## 응답

### Success

```
[
  {
    "key": (string),
    "doc_count": (int),
    "aggregated_result": {
      "sum_other_doc_count": (int),
      "buckets": [
        {
          "key": (string),
          "doc_count": (int),
        }
      ]
    }
  }
]
```

## 응답

| 필드명 | 타입 | 설명 | 비고 |
| --- | --- | --- | --- |
| key | string | Group by 된 결과의 기준 값 |  |
| doc_count | number | 기준 값에 해당하는 모든 값의 합 |  |
| aggregated_result.sum_other_doc_count | number | aggregate 결과가 지정한 max_size 값보다 클 때, 결과에 출력되지 않은 모든 값의 합 |  |
| aggregated_result.buckets[] | array | aggreagte 결과의 key 별 그룹핑 |  |
| aggregated_result.buckets[].key | string | 해당 시간 동안 query에 사용된 field의 값 |  |
| aggregated_result.buckets[].doc_count | string | 해당 시간 동안 query에 사용된 key의 횟수 |  |

### 응답 Status

| Http Status | Desc |
| --- | --- |
| 200 | OK(요청 완료) |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |

## 예시

### 예시1 : field_value가 있는 경우

#### 요청

```
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/car_dev/analysis/count_group_by

POST /CloudSearch/real/v1/domain/car_dev/analysis/count_group_by HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "from": "2019-09-25T05:00:00Z",
  "to": "2019-09-25T15:00:00Z",
  "groupBy": {
    "field": "word",
    "field_value": "현대",
    "max_size": 10
  },
  "aggregate": {
    "field": "city1",
    "max_size": 10
  }
}
```

#### 응답 예시

```
[
  {
    "key": "현대",
    "doc_count": 1,
    "aggregated_result": {
      "sum_other_doc_count": 0,
      "buckets": [
        {
          "key": "경기도",
          "doc_count": 1
        }
      ]
    }
  }
]
```

### 예시2 : field_value가 없는 경우

#### 요청

```
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/car_dev/analysis/count_group_by

POST /CloudSearch/real/v1/domain/car_dev/analysis/count_group_by HTTP/1.1
Host:cloudsearch.apigw.ntruss.com
accept:application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "from": "2019-09-25T05:00:00Z",
  "to": "2019-09-25T15:00:00Z",
  "groupBy": {
    "field": "word",
    "max_size": 10
  },
  "aggregate": {
    "field": "city1",
    "max_size": 10
  }
}
```

#### 응답 예시

```
[
  {
    "key": "class",
    "doc_count": 3117,
    "aggregated_result": {
      "sum_other_doc_count": 357,
      "buckets": [
        {
          "key": "서울특별시",
          "doc_count": 1378
        },
        {
          "key": "경기도",
          "doc_count": 473
        },
        {
          "key": "",
          "doc_count": 300
        },
        {
          "key": "인천광역시",
          "doc_count": 119
        },
        {
          "key": "대구광역시",
          "doc_count": 107
        },
        {
          "key": "부산광역시",
          "doc_count": 104
        },
        {
          "key": "경상북도",
          "doc_count": 83
        },
        {
          "key": "전라북도",
          "doc_count": 69
        },
        {
          "key": "대전광역시",
          "doc_count": 64
        },
        {
          "key": "경상남도",
          "doc_count": 63
        }
      ]
    }
  },
  {
    "key": "bmw",
    "doc_count": 3027,
    "aggregated_result": {
      "sum_other_doc_count": 303,
      "buckets": [
        {
          "key": "서울특별시",
          "doc_count": 1295
        },
        {
          "key": "경기도",
          "doc_count": 515
        },
        {
          "key": "",
          "doc_count": 331
        },
        {
          "key": "인천광역시",
          "doc_count": 127
        },
        {
          "key": "대구광역시",
          "doc_count": 105
        },
        {
          "key": "부산광역시",
          "doc_count": 88
        },
        {
          "key": "경상북도",
          "doc_count": 79
        },
        {
          "key": "대전광역시",
          "doc_count": 63
        },
        {
          "key": "전라북도",
          "doc_count": 63
        },
        {
          "key": "전라남도",
          "doc_count": 58
        }
      ]
    }
  }
]
```