> ## Documentation Index > Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 엔터프라이즈 규칙 및 필터링
## 엔터프라이즈 규칙 및 쿼리 시작하기
엔터프라이즈 연산자를 사용하는 제품은 여러분이 설정한 필터링 규칙에 따라 소셜 데이터를 제공합니다. 규칙은 하나 이상의 ‘절(clause)’로 구성되며, 절은 키워드, 정확한 문구, 또는 다양한 엔터프라이즈 연산자 중 하나입니다. 엔터프라이즈 연산자로 규칙을 만들기 전에 아래에 설명된 구문을 검토하고, 사용 가능한 연산자 목록을 살펴보고, 규칙을 작성할 때 적용되는 제약 사항을 이해해야 합니다. 또한 "[연산 순서](#orderofoperations)" 섹션에서 규칙이 논리적으로 어떻게 평가되는지에 대한 세부 사항도 반드시 이해해야 합니다. 여러 절(clause)을 "and" 및 "or" 논리 모두와 결합할 수 있습니다. **주의:** "and" 논리는 절 사이에 공백을 두어 지정하고, "or" 논리는 대문자 `OR`로 지정합니다.  각 규칙은 최대 2,048자까지 작성할 수 있으며, 긍정 절(일치하거나 필터링 대상으로 포함하려는 항목)과 부정 절(제외하거나 일치시키지 않으려는 항목)의 개수에는 제한이 없습니다.  
### 규칙과 쿼리 만들기
**키워드 매칭** 키워드 매칭은 검색 인터페이스에서의 쿼리와 유사합니다. 예를 들어, 아래의 엔터프라이즈 연산자 규칙은 텍스트 본문에 "social"이라는 용어가 포함된 활동과 매칭됩니다. `social` **공백으로 AND 조건 결합하기** 키워드를 하나 더 추가하는 것은 매칭을 찾기 위한 조건을 하나 더 추가하는 것과 같습니다. 예를 들어, 이 규칙은 텍스트에 "social"과 "media"가 모두 존재하는 활동과만 매칭되며, 순서는 상관없습니다 – *용어 사이에 공백을 두는 것은 불리언 AND 로직으로 동작합니다*. 규칙에 명시적으로 AND를 포함하면, rules endpoint에서 거부됩니다. `social media` **대문자 OR로 OR 조건 사용하기** 하지만 많은 상황에서는 실제로 불리언 OR 로직이 필요합니다. 이것도 쉽게 구현할 수 있습니다. *OR 연산자는 반드시 대문자여야 하며, 소문자 ‘or’는 일반 키워드로 처리됩니다.* `social OR data` **용어 부정하기** 또 다른 시나리오에서는 특정 키워드를 포함한 결과를 제외해야 할 수 있습니다 (불리언 NOT 로직). 예를 들어, 텍스트에 ‘happy’는 포함하지만, ‘birthday’가 포함된 것은 모두 제외하는 경우입니다. `social -personality` **괄호로 그룹화하기** 이러한 유형의 로직은 괄호로 그룹화하여 조합할 수 있으며, 훨씬 더 복잡한 쿼리로 확장할 수 있습니다. `(social OR data) (academic OR research) -personality -information -university` 하지만 이것은 시작에 불과합니다. 위 예시는 키워드에 대한 토큰화된 매칭만 사용하지만, 엔터프라이즈 제품은 텍스트에 대해 다양한 유형의 매칭을 수행할 수 있는 연산자도 제공합니다. **정확 일치** `"social media research"` **부분 문자열 일치** `contains:info` **근접도 일치** `"social media research"~3` 추가로, 다른 연산자를 사용하면 텍스트뿐 아니라 소셜 데이터의 고유한 속성을 기준으로 필터링할 수 있습니다.  **게시물을 작성하는 사용자** `from:XDeveloeprs` **미국 콜로라도주 볼더의 Pearl St.로부터 10마일 이내의 지오태그된 Tweet** `point_radius:[-105.27346517 40.01924738 10.0mi]` **모두 결합하기** 이들은 위에서 설명한 것과 동일한 유형의 로직을 사용해 텍스트 필터와 결합할 수 있습니다. `(social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university`
### 불리언 구문
앞선 섹션의 예제에서는 다양한 유형의 불리언(Boolean) 논리와 그룹화를 사용했습니다. 아래 표에서 각 구문과 요구 사항에 대한 추가 세부 정보를 확인할 수 있습니다. | | | | | :------------- | :---------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Logic type** | **Operator syntax** | Description | | AND | social data | 두 연산자 사이에 공백을 두면 그 사이에는 AND 논리가 적용됩니다.

두 키워드("social", "data")를 모두 포함하는 활동과 일치합니다.

**규칙에서 AND를 명시적으로 사용하지 마십시오. 공백만 사용해야 합니다. AND를 명시적으로 사용하면 일반 키워드로 처리됩니다.** | | OR | social OR data | 두 연산자를 OR로 연결하려면, 두 연산자 사이에 공백으로 둘러싸인 대문자 OR를 삽입합니다.

두 키워드 중 하나("social" 또는 "data")를 포함하는 활동과 일치합니다.

단일 규칙에서 OR와 AND 기능을 함께 사용하는 경우, "[연산 순서](#OrderOfOperations)" 섹션에서 설명한 연산 순서를 이해해야 하며, 아래에서 설명하는 것처럼 규칙이 예상대로 동작하도록 괄호를 사용해 부정되지 않은 연산자들을 함께 그룹화하는 것을 고려해야 합니다.

규칙에서는 반드시 대문자 "OR"을 사용해야 합니다. 소문자 'or'는 일반 키워드로 처리됩니다. | | NOT | social data
-apple -android -phone | 연산자 또는 연산자 그룹 바로 앞에 `-` 문자를 붙입니다.

위의 예시 규칙은 "social" 키워드를 포함하는 활동과는 일치하지만, "data" 키워드를 포함하는 활동은 제외합니다.

규칙이 "firehose에서 부정을 제외한 모든 것"을 요청하는 형태가 되는 부정 OR는 허용되지 않습니다. 예를 들어, `apple OR -ipad`는 "ipad"를 언급하는 활동을 제외한 모든 활동과 일치하게 되므로 유효하지 않습니다. | | Grouping | (social OR data) -XDeveloeprs -api | 여러 연산자를 괄호로 묶으면 하나의 기능적 "그룹"이 생성됩니다.

그룹은 개별 절과 마찬가지로 공백(AND) 또는 OR로 다른 절과 연결할 수 있습니다. 다만, 부정 기호 -를 전체 그룹에 적용하여 부정들을 한꺼번에 그룹화하지 않는 것이 모범 사례라는 점에 유의해야 합니다. 대신, 각 개별 연산자를 부정한 후 공백(AND)으로 이어 붙여야 합니다. 

예를 들어, -(iphone OR imac OR macbook)을 사용하는 대신 다음과 같이 사용해야 합니다: -iphone -imac -macbook

