---
title: "Query Analysis Count  "
slug: "analytics-cloudsearch-analysiscount"
tags: ["Cloud Search"]
updated: 2026-10-22T10:46:51Z
published: 2026-10-22T10:46:51Z
canonical: "api-gov.ncloud-docs.com/analytics-cloudsearch-analysiscount"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Query Analysis Count

사용된 검색 Query 들을 분석하여 field 별 Count 집계를 합니다.

- city1: 도시 구분필드1 ex) 서울특별시, 경기도, 충청북도
- city2: 도시 구분필드2 ex) 강남구, 서초, 구로구
- city3: 도시 구분필드2 ex) 역삼동, 정자동, 서초동
- country: 국가
- word: 검색 Query 를 형태소분석한 word

```
POST https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/{name}/analysis/count
```

## 요청

### 요청 파라미터

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

### 요청 바디

| 파라미터 명 | 필수 여부 | 타입 | 제약사항 | 설명 |
| --- | --- | --- | --- | --- |
| from | Yes | string |  | 시작 시간(UTC, ex: 20161027T171340Z ) |
| to | Yes | string |  | 종료 시간(UTC, ex: 20161027T171340Z ) |
| field | Yes | [QueryAnalysisField](/docs/common-apidatatype-csanalysisfieldenum) |  | 집계 field 설정 |
| max_size | Yes | string |  | 가져올 최대 Size |

## 응답

| 필드명 | 타입 | 설명 | 비고 |
| --- | --- | --- | --- |
| key | string | 선택한 field 에 해당하는 값 |  |
| doc_count | number | 선택한 field 의 count |  |

### 응답 Status

| Http Status | Desc |
| --- | --- |
| 200 | OK(요청 완료) |
| 200 | status.code : -1(요청 실패) |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |

## 예시

### 요청 예시 - 'word' Field Count

```
POST https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/real/v1/domain/car_dev/document/search

{
  "from": "2019-09-25T05:00:00Z",
  "to": "2019-09-25T15:00:00Z",
  "field": "word",
  "max_size": 10
}
```

### 응답 예시

```
[
	{
		"key": "class",
		"doc_count": 3117
	},
	{
		"key": "bmw",
		"doc_count": 3027
	},
	{
		"key": "model",
		"doc_count": 2968
	},
	{
		"key": "2019",
		"doc_count": 1585
	},
	{
		"key": "e",
		"doc_count": 1570
	},
	{
		"key": "소나타",
		"doc_count": 1560
	},
	{
		"key": "c",
		"doc_count": 1547
	},
	{
		"key": "2018",
		"doc_count": 1539
	},
	{
		"key": "현대",
		"doc_count": 1534
	},
	{
		"key": "520",
		"doc_count": 1517
	}
]
```