---
title: "SearchPassage"
slug: "common-apidatatype-cssearchpassage"
updated: 2026-04-23T08:55:23Z
published: 2026-04-23T09:02:10Z
---

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

# SearchPassage

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

검색 결과 추출 방식 설정입니다.

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

```JAVA
private String section_name;
private String passage_type;
private String passage_option
private Integer max_length;
```

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

| 필드            | 타입 | 필수 여부            | 설명                  |
|------------------------|--------------------|-----------------|-----------------------|
|    `section_name`     | String       | Required | 결과로 출력할 섹션 지정<ul><li>기존에 생성되어 있는 섹션 중 선택</li></ul> |
|     `passage_type`     | String       | Optional  | Passage 추출 방식  지정<ul><li>`none` \| `classic`<ul><li>`none`: 섹션의 앞 부분부터 읽음</li><li>`classic`: 섹션에서 질의 색인어 주변을 읽음</li></ul></li></ul> |
|     `passage_option`     | String       | Optional | Passage 추출 옵션 지정(CBT 범위 밖)|
|     `max_length`     | Integer       | Optional | Passage 추출 길이 지정|

## 예시 <a name="예시"></a>
검색 요청 시 예시는 다음과 같습니다.

```
{
  "search": {
    "content": {
      "main": {
        "query": "날씨"
      }
    }
  },
  "passage": {
    "TITLE": {
       "passage_type": "classic",
       "passage_option": "mspcnt=1;rmtag=on;",
       "max_length": 400
    },
    "TITLE+BODY": {
       "passage_type": "classic",
       "passage_option": "mspcnt=1;rmtag=on;",
       "max_length": 500
    }
  }
}
```