---
title: "SearchAggregate"
slug: "common-apidatatype-cssearchaggregate"
updated: 2026-09-17T09:15:48Z
published: 2026-09-17T09:15:48Z
canonical: "api.ncloud-docs.com/common-apidatatype-cssearchaggregate"
---

> ## 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.

# SearchAggregate

<p class="platform-info type-classic-vpc">Classic/VPC 환경에서 이용 가능합니다.</p>

검색 결과 요약 설정입니다.

## 구문 <a name="구문"></a>
구문은 다음과 같습니다.

```JAVA
private String docprop_name;
private List<String> max = new ArrayList<String>();
private List<String> min = new ArrayList<String>();
private String one;
private String sum;
```

## 필드 <a name="필드"></a>
필드에 대한 설명은 다음과 같습니다. 

| 필드            | 타입 | 필수 여부            | 설명                  |
|------------------------|-----------|--------------------|-----------------------|
|     `docprop_name`     | String       | Required | 요약 검색 기준이 되는 문서 속성 지정<ul><li>기존에 [DocProperty](/docs/common-apidatatype-csdocproperty)가 설정되어 있는 섹션 중에서 선택</li></ul>|
|     `max`     | List<String>       | Optional  | 요약 검색의 `max` 연산 대상 지정 |
|     `min`     | List<String>       | Optional |  요약 검색의 `min` 연산 대상 지정|
|     `one`     | String       | Optional | 요약 검색의 `one` 연산 대상 지정|
|     `sum`     | String       | Optional | 요약 검색의 `sum` 연산 대상 지정<ul><li>'_1' 키워드 사용 시에는 요약된 결과의 수를 구함</li></ul> |
   
## 예시 <a name="예시"></a>
검색 요청 시 예시는 다음과 같습니다.

```
{
  "search": {
    "content": {
      "main": {
        "type": "null",
      }
    }
  },
  "aggregate": {
    "dp_like_cnt": {
      "max": ["dp_like_cnt", "dp_dislike_cnt"],
      "min": ["dp_like_cnt", "dp_disklike_cnt"],
      "one": "dp_like_cnt",
      "sum": "_1"
    }
  }
}
```