---
title: "SearchSetting"
slug: "common-apidatatype-cssearchsetting"
updated: 2026-07-23T09:04:15Z
published: 2026-07-23T09:04:15Z
canonical: "api.ncloud-docs.com/common-apidatatype-cssearchsetting"
---

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

# SearchSetting

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

검색 시 기타 환경 설정입니다.

## 구문

구문은 다음과 같습니다.

```
private String transfer_timeout;
private String search_timeout;
private String ranking_value;
private String use_df;
private String reuse_term_extractor;
```

## 필드

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `transfer_timeout` | String, Integer | Optional | Transfer 타임아웃 |
| `search_timeout` | String, Integer | Optional | Search 타임아웃 |
| `ranking_value` | String, Boolean | Optional | 결과에 랭킹 변수 값 노출 여부 - `true` (기본값) \| `false` |
| `use_df` | String, Boolean | Optional | idf 값의 사용 여부 - `true` \| `false` |
| `reuse_term_extractor` | String, Boolean | Optional | term_extractor 옵션에서 생성한 텀분석기를 서버에 저장 - `true` \| `false` - `true`: term_extractor 옵션을 줘서 runtime에 만든 텀분석기를 다음 요청에도 사용할 수 있도록 서버에 저장(총 50개까지 저장 가능) - `false`: term_extractor 옵션을 줘서 runtime에 만든 텀분석기를 한번 사용 후 버림. 디폴트 설정 - 해당 옵션은 검색 결과에 영향을 주지 않으며, 성능에 영향을 줌. term_extractor 옵션을 사용해서 검색 쿼리를 만들 예정이라면 실제 트래픽을 받기 전에 해당 옵션을 반드시 켜야 함. 단, 테스트 시에는 텀분석기 최대 숫자인 50개가 넘을 수 있기 때문에 끄고 테스트 해야 함 |

## 예시

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

```
{
    ...,
  "setting": {
    "transfer_timeout": 30,
    "search_timeout": 30,
    "ranking_value": true,
    "use_df": true,
    "reuse_term_extractor": true
  }
}
```