---
title: "Ranking 목록 조회"
slug: "analytics-cloudsearch-getrankinglist"
updated: 2026-07-23T09:04:32Z
published: 2026-07-23T09:04:32Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-getrankinglist"
---

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

# Ranking 목록 조회

해당 Domain의 전체 Ranking 목록을 조회합니다.

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

## 요청

### 요청 파라미터

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

## 응답

### 응답 바디

| 필드명 | 타입 | 설명 | 비고 |
| --- | --- | --- | --- |
| defaultRanking.name | string | Ranking 이름 |  |
| defaultRanking.code | string | Ranking 수식 |  |
| list | array | Ranking 리스트 |  |
| list[].name | string | Ranking 이름 |  |
| list[].modifyDate | string | 수정된 날짜 | 예시: 2019-03-12 11:43:55 |

### 응답 Status

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

## 예시

### 요청 예시

```
GET /CloudSearch/real/v1/domain/search_test/ranking

Host: cloudsearch.apigw.ntruss.com
haveContainer: false
haveUsage: false
x-ncp-iam-access-key: cPMl0CYGgRYvEa8sylCj
x-ncp-apigw-signature-v2: nn6HxvbYlXzuDBLYG8qNdz4Z7Y6qs+l5EX8BmGwI/EI=
x-ncp-apigw-timestamp: 1551436817715
```

### 응답 예시

```
{
  "defaultRanking": {
    "name": "clous",
    "code": "_ratio=0.5;\n_quality=1.0;\n_similarity=qds;\n_relevance = _similarity * _ratio + _quality * (1 - _ratio); \n\n"
  },
  "list": [
    {
      "name": "clous",
      "modifyDate": "2019-03-12 11:43:55"
    },
    {
      "name": "default",
      "modifyDate": "2019-03-12 11:43:55"
    },
    {
      "name": "test",
      "modifyDate": "2019-09-26 18:00:13"
    },
    {
      "name": "test44",
      "modifyDate": "2019-09-26 21:19:11"
    }
  ]
}
```