---
title: "SearchScope"
slug: "common-vapidatatype-cssearchscope"
updated: 2026-09-17T09:15:37Z
published: 2026-09-17T09:15:37Z
canonical: "api.ncloud-docs.com/common-vapidatatype-cssearchscope"
---

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

# SearchScope

Classic/VPC 환경에서 이용 가능합니다.

제한 검색 설정입니다.

## 구문

구문은 다음과 같습니다.

```
private String scope_target;
private Object option;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `scope_target` | String | Required | 제한 검색 대상 지정 - 기존에 [DocProperty](/docs/common-vapidatatype-csdocproperty)가 설정 되어 있는 섹션 중에서 선택 |
| `option` | Object | Optional | 제한 검색을 설정하는 Map 형태의 Object - key: 제한 검색 방식 선택 - value: 제한 검색 방식에 따른 값 설정 - key 옵션 종류 - `exist`, `nexist`: 지정한 값이 존재하는 문서 속성으로 검색 결과를 제한 - `range`, `nrange`: 지정한 범위의 값이 존재하는 문서 속성으로 검색 결과 제한(`gte:lte`) - `gte`, `gt`, `lte`, `lt`: 지정한 범위의 값이 존재하는 문서 속성으로 검색 결과를 제한 - `gte`: 크거나 같음 - `gt`: 큼 - `lte`: 작거나 같음 - `lt`: 작음 - `bit`, `nbit`: 지정한 비트의 값과 문서 속성을 연산하여 참, 거짓인 경우의 문서로 검색 결과를 제한 - `bitmask`: 지정한 비트의 값과 문서 속성을 `bitmask` 연산하여 참인 경우의 문서로 검색 결과를 제한 |

## 예시

검색 요청 시 예시는 다음과 같습니다.

```
{
  "search": {
    "price": {
      "main": {
        "query": "키보드"
      }
    }
  },
  "scope": {
  "dp_price": {
    "range": ["1000","5000"]
  },
  "dp_color": {
    "exist": "black"
    }
  }
}
```