---
title: "자동 완성 검색"
slug: "analytics-cloudsearch-searchautocomplete"
updated: 2026-04-23T08:56:10Z
published: 2026-04-23T09:02:33Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-searchautocomplete"
---

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

# 자동 완성 검색

[자동 완성 설정](/docs/analytics-cloudsearch-putautocomplete) 이후 해당 요청을 사용할 수 있습니다. 요청한 검색어의 자동 완성 색인을 검색합니다. GET, POST 요청을 지원하며, 두 요청이 동일하여 선택적으로 이용할 수 있습니다.

## GET Request

```
GET https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/document/search/autocomplete
```

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 검색 설정이 되어 있는 도메인 | 검색하고자 하는 도메인 이름 |
| type | Yes | string | term, section | 검색하고자 하는 타입 term: 색인 단위의 자동 완성 검색section: 섹션 단위의 자동 완성 검색 |
| query | Yes | string |  | 검색어 |

## 응답

### 응답 바디

| 필드명 | 필수 여부 | 타입 | 설명 | 비고 |
| --- | --- | --- | --- | --- |
| type | Yes | string | 자동 완성 검색 요청 타입 |  |
| item_count | Yes | number | 자동 완성 검색 결과 개수 |  |
| items | Yes | Array[string] | 자동 완성 검색 결과 |  |

### 응답 Status

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

## 예시

### 요청 예시

```
GET /cloudsearch/api/v1/domain/abcdef/document/search/autocomplete?type=section&query=%E3%85%8E HTTP/1.1
Host: cloudsearch.apigw.ntruss.com

x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi
```

### 응답 예시

```
{
  "type": "section",
  "item_count": 1,
  "items": [
    "2018 토요타 캠리 하이브리드"
  ]
}
```

## POST Request

```
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/domain/{name}/document/search/autocomplete
```

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 검색 설정이 되어 있는 도메인 | 검색하고자 하는 도메인 이름 |

### 요청 바디

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| AutocompleteSearchQuery | Yes | [AutocompleteSearchQuery](/docs/common-apidatatype-csautocompletesearchquery) |  | 자동 완성 검색 질의 |

## 응답

### 응답 바디

| 필드명 | 필수 여부 | 타입 | 설명 | 비고 |
| --- | --- | --- | --- | --- |
| type | Yes | string | 자동 완성 검색 요청 타입 |  |
| item_count | Yes | number | 자동 완성 검색 결과 개수 |  |
| items | Yes | Array[string] | 자동 완성 검색 결과 |  |

### 응답 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/abcdef/document/search/autocomplete HTTP/1.1
Host: cloudsearch.apigw.ntruss.com
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi

{
  "query": "ㅎ",
  "type": "term"
}
```

### 응답 예시

```
{
  "type": "term",
  "item_count": 2,
  "items": [
    "현대",
    "하이브리드"
  ]
}
```