---
title: "불용어 정책 조회 "
slug: "analytics-cloudsearch-getstopword"
updated: 2026-04-23T08:56:09Z
published: 2026-04-23T09:02:33Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-getstopword"
---

> ## 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(불용어) 정책을 조회합니다.

```http
GET https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/stopword/{rule_name}
```
### Path Variables<a name="PathVariables"></a>

| 파라미터명 | 필수 여부 | 타입   | 제약 사항 | 설명                                   |
|-------------|-----------|--------|----------|----------------------------------------|
| name      | Yes       | string | | 생성되어져 있는 Domain 이름 |
| rule_name      | Yes       | string |  | Stopword 정책 이름 |

## 요청<a name="요청"></a>

### 요청 헤더<a name="요청헤더"></a>

| 파라미터명 | 필수 여부 | 타입   | 제약 사항 | 설명                                   |
|-------------|-----------|--------|----------|----------------------------------------|
| hasWordList | Yes       | boolean | Default: true | 요청 결과에 stopword로 등록된 단어 목록 포함 여부 |

## 응답<a name="응답"></a>

| 필드명     | 필수 여부             | 타입            | 설명                  | 비고           |
|--------------|----------|-----------------|-----------------------|----------------|
| type      | Yes       | string | filter, exact | Stopword 규칙 종류<li>filter: 부분 매칭, 등록한 불용어와 검색어 일부가 일치하면 검색어 중 매칭되는 부분 제거</li><li>exact: 완전 매칭, 등록한 불용어와 검색어가 정확히 일치하면 검색어 중 매칭되는 단어 제거</li> |
| case_sensitive      | Yes       | boolean | true, false | Stopword로 설정할 단어의 대소문자 구분 여부 |
| word_list      | No       | List<string> |  | 정책에 등록된 단어 목록 |
| word_list_length      | Yes       | number |  | 정책에 등록된 단어 개수 |
| rule_name      | Yes       | string |  | Stopword 정책 이름 |


### 응답 Status<a name="응답Status"></a>

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


## 예시<a name="예시"></a>


### 요청 예시<a name="요청예시"></a>

```http
GET /CloudSearch/real/v1/domain/car_beta/stopword/josa HTTP/1.1
Host: cloudsearch.apigw.ntruss.com
x-ncp-iam-access-key: cPMl0CYGgRYvEa8sylCj
x-ncp-apigw-signature-v2: +Ln++MqcKHckKli2y/bB76xLUu8qR9rLvo6j2yIYuYg=
x-ncp-apigw-timestamp: 1551453306138
hasWordList: true
```

### 응답 예시<a name="응답예시"></a>


```json
{
  "type": "filter",
  "word_list": [
    "은",
    "는",
    "이",
    "가",
    "을",
    "를",
    "의"
  ],
  "word_list_length": 7,
  "rule_name": "josa"
}
```