---
title: "SearchAggregate"
slug: "common-vapidatatype-cssearchaggregate"
updated: 2026-04-23T08:54:48Z
published: 2026-04-23T09:01:54Z
---

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

Classic/VPC 환경에서 이용 가능합니다.

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

## 구문

구문은 다음과 같습니다.

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

## 필드

필드에 대한 설명은 다음과 같습니다.

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

## 예시

검색 요청 시 예시는 다음과 같습니다.

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