---
title: "SearchScope"
slug: "common-apidatatype-cssearchscope"
updated: 2026-07-23T09:04:15Z
published: 2026-07-23T09:04:15Z
canonical: "api.ncloud-docs.com/common-apidatatype-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

<p class="platform-info type-classic-vpc">Classic/VPC 환경에서 이용 가능합니다.</p>

제한 검색 설정입니다.

## 구문 <a name="구문"></a>
구문은 다음과 같습니다.

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

## 필드 <a name="필드"></a>
필드에 대한 설명은 다음과 같습니다. 

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

## 예시 <a name="예시"></a>
검색 요청 시 예시는 다음과 같습니다.

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