---
title: "불용어 정책 설정"
slug: "analytics-cloudsearch-poststopword"
updated: 2026-07-23T09:04:38Z
published: 2026-07-23T09:04:38Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-poststopword"
---

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

# 불용어 정책 설정

입력된 검색어 중에서 의미없는 단어(Stopword, 불용어)를 제거하도록 설정합니다.

- 검색어에 포함된 조사, 접속사 등을 제거할 때 유용하게 사용할 수 있습니다.
- 불용어 정책은 여러 개 생성할 수 있지만, 검색 요청별로 하나의 불용어 정책만 설정이 가능합니다.

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

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string |  | 생성되어져 있는 Domain 이름 |
| rule_name | Yes | string | 영문, "_"로 시작, 영문, 숫자, "_", "-" 허용 최소 3자 최대 20자까지 입력 | 생성할 Stopword 규칙 이름 |

### 요청 바디

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| type | Yes | string | filter, exact | Stopword 규칙 종류filter: 부분 매칭, 등록한 불용어와 검색어 일부가 일치하면 검색어 중 매칭되는 부분 제거exact: 완전 매칭, 등록한 불용어와 검색어가 정확히 일치하면 검색어 중 매칭되는 단어 제거 |
| word_list | Yes | List |  | Stopword로 설정할 단어 목록 |
| case_sensitive | Yes | boolean | true, false | Stopword로 설정할 단어의 대소문자 구분 여부 |

### 응답 Status

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

## 예시

### 요청 예시

```
POST /CloudSearch/real/v1/domain/car_beta/stopword/josa HTTP/1.1
Host: cloudsearch.apigw.ntruss.com
Content-Type: application/json
x-ncp-iam-access-key: cPMl0CYGgRYvEa8sylCj
x-ncp-apigw-signature-v2: +Ln++MqcKHckKli2y/bB76xLUu8qR9rLvo6j2yIYuYg=
x-ncp-apigw-timestamp: 1551462015873

{
  "type": "filter",
  "word_list": [
    "is", "are"
  ],
  "case_sensitive": false
}
```

### 응답 예시

```
{"result":"ok"}
```