하나의 규칙이 AND와 OR 기능을 모두 결합하는 경우, 규칙을 평가할 때 사용되는 연산 순서 때문에 그룹화가 특히 중요합니다. 자세한 내용은 아래를 참고하십시오. | **주의:** 연산자는 긍정 또는 부정일 수 있습니다. \*\*Positive Operator(긍정 연산자)\*\*는 결과에 **포함하고자 하는** 내용을 정의합니다. 예를 들어 `has:hashtags` 연산자는 “해시태그를 포함하는 활동이 필요하다”는 의미입니다. \*\*Negative Operator(부정 연산자)\*\*는 결과에서 **제외하고자 하는** 내용을 정의하며, 위에서 설명한 Boolean NOT 논리를 사용해 만듭니다. 예를 들어 `-has:hashtags`는 “내 규칙과 일치하더라도, 해시태그를 포함하는 모든 활동을 제외하라”는 의미입니다. Premium 연산자 제품에는 긍정 및 부정 절의 수에 제한이 없으며, 최대 길이 2,048자만 준수하면 됩니다.  
#### 연산 순서
하나의 규칙에서 AND와 OR를 함께 사용할 때는, 아래 연산 순서에 따라 규칙이 평가됩니다. 1. AND 논리로 연결된 연산자가 먼저 결합됩니다 2. 그 다음 OR 논리로 연결된 연산자가 적용됩니다 **예시:** * `apple OR iphone ipad` 는 `apple OR (iphone ipad)` 로 평가됩니다 * `ipad iphone OR android` 는 `(iphone ipad) OR android` 로 평가됩니다 모호성을 없애고 규칙이 의도한 대로 평가되도록 하려면, 적절한 경우 괄호를 사용해 검색어를 함께 묶어 주세요. 예를 들어: * `(apple OR iphone) ipad` * `iphone (ipad OR android)`
#### 문장 부호, 발음 구별 부호, 대소문자 구분
엔터프라이즈 연산자용으로 발음 구별 부호(억양 부호)가 포함된 키워드 또는 해시태그 규칙을 지정하면, 해당 발음 구별 부호를 그대로 반영하여 게시물 텍스트와 일치 여부를 판단합니다(해시태그 또는 키워드). 예를 들어, 키워드 `Diacr**í**tica` 또는 해시태그 `#cumplea**ñ**os` 규칙은 "Diacr**í**tica" 또는 "#cumplea**ñ**os"와는 일치하지만, 물결표가 없는 "Diacritica" 또는 "#cumpleanos"(**í** 또는 **eñe** 없음)와는 일치하지 않습니다. 억양 부호나 발음 구별 부호가 있는 문자는 일반 문자와 동일하게 취급되며, 단어 경계로 간주되지 않습니다. 예를 들어, 규칙이 cumplea**ñ**os인 경우 cumpleaños라는 단어를 포함하는 활동과만 일치하며, cumplea, cumplean 또는 os를 포함하는 활동과는 일치하지 않습니다. 모든 연산자는 대소문자를 구분하지 않고 평가됩니다. 예를 들어, 규칙 `Cat`은 다음 모든 문자열과 일치합니다: "cat", "CAT", "Cat".
#### PowerTrack 규칙 태그
"[Matching rules](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments#matching-rules)" 페이지에서 설명한 것처럼, 각 규칙은 태그와 함께 생성될 수 있습니다. 이러한 태그는 필터링에는 아무런 영향을 미치지 않지만 App 내에서 규칙을 논리적으로 그룹화하는 데 사용할 수 있습니다. 각 규칙에는 태그를 하나만 지정할 수 있으며, 태그의 최대 길이는 255자입니다. 태그는 "Matching rules" 페이지에 설명된 대로 API를 통해 규칙을 생성할 때 JSON 형식의 규칙과 함께 포함됩니다.
#### 규칙을 JSON 형식으로 작성하기
API를 통해 스트림에서 규칙을 추가하거나 삭제하려면 규칙은 JSON 형식을 사용해야 합니다. 기본적으로 각 규칙을 다음 구조에 넣어야 합니다: `{"value":"insert_rule_here"}` **큰따옴표가 포함된 규칙** 규칙에 정확 일치 검색이나 기타 연산자와 함께 사용하는 큰따옴표 문자(`"`)가 포함되는 경우, JSON 구조와 구분하기 위해 역슬래시를 사용해 이 문자를 이스케이프해야 합니다. `"social data" @XDevelopers` JSON 형식의 규칙은 다음과 같습니다: `{"value":"\"social data\" @XDevelopers"}` **큰따옴표 문자열 리터럴이 포함된 규칙** 정확 일치 검색 안에서 큰따옴표 문자를 문자열 리터럴로 포함하려면, 이 문자를 두 번 이스케이프해야 합니다. 예를 들어, "Toys “R” Us"라는 정확한 구, 즉 "R" 주변의 큰따옴표까지 포함해 일치시키는 규칙의 일반 텍스트 표현은 다음과 같습니다: `"Toys \"R\" Us"` 이를 JSON 형식으로 변환하면 다음 구조를 사용해야 합니다: `{"value":"\"Toys \\\"R\\\" Us\""}` **태그가 포함된 규칙** 위에서 설명한 것처럼 규칙에 선택적 태그를 포함하려면 규칙 값과 함께 추가 `tag` 필드를 포함하면 됩니다. `{"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"}` **API 요청을 위한 포맷팅** API를 통해 스트림에서 규칙을 추가하거나 삭제할 때 여러 개의 JSON 형식 규칙은 쉼표로 구분하고, 아래와 같이 JSON `rules` 배열로 감싸야 합니다: `{"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}`
#### 인용 Tweet과 일치하는 연산자
[PowerTrack API](/ko/x-api/enterprise-gnip-2.0/powertrack-api) 및 Historical PowerTrack API를 사용할 때 아래 연산자들은 인용된 원본 게시물과 새 인용 Tweet의 콘텐츠 모두와 매칭됩니다. 반면 [Search API](/ko/x-api/enterprise-gnip-2.0/fundamentals/search-api)를 사용하는 경우, 이러한 연산자들은 인용 Tweet의 콘텐츠에만 매칭되며 인용된 원본 게시물의 콘텐츠에는 매칭되지 않습니다. * `Keywords` * `Phrases` * `Proximity` * `#hashtags` * `@mentions` * `$cashtags` * `url:` * `url_contains:` * `has:links` * `has:mentions` * `has:hashtags` * `has:media` * `has:symbols` * `is:quote` * `is:reply`
## 엔터프라이즈 연산자
아래에는 PowerTrack 및 Historical PowerTrack에서 사용할 수 있는 연산자가 정리되어 있습니다. 이 중 일부는 30일 및 전체 아카이브 검색 API에서도 사용할 수 있습니다. 제품별로 사용 가능한 연산자 목록은 [이 표](/ko/x-api/enterprise-gnip-2.0/fundamentals/rules-filtering#operators-by-product)를 참조하세요.  | 연산자 | 설명 | | :------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 키워드 | 게시물의 텍스트 본문 또는 URL에 포함된 키워드와 일치합니다. 키워드는 숫자(0-9) 또는 문장 부호가 아닌 문자로 시작해야 합니다.
키워드 매칭은 토큰 단위로 이루어지며, 키워드는 게시물 본문을 토큰화한 텍스트와 비교됩니다.
문장 부호가 포함된 문자열(예: "coca-cola")의 경우 따옴표로 감싼 "정확한 구문 일치(exact phrase match)"를 사용하세요.
*예시*: `(social OR pizza OR wildfire) -planet` | | 이모지 | 게시물 본문에 포함된 이모지를 일치시킵니다. 구두점, 기호/이모지, 구분 문자를 기준으로 한 토큰화 기반 매칭을 사용합니다.
이모지에 변형(variant)이 있는 경우, 정확히 일치시키려면 따옴표를 사용하세요.
*예시*: `(🍕 OR 💜 OR 🐢) -🤖` | | "정확한 구문 일치" | 게시물 본문에서 정확히 일치하는 구를 검색합니다. 문장 부호는 공백으로 취급됩니다.
*예시*: `("social media" OR "developer.x.com" OR "wildfire911" OR "coca-cola") -"planet earth"` | | # | 지정된 해시태그가 포함된 모든 게시물과 일치합니다. 이는 정확 일치이므로 `#2016`은 `#2016`이 포함된 포스트와는 일치하지만 `#2016election`이 포함된 포스트와는 일치하지 않습니다.
*예시*: `(#social OR #pizza OR #2016election) -#planet` | | @ | 지정된 사용자 이름이 언급된 모든 게시물과 일치합니다.
*예시*: `(@XDevelopers OR @api OR @twittereng) -@jack` | | "keyword1 keyword2"\~N | 키워드가 서로 N개의 토큰 이내에 있을 때 해당 게시물을 매칭하는 근접 연산자입니다.
역순으로 나타나는 키워드는 서로 최대 N-2개의 토큰까지 떨어져 있을 수 있습니다. N은 6을 초과할 수 없습니다.
*예시*: `"social media"~5 OR "API"~3` | | contains: | 토큰화 여부와 관계없이, 본문에 지정한 부분 문자열이 포함된 포스트를 매칭합니다.
공백이나 문장 부호가 포함된 부분 문자열에는 큰따옴표를 사용하세요.
*예시*: `(contains:social OR contains:"wikipedia.com") -contains:"buy now"` | | from: | 특정 사용자가 작성한 게시물 중 X 계정의 숫자 ID 또는 사용자 이름(앞의 `@` 제외)이 일치하는 모든 게시물에 매칭됩니다.
*예시*: `(from:2244994945 OR from:api OR from:twittereng) -from:jack` | | to: | X 숫자 계정 ID 또는 사용자 이름(`@` 제외)으로 특정 사용자에게 답글로 작성된 모든 게시물과 일치합니다.
*예시*: `(to:2244994945 OR to:api OR to:twittereng) -to:jack` | | url: | 게시물의 확장된 URL에 대해 토큰화된(키워드/문구) 기반으로 일치를 수행합니다.
*예시*: `@XDevelopers url:"developer.x.com"` | | url\_title: | 확장된 URL의 HTML title 메타데이터에서 키워드/구문을 기준으로 매칭을 수행합니다.
*PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다.* | | url\_description: | 확장된 페이지 설명 메타데이터에서 키워드/구문 일치를 수행합니다.
*PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다.* | | url\_contains: | 지정된 구 또는 키워드를 포함하는 URL을 가진 포스트를 매칭합니다.
문장 부호가 포함된 검색어는 따옴표로 감싸세요.
*예시*: `(url_contains:"developer.x.com" OR url_contains:wildfire) -url_contains:reddit` | | bio: | 게시물 작성자의 사용자 bio에서 키워드나 구를 검색합니다. [User object](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-user-object)의 'description' 필드를 토큰 단위로 검색합니다.
*예시*: `(bio:engineer OR bio:"wordpress.com" OR bio:🚀) -bio:troll`
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | bio\_name: | 게시물의 사용자 프로필 이름에 포함된 키워드를 매칭합니다. 이는 [User object](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-user-object)의 사용자의 "name" 필드에 대해 토큰화된 매칭을 수행합니다.
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | bio\_location: | User object의 location에 지정된 키워드나 구문이 포함된 포스트와 일치시킵니다.
이 연산자는 메시지 본문에 대한 일반 키워드 규칙과 유사하게 토큰화된 방식으로 일치시킵니다.
이 location은 [User object](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-user-object)의 일부이며, 계정의 'home' 위치(기본 위치)를 나타냅니다.
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | statuses\_count: | 작성자가 게시한 statuses 수가 지정된 범위에 해당하는 포스트를 일치시킵니다.
단일 숫자를 지정하면, 그 숫자 이상인 모든 값이 일치합니다.
범위를 지정하면 해당 범위에 포함되는 모든 값이 일치합니다(예: `statuses_count:1000..10000`).
*예시:* `to:api statuses_count:10`
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | followers\_count: | 작성자의 팔로워 수가 지정된 범위에 해당할 때 포스트와 일치합니다.
단일 숫자를 지정하면 그 숫자 이상인 경우 모두 일치합니다.
범위를 지정하여 해당 범위 내의 어떤 숫자든 일치하도록 할 수 있습니다(예: `followers_count:1000..10000`).
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다. | | friends\_count: | 작성자의 friends 수(해당 작성자가 팔로우하는 사용자 수)가 지정된 범위 내에 있을 때 포스트와 일치합니다.
단일 숫자를 지정하면 해당 숫자 이상인 모든 값이 일치합니다.
범위를 지정하면 해당 범위 내의 모든 숫자가 일치합니다(예: `friends_count:1000..10000`).
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | listed\_count: | 작성자가 X 내에서 리스트에 포함된 횟수가 지정된 범위에 있을 때 해당 포스트와 일치시킵니다.
단일 숫자를 지정하면, 해당 숫자 이상인 모든 값이 일치합니다.
범위를 지정하면, 해당 범위 내의 모든 숫자가 일치합니다(예: `listed_count:10..100`).
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | \$ | 지정된 ‘캐시태그’ 엔티티를 포함하는 모든 게시물과 일치합니다.
*예시*: `($TWTR OR $TSLA OR $BRK.A) -$F`
*참고:* 캐시태그 연산자는 캐시태그를 찾기 위해 게시물 본문에서 직접 추출하는 대신 X의 ‘symbols’ 엔티티 추출 결과에 의존합니다. | | retweets\_of: | 지정한 사용자의 리포스트인 포스트와 일치합니다.
사용자 이름과 숫자로 된 X 계정 ID를 모두 허용합니다(Post status ID는 아님).
*예시*: `(retweets_of:2244994945 OR retweets_of:api OR retweets_of:twittereng) -retweets_of:jack` | | retweets\_of\_status\_id: | 지정된 게시물의 명시적인 리트윗만 전달합니다. 리트윗이 아닌 원본 게시물의 ID를 사용하세요.
*예시*: `retweets_of_status_id:1293593516040269825`
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용 가능합니다. | | in\_reply\_to\_status\_id: | 지정된 게시물에 대한 직접 답글만 전달합니다.
*예시*: `in_reply_to_status_id:1293593516040269825`
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | sample: | 규칙과 일치하는 포스트의 무작위 샘플을 반환합니다. 샘플 비율은 1에서 100 사이의 정수여야 합니다.
이 연산자는 범위를 X%로 줄인 다음, 해당 샘플링된 하위 집합에 규칙/필터를 적용합니다.
*예:* `#happybirthday sample:5`
`"happy birthday"~5 sample:80`
*참고:* PowerTrack 및 Historical PowerTrack에서만 사용할 수 있습니다. | | source: | 지정된 소스 애플리케이션에서 생성된 모든 게시물과 일치합니다. 값으로는 애플리케이션 이름이나 애플리케이션의 URL을 사용할 수 있습니다.
*예시:* `#happybirthday source:"X for iPhone"`
`"This is a test X from my TestingApp" source:MyTestAppName`
*참고:* source 연산자는 게시물의 source 속성을 기준으로 검색하며 단독으로는 사용할 수 없습니다. | | lang: | X에서 특정 언어로 분류한 포스트와 일치합니다. 현재 포스트는 하나의 언어로만 분류되므로 여러 언어를 동시에 지정하면 결과가 나오지 않습니다. *단독으로 사용하는 것은 권장되지 않습니다.* | 아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 나타냅니다: | | | | | | :--------- | :--------------- | :------------- | :------------- | | 암하라어: am | 독일어: de | 말라얄람어: ml | 슬로바키아어: sk | | 아랍어: ar | 그리스어: el | 디베히어: dv | 슬로베니아어: sl | | 아르메니아어: hy | 구자라트어: gu | 마라티어: mr | 소라니 쿠르드어: ckb | | 바스크어: eu | 아이티 크리올어: ht | 네팔어: ne | 스페인어: es | | 벵골어: bn | 히브리어: iw | 노르웨이어: no | 스웨덴어: sv | | 보스니아어: bs | 힌디어: hi | 오리야어: or | 타갈로그어: tl | | 불가리아어: bg | 로마자 힌디어: hi-Latn | 펀자브어: pa | 타밀어: ta | | 버마어: my | 헝가리어: hu | 파슈토어: ps | 텔루구어: te | | 크로아티아어: hr | 아이슬란드어: is | 페르시아어: fa | 태국어: th | | 카탈란어: ca | 인도네시아어: in | 폴란드어: pl | 티베트어: bo | | 체코어: cs | 이탈리아어: it | 포르투갈어: pt | 중국어(번체): zh-TW | | 덴마크어: da | 일본어: ja | 루마니아어: ro | 터키어: tr | | 네덜란드어: nl | 칸나다어: kn | 러시아어: ru | 우크라이나어: uk | | 영어: en | 크메르어: km | 세르비아어: sr | 우르두어: ur | | 에스토니아어: et | 한국어: ko | 중국어(간체): zh-CN | 위구르어: ug | | 핀란드어: fi | 라오어: lo | 신드어: sd | 베트남어: vi | | 프랑스어: fr | 라트비아어: lv | 싱할라어: si | 웨일스어: cy | | 조지아어: ka | 리투아니아어: lt | | | 예: (@XDevelopers OR to:XDevelopers) lang:es **Note:** language 연산자는 X가 판별하여 게시물의 `lang` 속성으로 설정한 특정 게시물 언어와 일치합니다. X Entities JSON 속성에 대한 자세한 내용은 [HERE](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary)를 참고하세요. 어떤 게시물에 대해서도 언어 분류를 할 수 없는 경우, 해당 게시물의 lang 값은 ‘und’(미정)로 설정됩니다. | 연산자 | 설명 | | :------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | place | 지정된 위치 또는 X place ID가 태그된 포스트와 일치합니다.
두 단어 이상으로 이루어진 장소 이름은 따옴표로 묶어야 합니다.
*예:* `(place:London OR place:"Great Britain") -place:USA`
`place:fd70c22040963ac7`
**참고:** X place ID를 얻는 방법은 [GET geo/search](https://developer.x.com/en/docs/x-api/v1/geo/places-near-location/api-reference/get-geo-search) 공개 API 엔드포인트를 참조하세요.
**참고:** 리트윗(Retweets) 또는 인용 트윗(Quote Tweets)에는 일치하지 않습니다. 리트윗의 장소 정보(place)는 원본 포스트에 연결되어 있기 때문입니다. | | place\_country | 태그가 지정된 장소/위치에 연관된 국가 코드가 지정한 ISO alpha-2 문자 코드와 일치하는 포스트와 매치됩니다.
*예:* `place_country:GB OR place_country:AU OR place_country:CA`
**참고:** 리포스트나 인용 포스트에는 매치되지 않습니다. 리포스트의 장소 정보는 원본 게시물에 연결되어 있기 때문입니다.
유효한 ISO 코드: [ISO 3166-1 alpha-2](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). | | point\_radius:\[경도 위도 반경] | 게시물의 정확한 위치(x,y 좌표) 또는 정의된 반경 내의 “Place” 지오 폴리곤과 매칭합니다.
\* 반경: \< 25mi
\* 지원 단위: mi, km
\* 경도: ±180
\* 위도: ±90
좌표는 십진수 도(degree) 단위를 사용합니다.
인수는 대괄호로 감싸고 공백으로 구분합니다.
*예시:* `point_radius:[-105.27346517 40.01924738 0.5mi]`
*예시:* `point_radius:[2.355128 48.861118 16km]`
**참고:** Retweet 또는 Quote Tweet에는 매칭되지 않습니다. | | bounding\_box:\[서쪽\_경도 남쪽\_위도 동쪽\_경도 북쪽\_위도] | 정확한 위치(Exact Location) 또는 경계 상자 안에 완전히 포함된 “Place” 지오 폴리곤과 일치합니다.
인수는 대괄호로 묶고 공백으로 구분합니다.
좌표: 십진수 도(경도 ±180, 위도 ±90).
너비와 높이는 25mi 미만이어야 합니다.
*예:* `bounding_box:[-105.301758 39.964069 -105.178505 40.09455]`
**참고:** 리트윗(Retweet)이나 인용 트윗(Quote Tweet)에는 일치하지 않습니다. | | profile\_country | 작성자의 프로필 위치 정보에 포함된 국가 코드가 지정한 ISO-3166-1 alpha-2 형식의 2글자 코드와 일치하는 포스트를 매칭합니다. | | profile\_region | 작성자의 프로필 geo enrichment 중 “region” 필드 값이 지정한 문자열과 전체가 정확히 일치하는 경우에만 매칭합니다.
공백이나 문장 부호가 포함된 부분 문자열에는 큰따옴표를 사용하세요.
*예:* `profile_region:"New York"` | | profile\_locality | 작성자의 프로필 위치 정보 보강에서 “locality” 필드와 일치하는 항목으로, 전체 문자열과의 정확한 일치만 허용합니다.
공백이나 문장 부호가 포함된 부분 문자열에는 큰따옴표를 사용하세요.
*예:* `profile_locality:"San Francisco"` | | profile\_subregion | 작성자의 프로필 geo enrichment의 “subRegion” 필드 값과 일치하며, 특정 카운티나 대도시권을 포함합니다.
전체 문자열이 정확히 일치해야 합니다.
*예:* `profile_subregion:"Santa Clara County"` | | has:geo | X에서 제공하는 게시물별 지리 위치 데이터가 있는 포스트와 일치하며, 여기에는 “geo” 위도/경도 또는 표시 이름과 지리 폴리곤을 포함하는 “Place” 위치 데이터가 포함됩니다.
**참고:** Search API를 사용할 때는 `is:` 또는 `has:`가 아닌 다른 연산자와 함께 조합해야 합니다. | | has:profile\_geo | 값과 상관없이 Profile Geo 메타데이터가 있는 포스트를 모두 매칭합니다.
사용 가능한 별칭: `has:derived_user_geo`.
**참고:** Search API에서 사용할 때는 `is:` 또는 `has:`가 아닌 연산자와 반드시 함께 사용해야 합니다. | | has:links | 미디어와 인용 Tweet을 포함하여, 페이로드의 "text" 객체에 링크 또는 참조된 미디어가 있는 포스트와 일치합니다.
**참고:** Search API와 함께 사용할 때는 `is:` 또는 `has:`가 아닌 연산자와 조합해서 사용해야 합니다. | | is:retweet | 명시적인 리트윗만 반환합니다.
부정하여 리트윗을 제외하고 원본 콘텐츠만 반환할 수 있습니다.
이 연산자는 인용 Tweet이 아닌 실제 Retweet만을 대상으로 합니다.
**참고:** Search API와 함께 사용할 때는 `is:`나 `has:`가 아닌 다른 연산자와 함께 사용해야 합니다. | | is:reply | 명시적인 답글만 제공합니다. 부정형으로 사용하면 답글을 제외할 수 있습니다.
PowerTrack은 원본 포스트에 대한 답글, 인용된 포스트에 달린 답글, 리트윗에 달린 답글을 모두 매칭합니다.
Search API는 원본 포스트에 대한 답글만 매칭합니다.
*예시:* `@XDevelopers -is:reply` | | is:quote | 다른 게시물을 참조하는 Quote Tweet 또는 포스트만 제공합니다.
이 연산자에 부정을 사용하면 Quote Tweet을 제외할 수 있습니다.
*예:* `@XDevelopers is:quote` | | is:verified | 인증된 작성자가 작성한 포스트만 반환합니다. 부정 연산자로 사용하면 인증된 작성자의 포스트를 제외할 수 있습니다.
*예시:* `@XDevelopers is:verified` | | has:mentions | 다른 X 사용자를 언급하는 포스트와 일치합니다.
**참고:** Search API를 사용할 때는 `is:` 또는 `has:`가 아닌 연산자와 함께 사용해야 합니다. | | has:hashtags | 해시태그가 포함된 포스트와 일치합니다.
**참고:** Search API를 사용할 때는 `is:` 또는 `has:`가 아닌 연산자와 함께 조합해야 합니다. | | has:media | X에서 분류한 미디어 URL이 포함된 포스트와 일치합니다(예: pic.x.com).
사용 가능한 별칭: `has:media_link`.
**참고:** Search API를 사용할 때는 `is:` 또는 `has:`가 아닌 다른 연산자와 함께 사용해야 합니다. | | has:images | 미디어 URL이 포함된 포스트와 일치합니다(예: pic.x.com).
**참고:** Search API와 함께 사용할 때는 `is:` 또는 `has:`가 아닌 다른 연산자와 함께 조합해야 합니다. | | has:videos | X에 직접 업로드된 네이티브 X 동영상이 포함된 포스트와 일치합니다.
사용 가능한 별칭: `has:video_link`.
이 연산자는 YouTube, Periscope 또는 기타 동영상 호스팅 서비스의 동영상과는 일치하지 않습니다.
**참고:** Search API와 함께 사용할 때는 `is:` 또는 `has:`가 아닌 다른 연산자와 함께 사용해야 합니다. | | has:symbols | 캐시태그 기호(예: \$TWTR)를 포함하는 포스트와 일치합니다.
**참고:** Search API에서 사용할 때는 `is:` 또는 `has:`가 아닌 다른 연산자와 함께 사용해야 합니다. |
## 제품별 연산자
### 규칙 및 필터링: 엔터프라이즈
모든 엔터프라이즈 연산자는 PowerTrack 및 Historical PowerTrack API에서 사용할 수 있습니다. 다만, 이 페이지에 설명된 대로 엔터프라이즈 Search API에서는 일부 연산자만 사용할 수 있습니다. 짙은 파란색 태그는 엔터프라이즈 제품별로 어떤 연산자를 사용할 수 있는지를 나타냅니다: PowerTrack Search | 연산자 | 제품 | 설명 | 일치하는 페이로드 필드 | | :-------------------------------------------------------------------- | :------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------- | | 정확한 구문 일치 | PowerTrack

검색 | 게시물 본문에서 정확한 문구를 매치합니다.

검색 연산자로 해석될 수 있는 구성 요소는 단어로 취급됩니다. 다시 말해서:

\* `"#hashtag"`는 `hashtag`에는 매치되지만 `#hashtag`에는 매치되지 않습니다(실제 해시태그에 매치하려면 큰따옴표 없이 [hashtag operator](#hashtag-operator)를 사용하세요). 
\* `"$TWTR"`는 단어 `TWTR`에는 매치되지만 캐시태그 `$TWTR`에는 매치되지 않습니다(실제 캐시태그에 매치하려면 큰따옴표 없이 [cashtag operator](#cashtag-operator)를 사용하세요).

**참고:** 30 Day Search 및 Full Archive Search(Enterprise 및 Premium)에서는 구두점 문자가 토큰화되지 않고 공백과 동일하게 취급됩니다. | `text` | | @ | PowerTrack

Search | 지정한 사용자 이름을 멘션한 모든 게시물과 일치합니다. 값은 사용자 이름(문자 `@`는 제외)이나 사용자의 숫자 ID(예를 들어 [GET users/lookup](https://developer.x.com/en/docs/x-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-lookup) 엔드포인트를 통해 얻을 수 있는 값)일 수 있습니다. | `entities.user_mentions` | | # | PowerTrack

Search | 지정한 해시태그가 포함된 모든 게시물과 일치합니다.

이 연산자는 정확히 일치하도록 동작합니다. 예를 들어 규칙 `#1989`는 정확히 `#1989` 해시태그를 포함하는 포스트와는 일치하지만, `#TaylorSwift1989` 해시태그를 포함하는 포스트와는 일치하지 않습니다.

**참고:** 이 연산자는 본문에서 직접 해시태그를 추출하는 대신, 해시태그를 일치시키기 위해 X의 엔터티 추출 기능에 의존합니다. 엔터티의 JSON 속성에 대한 자세한 내용은 [X Entities](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary)를 참조하세요. | `entities.hashtags` | | \$ | PowerTrack

Search | 지정된 캐시태그(토큰의 첫 문자가 `$`인 경우)가 포함된 모든 게시물과 일치합니다.

**참고:** 이 연산자는 본문에서 직접 링크를 추출하는 대신, 링크를 매칭하기 위해 X의 엔터티 추출 기능에 의존합니다. 엔터티의 JSON 속성에 대한 자세한 내용은 [X Entities](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary)를 참조하세요. | `entities.symbols` | | bio: | PowerTrack | *사용 가능한 별칭*: user\_bio:

게시물 작성자의 소개(bio) 안에서 키워드(토큰화된 매칭 사용)나 구를 일치시킵니다. 구를 일치시키려면 큰따옴표를 사용하세요. 예를 들어:

\* `bio:software engineer`는 bio에 `software`라는 단어가 있는 사용자 중에서 키워드 `engineer`가 포함된 포스트와 일치합니다
\* `bio:"software engineer"`는 bio에 `software engineer`라는 구가 있는 사용자가 게시한 모든 포스트와 일치합니다 | `user``.description` | | bio\_location: | PowerTrack | *사용 가능한 별칭*: user\_bio\_location:

[User object](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-user-object)의 location에 지정된 키워드(토큰화된 일치 방식을 사용) 또는 구가 포함된 포스트와 일치합니다.

이 location은 사용자가 임의로 입력한 비정규화 자유 형식 문자열이며, 포스트의 location(사용 가능한 경우)과는 다릅니다. | `user.location` | | bio\_name: | PowerTrack | [User object](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-user-object)의 name 필드에 지정한 키워드(토큰화 매칭 사용) 또는 문구가 포함된 포스트를 매칭합니다. | `user.name` | | bounding\_box: | PowerTrack

Search | *사용 가능한 별칭*: geo\_bounding\_box:

게시물에 정확한 위치(경도, 위도)가 있는 경우 해당 위치와, Place가 정의된 영역 내에 완전히 포함되는 지오 폴리곤에 대해 매칭합니다.

\* west\_long과 south\_lat는 경계 상자의 남서쪽 꼭짓점을 나타내며, west\_long은 그 지점의 경도, south\_lat는 위도입니다.
\* east\_long과 north\_lat는 경계 상자의 북동쪽 꼭짓점을 나타내며, east\_long은 그 지점의 경도, north\_lat는 위도입니다.
\* 경계 상자의 너비와 높이는 25마일 미만이어야 합니다.
\* 경도(longitude)는 ±180 범위 내여야 합니다.
\* 위도(latitude)는 ±90 범위 내여야 합니다.
\* 모든 좌표는 십진수 도(decimal degrees) 단위입니다.
\* 규칙 인수는 대괄호로 묶고 공백으로 구분합니다.

**참고:** place(게시물 geo)에 대해 매칭하는 연산자는 원본 포스트만 일치 대상으로 포함합니다. 리포스트에는 place 데이터가 포함되지 않습니다. | `place` (원본 포스트에만 해당) | | contains: | PowerTrack | 토큰화 여부와 관계없이, 본문에 지정된 부분 문자열을 포함하는 포스트에 대해 부분 문자열 일치 검색을 수행합니다. 즉, 단어 경계를 고려하지 않고 순수한 부분 문자열 일치만 수행합니다.

공백이나 문장 부호가 포함된 부분 문자열을 일치시키려면 쌍따옴표를 사용하세요. | `text` | | \ | PowerTrack

Search | 게시물 본문에 포함된 이모지를 매칭합니다.

이 연산자는 토큰 단위로 매칭을 수행하므로, 사용한 이모지는 게시물 본문을 토큰화한 텍스트와 비교됩니다. 토큰화는 문장 부호, 기호/이모지, 그리고 구분자 역할을 하는 유니코드 기본 평면 문자들을 기준으로 수행됩니다. 예를 들어, “I like 🍕”라는 텍스트를 가진 게시물은 I, like, 🍕라는 토큰들로 분리됩니다. 그런 다음 이 토큰들을 규칙에서 사용한 이모지와 비교합니다.

**참고:** 이모지에 변형(variant)이 있는 경우, 해당 이모지를 규칙에 추가하려면 큰따옴표로 감싸서 사용해야 합니다. | `text` | | followers\_count: | PowerTrack | 작성자의 팔로워 수가 지정한 범위에 있는 포스트를 매치합니다.

\* 단일 숫자(예: `followers_count:42`)는 지정한 값 이상인 모든 값을 매치합니다.
\* 범위(예: `followers_count:42..1337`)는 지정한 범위에 포함되는 모든 값을 매치합니다. | `user.followers_count` | | friends\_count: | PowerTrack | *사용 가능한 별칭*: following\_count:

작성자의 friends 수(팔로우하는 사용자 수)가 지정된 범위에 속하는 포스트와 일치합니다.

\* 단일 숫자(예: `followers_count:42`)는 지정한 값 이상인 모든 숫자와 일치합니다.
\* 범위(예: `followers_count:42..1337`)는 해당 범위에 포함되는 모든 숫자와 일치합니다. | `user.friends_count` | | from: | PowerTrack

Search | 특정 사용자가 작성한 모든 게시물을 매칭합니다. 값으로는 사용자 이름( `@` 문자는 제외) 또는 사용자의 숫자형 id(예: [GET users/lookup](https://developer.x.com/en/docs/x-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-lookup) 엔드포인트를 통해 조회)를 사용할 수 있습니다. | `user.id`, `user.id_str` (사용자 ID를 사용하는 경우)

`user.screen_name` (username을 사용하는 경우) | | has:geo | PowerTrack

Search | X에서 제공하는, 게시물에 특화된 지리적 위치 데이터를 포함하는 포스트와 일치합니다. 이는 “geo” 위도/경도 좌표이거나, 해당 표시 이름, 지오 폴리곤 및 기타 필드를 포함하는 X의 [Place](https://dev.x.com/overview/api/places) 객체 형태의 “location”일 수 있습니다.

단독 연산자로는 사용할 수 없습니다.

**참고:** place(게시물 geo)에 대해 매칭을 수행하는 연산자는 원본 포스트에서만 일치 항목을 포함합니다. 리트윗에는 place 데이터가 포함되지 않습니다. | `place` (원본 Tweet에만 적용) | | has:hashtags | PowerTrack

Search | 하나 이상의 해시태그를 포함하는 포스트와 일치합니다.

단독 연산자로는 사용할 수 없습니다. | `entities.hashtags` | | has:images | PowerTrack

Search | 하나 이상의 분류된 이미지 URL을 포함하는 포스트와 일치합니다.

단독으로는 사용할 수 없습니다. | `entities.media` | | has:lang | PowerTrack | X에서 특정 언어로 분류한 포스트와 일치시킵니다.

포스트가 분류되지 않은 경우 이 연산자로는 매치되지 않습니다. 각 포스트는 현재 하나의 언어로만 분류되므로 여러 언어를 AND 조건으로 함께 사용하면 결과가 나오지 않습니다.

단독 연산자로는 사용할 수 없습니다. | `und`가 아닌 값을 가진 `lang` | | has:links | PowerTrack

Search | 이 연산자는 포스트 본문에 링크가 포함된 포스트를 매칭합니다.

단독 연산자로는 사용할 수 없습니다.

**참고:** 이 연산자는 본문에서 직접 링크를 추출하는 대신, 링크를 매칭하기 위해 X의 엔터티 추출 기능에 의존합니다. 엔터티의 JSON 속성에 대한 자세한 내용은 [X Entities](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary)를 참조하세요. | `entities.urls` | | has:media | PowerTrack

Search | *사용할 수 있는 별칭*: has:media\_link

하나 이상의 분류된 미디어 URL을 포함하는 포스트와 일치합니다.

단독 연산자로는 사용할 수 없습니다. | `entities.media` | | has:mentions | PowerTrack

Search | 다른 X 사용자를 멘션한 포스트와 일치합니다.

단독 연산자로는 사용할 수 없습니다. | `entities.user_mentions` | | has:profile\_geo | PowerTrack

Search | *사용 가능한 별칭*: has:derived\_user\_geo

실제 값과 관계없이 [Profile Geo](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments#profile-geo) 메타데이터가 포함된 포스트와 매칭됩니다.

단독 연산자로는 사용할 수 없습니다. | `user.location` | | has:symbols | PowerTrack

Enterprise | 캐시태그 기호(예: `$TWTR`)를 포함하는 포스트를 매칭합니다.

단독 연산자로는 사용할 수 없습니다. | `entities.symbols` | | has:videos | PowerTrack

Search | *사용 가능한 별칭*: has:video\_link

하나 이상의 분류된 미디어 URL을 포함하는 포스트를 매치합니다.

단독 연산자로는 사용할 수 없습니다. | `entities.media` | | in\_reply\_to\_status\_id: | PowerTrack | *사용 가능한 별칭*: in\_reply\_to\_tweet\_id:

지정된 게시물에 대한 명시적인 답글만 전달합니다. | 대상 게시물의 `id` 및 `id_str` | | is:quote | PowerTrack | 규칙과 일치하는 명시적인 Quote Tweet만 전달합니다.

또한 부정형 (`-is:quote`)으로 사용하여 규칙과 일치하는 Quote Tweet을 전달 대상에서 제외할 수 있습니다.

단독 연산자로는 사용할 수 없습니다. | `is_quote_status`가 `true`인 경우 | | is:reply | PowerTrack

Search | 규칙과 일치하는 답글만 전달합니다.

또한 `-is:reply`를 사용해 부정형으로 지정하면, 지정된 규칙과 일치하는 답글은 전달에서 제외할 수 있습니다.

PowerTrack에서 이 연산자는 다음에 대해 일치합니다:

\* 원본 게시물에 대한 답글
\* 인용된 포스트 안의 답글
\* 리트윗 안의 답글


Search API와 함께 사용할 때 이 연산자는 원본 게시물에 대한 답글에는 일치하지만, 인용된 Tweet 안의 답글과 리트윗 안의 답글은 제외합니다.

원본 게시물에 대한 답글만 전달하려면 이 연산자를 `is:retweet`, `is:quote`와 함께 사용할 수 있습니다.

Search API에서는 단독 연산자로 사용할 수 없습니다.

**참고**: Premium에서는 이 연산자를 Sandbox 개발 환경에서 사용할 수 없습니다. | 답글 관련 요소(예: `in_reply_to_status_id`) | | is:retweet | PowerTrack

Search | 규칙과 일치하는 명시적인 리트윗만 전달합니다.

이 연산자는 부정형(`-is:retweet`)으로도 사용할 수 있으며, 규칙과 일치하는 리트윗을 전달 대상에서 제외하여 원본 콘텐츠만 전달되도록 할 수 있습니다.

이 연산자는 실제 리트윗(즉, 리트윗 버튼을 사용해 게시된 리트윗)만을 찾습니다. 인용 Tweet 및 X의 리트윗 기능을 사용하지 않은 수정된 포스트는 이 연산자와 일치하지 않습니다.

단독 연산자로는 사용할 수 없습니다. | 리트윗 요소, 예: `retweeted_status` | | is:verified | PowerTrack

Search | X에서 인증된 작성자의 포스트만 전달합니다.

또한 부정하여 인증된 작성자의 포스트를 제외할 수도 있습니다.

단독 연산자로는 사용할 수 없습니다. | `user.verified` | | keyword | PowerTrack

Search | 게시물 본문에 포함된 키워드를 매치합니다.

이는 토큰 단위 매치로, 사용자가 지정한 키워드 문자열을 게시물 본문의 토큰화된 텍스트와 비교해 일치 여부를 확인한다는 의미입니다. 토큰화는 문장 부호, 기호/이모지, 구분자에 해당하는 유니코드 기본 평면 문자를 기준으로 수행됩니다. 예를 들어 텍스트가 “I like coca-cola”인 게시물은 다음과 같은 토큰으로 분리됩니다: `I`, `like`, `coca`, `cola`. 그런 다음 이 토큰들이 규칙에서 사용한 키워드 문자열과 비교됩니다. 문장 부호(예: coca-cola), 기호 또는 구분자 문자가 포함된 문자열을 매치하려면 [exact phrase match](#exact-match) 연산자를 사용해야 합니다. | `text` | | lang: | PowerTrack

Search | X에서 특정 언어로 분류한 포스트와 일치합니다(해당 포스트가 분류된 경우에만). 각 게시물은 하나의 언어로만 분류되므로, 여러 언어를 AND 연산자로 함께 사용하면 결과가 반환되지 않습니다.

**참고:** 언어 분류를 할 수 없는 경우 제공되는 결과 값은 `und`(undefined)입니다.

이 연산자는 지원되는 언어에 대해서만 일치합니다. `und`를 포함하여 다른 값을 제공하면 이 연산자는 무시됩니다(즉, 포스트는 이 연산자로 필터링되지 않습니다). 아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 나타냅니다:

`am` 암하라어

`hu` 헝가리어

`pt` 포르투갈어

`ar` 아랍어

`is` 아이슬란드어

`ro` 루마니아어

`hy` 아르메니아어

`in` 인도네시아어

`ru` 러시아어

`bn` 벵골어

`it` 이탈리아어

`sr` 세르비아어

`bg` 불가리아어

`ja` 일본어

`sd` 신디어

`my` 버마어

`kn` 칸나다어

`si` 싱할라어

`zh` 중국어

`km` 크메르어

`sk` 슬로바키아어

`cs` 체코어

`ko` 한국어

`sl` 슬로베니아어

`da` 덴마크어

`lo` 라오어

`ckb` 소라니 쿠르드어

`nl` 네덜란드어

`lv` 라트비아어

`es` 스페인어

`en` 영어

`lt` 리투아니아어

`sv` 스웨덴어

`et` 에스토니아어

`ml` 말라얄람어

`tl` 타갈로그어

`fi` 핀란드어

`dv` 몰디브어

`ta` 타밀어

`fr` 프랑스어

`mr` 마라티어

`te` 텔루구어

`ka` 조지아어

`ne` 네팔어

`th` 태국어

`de` 독일어

`no` 노르웨이어

`bo` 티베트어

`el` 그리스어

`or` 오리야어

`tr` 터키어

`gu` 구자라티어

`pa` 펀자브어

`uk` 우크라이나어

`ht` 아이티어

`ps` 파슈토어

`ur` 우르두어

`iw` 히브리어

`fa` 페르시아어

`ug` 위구르어

`hi` 힌디어

`pl` 폴란드어

`vi` 베트남어

`cy` 웨일스어 | 값이 `und`가 아닌 `lang` | | listed\_count: | PowerTrack | *사용 가능한 별칭*: user\_in\_lists\_count:

작성자가 X에서 리스트에 포함된 횟수가 지정한 범위에 해당하는 포스트와 일치합니다.

\* 단일 숫자(예: `listed_count:42`)는 지정한 값 이상인 모든 경우와 일치합니다.
\* 범위(예: `listed_count:42..1337`)는 지정한 범위 안의 모든 값과 일치합니다. | `user.listed_count` | | place\_country: | PowerTrack

Search | 태그된 [place/location](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-geo-objects)와 연관된 국가 코드가 지정된 [ISO alpha-2 문자 코드](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)와 일치하는 포스트를 반환합니다.

**참고:** place(Post geo)에 대해 일치 여부를 검사하는 연산자는 원본 포스트에서만 일치 항목을 포함합니다. 리트윗에는 place 데이터가 포함되지 않습니다. | `place` (원본 포스트에만 해당) | | place: | PowerTrack

Search | 지정된 위치 또는 [X place ID](https://developer.x.com/en/docs/x-api/v1/geo/places-near-location/api-reference/get-geo-search)가 태그된 포스트를 일치 대상으로 찾습니다. 여러 단어로 이루어진 장소 이름은 따옴표로 묶어야 합니다(예: `place:"San Francisco"`)

**참고:** place(Post geo)에 일치시키는 연산자는 원본 포스트만 일치 대상으로 포함합니다. 리트윗에는 place 데이터가 포함되지 않습니다. | `place` (원본 포스트에만 해당) | | point\_radius: | PowerTrack

Search | **참고:** place(Post geo)에 대해 매칭하는 연산자는 원본 포스트에서의 매치만 포함합니다. 리트윗에는 place 데이터가 포함되지 않습니다. | `place` (원본 포스트만) | | profile\_bounding\_box:\[west\_long south\_lat east\_long north\_lat] | PowerTrack | 정의된 영역 안에 Place가 완전히 포함되는 경우, [Profile Geo enrichment](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)에 있는 사용자의 정확한 Location(경도, 위도)과 매칭합니다.

\* west\_long south\_lat 는 바운딩 박스의 남서쪽 꼭짓점을 나타내며, west-long 은 그 지점의 경도, south\_lat 는 위도입니다.
\* east\_long 과 north\_lat 는 바운딩 박스의 북동쪽 꼭짓점을 나타내며, east\_long 은 그 지점의 경도, north\_lat 는 위도입니다.
\* 바운딩 박스의 가로·세로 길이는 25mi(마일) 미만이어야 합니다.
\* 경도는 ±180 범위여야 합니다.
\* 위도는 ±90 범위여야 합니다.
\* 모든 좌표는 십진수 도 단위입니다.
\* 규칙 인수는 대괄호 안에 포함되며, 공백으로 구분됩니다.

**참고:** place(게시물 geo)에 대해 매칭하는 연산자는 원본 게시물만 매칭 대상으로 포함합니다. 리트윗에는 place 데이터가 포함되지 않습니다. | `user.derived.locations.geo.coordinates` | | profile\_country: | PowerTrack

Search | [Profile Geo enrichment](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)에서 제공되는 국가 코드와의 정확한 일치를 대상으로 합니다.

[ISO-3166-1-alpha-2 specification](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)을 기반으로 표준화된 두 글자 국가 코드 집합을 사용합니다.

규칙을 간결하게 유지하기 위해 address 객체의 country 필드에 대한 연산자 대신 이 연산자를 제공합니다.

**참고:** place(게시물 위치 정보)에 대해 매칭하는 연산자는 원본 게시물에서만 일치를 반환합니다. 리트윗에는 place 데이터가 포함되어 있지 않습니다. | `user.derived.locations.country_code` | | profile\_locality: | PowerTrack

Search | [Profile Geo enrichment](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)의 Locality 필드와 정확히 일치합니다.

전체 문자열이 정확히 일치해야 합니다.

문자를 백슬래시로 이스케이프할 필요는 없습니다. 예를 들어, 슬래시가 포함된 값을 일치시키려면 `one/two`처럼 사용하면 됩니다.

공백이나 구두점이 포함된 부분 문자열을 매칭하려면 큰따옴표를 사용하세요. 예: `profile_locality:"Lower East Side"`. | `user.derived.locations.locality` | | profile\_point\_radius:\[lon lat radius] | PowerTrack | 사용자의 [Profile Geo enrichment](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)에 포함된 정확한 위치(x,y 좌표)에 대해 일치 여부를 검사합니다.

\* 지원되는 반지름 단위는 마일(mi)과 킬로미터(km)입니다.
\* 반지름은 25mi 미만이어야 합니다.
\* 경도는 ±180 범위여야 합니다.
\* 위도는 ±90 범위여야 합니다.
\* 모든 좌표는 십진수 도(degree) 단위입니다.
\* 규칙 인수는 대괄호(\[]) 안에 포함되며, 공백으로 구분됩니다.

**참고:** place(게시물 위치)를 기준으로 매칭하는 연산자는 원본 포스트에서만 일치를 포함합니다. 리트윗 포스트에는 place 데이터가 포함되지 않습니다. | `user.derived.locations.geo` | | profile\_region: | PowerTrack

Search | [Profile Geo enrichment](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)의 Region 필드 값과 정확히 일치합니다.

전체 문자열이 정확히 일치해야 합니다.

백슬래시로 문자를 이스케이프할 필요는 없습니다. 예를 들어, 슬래시가 포함된 값을 일치시키려면 `one/two`처럼 사용합니다.

공백이나 문장 부호를 포함하는 부분 문자열을 일치시키려면 큰따옴표를 사용합니다. 예: `profile_locality:"New York"`. | `user.derived.locations.region` | | profile\_subregion: | PowerTrack | [Profile Geo enrichment](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)의 Subregion 필드 값과 정확히 일치합니다.

전체 문자열이 정확히 일치해야 합니다.

백슬래시로 문자를 이스케이프할 필요는 없습니다. 예를 들어 슬래시가 포함된 값을 매칭하려면 `one/two`와 같이 사용하면 됩니다.

공백이나 구두점이 포함된 부분 문자열을 매칭하려면 큰따옴표를 사용하세요. 예: `profile_locality:"Kings County"`. | `user.derived.locations.sub_region` | | "keyword1 keyword2"\~N | PowerTrack

Search | 일반적으로 근접 연산자로 불리며, 키워드들이 서로 N개 토큰 이내에 있을 때 해당 게시물을 일치 대상으로 찾습니다.

키워드의 순서가 반대인 경우, 서로 N-2개 토큰보다 더 멀리 떨어져 있을 수 없습니다.

따옴표 안에는 임의의 개수의 키워드를 넣을 수 있습니다.

N은 6을 초과할 수 없습니다. | `text` | | retweets\_of\_status\_id: | PowerTrack | *사용 가능한 별칭*: retweets\_of\_tweet\_id:

지정한 원본 게시물의 명시적 리트윗만 전달합니다. | `retweeted_status.id`, `retweeted_status.id_str` | | retweets\_of: | PowerTrack

Search | *사용 가능한 별칭*: retweets\_of\_user:

지정한 사용자의 게시물을 리트윗한 모든 게시물과 일치합니다. 값에는 username(`@` 문자를 제외한 값) 또는 사용자의 숫자형 ID를 사용할 수 있으며, 예를 들어 [GET users/lookup](https://developer.x.com/en/docs/x-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-lookup) 엔드포인트를 통해 가져올 수 있습니다. | `retweeted_status.id` (존재하는 경우) | | sample: | PowerTrack | 규칙과 일치하는 포스트 전체 집합이 아니라, 그중 무작위 비율의 샘플만 반환합니다. 비율 값은 1에서 100 사이의 정수여야 합니다.

이 연산자는 전체 규칙에 적용되며, OR로 연결된 모든 항을 하나의 그룹으로 묶어야 합니다.

**참고:** sample 연산자는 먼저 파이어호스의 범위를 X%로 축소한 다음, 그 샘플 하위 집합에 규칙/필터를 적용합니다. 예를 들어 `sample:10`을 사용하는 경우, 각 포스트는 샘플에 포함될 확률이 10%입니다. 

**참고:** 샘플링은 결정론적이므로, 실시간으로 얻는 데이터 샘플은 과거 데이터를 조회했을 때와 동일합니다. | | | source: | PowerTrack | 지정된 소스 App에서 생성된 모든 게시물과 일치합니다. 값은 App 이름이거나 App의 URL이어야 합니다.

이 연산자는 단독으로 사용할 수 없습니다. | `source` | | statuses\_count: | PowerTrack | *사용 가능한 별칭*: tweets\_count:

작성자가 작성한 statuses(상태) 수가 지정된 범위에 포함되는 포스트와 일치합니다.

\* 단일 숫자값(예: `statuses_count:42`)은 지정된 값 이상인 모든 숫자와 일치합니다.
\* 범위(예: `statuses_count:42..1337`)는 지정된 범위 내의 모든 숫자와 일치합니다. | `user``.statuses_count` | | to: | PowerTrack

Search | 특정 사용자에게 보내는 답글인 모든 게시물을 매치합니다. 값으로는 사용자 이름(`@` 문자는 제외)이나 사용자의 숫자 ID를 사용할 수 있으며, 예를 들어 [GET users/lookup](https://developer.x.com/en/docs/x-api/v1/accounts-and-users/follow-search-get-users/api-reference/get-users-lookup) 엔드포인트를 통해 이 값을 조회할 수 있습니다. | `text` | | url: | PowerTrack

Search | 게시물의 확장된 URL에 대해 토큰 단위로 일치 여부를 검사합니다. 구두점이나 특수 문자를 포함하는 토큰과 구는 큰따옴표로 감싸야 합니다(예: `url:"/developer"`).

일반적으로는 권장되지 않지만, 이 연산자는 큰따옴표로 감싼 특정 프로토콜에도 일치시킬 수 있습니다(예: `url:"https://developer.x.com"`). | `entities.urls.expanded_url` | | url\_contains: | PowerTrack | (새로운) [확장 URL title 메타데이터 보강 기능](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)에서 키워드/문구 일치 검색을 수행합니다. | `entities.urls.expanded_url` | | url\_description: | PowerTrack | *사용 가능한 별칭*: within\_url\_description:

(새로운) [확장된 페이지 설명 메타데이터 보강 기능](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)에 대해 키워드/구문을 기준으로 일치 여부를 검사합니다. | `entities.urls.unwound.description` | | url\_title: | PowerTrack | *사용 가능한 별칭*: within\_url\_title:

(새로운) [확장 URL title 메타데이터 enrichment](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-enrichments)에서 키워드/구문을 매칭합니다. | `entities.urls.title` |