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

# 검색 연산자

이 페이지에서는 Search v2 API 엔드포인트에서 [쿼리를 생성](/ko/x-api/posts/search/integrate/build-a-query)할 때 사용할 수 있는 연산자 목록을 제공합니다.

<div id="list-of-operators">
  ## 연산자 목록
</div>

<Note>**참고:** 일부 연산자에는 다른 이름(별칭)을 사용할 수 있습니다.</Note>

| **연산자**                 | **type**         | **설명**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| :---------------------- | :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- | ----------- | --------------------------- | ---------- | ---------------- | ------------------------------ | ----------- | ---------- | ------------------------------- | -------------- | --------- | ------------------------- | ---------- | ----------- | --------------------------- | --------- | ---------- | ---------------------------- | ------------------ | ---------- | ------------------------ | ---------- | ---------- | ---------------------------- | ------------ | ----------- | -------------------------- | ------------ | ---------- | ------------------------- | ----------- | ----------- | ------------------------------- | --------- | ----------- | -------------------------- | ---------- | ---------- | -------------------------- | ---------- | ----------- | ---------------------------- | --------- | --------------- | -------------------------- | --------- | --------- | -------------------------- | ----------- | ---------- | -------------------------- | ------------ |
| `keyword`               | 단독 사용 가능         | 게시물 본문에 포함된 키워드와 일치하는지 검사합니다. 이는 토큰 단위 매치로, 사용자가 지정한 키워드 문자열을 게시물 본문의 토큰화된 텍스트와 비교한다는 의미입니다. 토큰화는 구두점, 기호, 유니코드 기본 평면의 구분 문자 등을 기준으로 단어를 분리합니다.<br /><br />예를 들어 “I like coca-cola”라는 텍스트가 포함된 게시물은 다음과 같은 토큰으로 분리됩니다: I, like, coca, cola. 그런 다음 이 토큰들을 쿼리에 사용한 키워드 문자열과 비교합니다. 구두점(예: coca-cola), 기호, 또는 구분 문자가 포함된 문자열을 매치하려면 키워드를 큰따옴표로 감싸야 합니다.<br /><br />예시: `pepsi OR cola OR "coca cola"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `emoji`                 | 단독 사용 가능         | 게시물 본문에서 이모지를 일치시킵니다. 키워드와 유사하게, 이모지는 토큰 단위로 일치가 이뤄지며, 사용한 이모지가 게시물 본문의 토큰화된 텍스트와 비교되어 매칭됩니다.<br /><br />이모지에 변형(variant)이 있는 경우, 쿼리에 추가하려면 큰따옴표로 감싸야 합니다.<br /><br />예시: `(😃 OR 😡) 😬`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `"exact phrase match"`  | 단독 사용 가능         | 게시물 본문에서 검색어와 정확히 일치하는 구를 찾습니다.<br /><br />예시: `("X API" OR #v2) -"recent search"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `#`                     | 단독 사용 가능         | 게시물에서 해당 해시태그가 인식된 엔티티인 경우, 그 해시태그를 포함하는 모든 게시물과 매칭합니다.<br /><br />이 연산자는 토큰화 일치가 아닌 정확한 일치를 수행합니다. 따라서 규칙 `#thanku`는 정확히 #thanku 해시태그가 포함된 포스트와만 매칭되고, #thankunext 해시태그가 포함된 포스트와는 매칭되지 않습니다.<br /><br />예시: `#thankunext #fanart OR @arianagrande`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `@`                     | 단독 사용 가능         | 지정한 사용자 이름을 언급하는 모든 게시물과 일치하며, 이때 해당 사용자 이름은 @ 문자를 포함한 인식된 엔터티여야 합니다.<br /><br />예시: `(@XDevelopers OR @API) -@X`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `$`                     | 단독 사용 가능         | 지정된 '캐시태그(cashtag)'를 포함하는 모든 게시물과 일치합니다(토큰의 첫 글자가 $ 문자일 때).<br /><br />캐시태그 연산자는 본문에서 직접 캐시태그를 추출하려고 시도하는 대신, 캐시태그를 매칭하기 위해 X의 &#39;symbols&#39; 엔터티 추출 기능에 의존한다는 점에 유의하십시오.<br /><br />예시: `$twtr OR @XDevelopers -\$fb\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `from:`                 | 단독 사용 가능         | 특정 사용자가 작성한 게시물과 일치합니다.<br />값으로는 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 user ID를 사용할 수 있습니다.<br /><br />`from:` 연산자에는 username/ID를 하나만 사용할 수 있습니다.<br /><br />예시: `from:XDevelopers OR from:API -from:X`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `to:`                   | 단독 사용 가능         | 특정 사용자에 대한 답글인 모든 게시물과 일치합니다.<br />값은 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 사용자 ID일 수 있습니다.<br /><br />각 `to:` 연산자에는 하나의 사용자 이름/ID만 전달할 수 있습니다.<br /><br />예시: `to:XDevelopers OR to:API -to:X`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `url:`                  | 단독 사용 가능         | 게시물에 포함된, 올바른 형식의 모든 URL에 대해 토큰 단위 매칭을 수행합니다.<br /><br />이 연산자는 `url` 또는 `expanded_url` 필드의 내용과 모두 매칭됩니다. 예를 들어, "You should check out X Developer Labs: [https://t.co/c0A36SWil4](https://t.co/c0A36SWil4)" (짧은 URL이 [https://developer.twitter.com으로](https://developer.twitter.com으로) 리디렉션됨)이라는 내용을 포함하는 게시물은 다음 두 규칙 모두와 일치합니다.<br /><br />`from:XDevelopers url:"https://developer.twitter.com"` (이는 `entities.urls.expanded_url`의 내용과 일치하기 때문입니다)<br /><br />`from:XDevelopers url:"https://t.co"` (이는 `entities.urls.url`의 내용과 일치하기 때문입니다)<br /><br />문장 부호나 특수 문자가 포함된 토큰과 구는 큰따옴표로 감싸야 합니다(예: `url:"/developer"`). 마찬가지로, 특정 프로토콜과 매칭하려면 큰따옴표로 감싸야 합니다(예: `url:"https://developer.twitter.com"`).                                                                                                                                                                                      |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `retweets_of:`          | 단독 사용 가능         | 지정된 사용자의 게시물을 리트윗한 포스트를 매칭합니다. 값에는 사용자 이름(@ 문자를 제외) 또는 사용자의 숫자형 user ID를 사용할 수 있습니다.<br /><br />`retweets_of:` 연산자 하나당 하나의 사용자 이름/ID만 전달할 수 있습니다.<br /><br />예시: `retweets_of:twitterdev OR retweets_of:twitterapi`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `in_reply_to_tweet_id:` | 단독 사용 가능         | *사용 가능한 별칭:* `in_reply_to_status_id:`<br />지정된 게시물에 대한 답글과 일치하는 게시물을 검색합니다.<br /><br />예시: `in_reply_to_tweet_id:1539382664746020864`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `retweets_of_tweet_id:` | 단독 사용 가능         | *사용 가능한 별칭:* `retweets_of_status_id:`<br />지정된 게시물의 명시적(또는 네이티브) 리트윗과 일치합니다. 사용할 게시물 ID는 리트윗이 아닌 원본 게시물의 ID여야 합니다.<br /><br />예시: `retweets_of_tweet_id:1539382664746020864`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `quotes_of_tweet_id:`   | 단독 사용 가능         | *사용 가능한 별칭:* `quotes_of_status_id:`<br />지정된 게시물을 인용한 Tweet에 대해 매칭됩니다. 사용되는 게시물 ID는 인용 Tweet이 아니라 원본 게시물의 ID여야 합니다.<br /><br />예시: `quotes_of_tweet_id:1539382664746020864`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `context:`              | 단독 사용 가능         | 특정 domain id/entity id 쌍과 일치하는 포스트를 검색합니다. 이 연산자에 대해 더 알아보려면 [annotations](/ko/x-api/fundamentals/post-annotations) 페이지를 방문하세요.<br /><br />하나의 `context:` 연산자마다 도메인/엔티티는 하나만 전달할 수 있습니다.<br /><br />`context:domain_id.entity_id`<br /><br />그러나 OR 연산자를 사용해 여러 도메인/엔티티를 조합할 수 있습니다.<br /><br />`(context:47.1139229372198469633 OR context:11.1088514520308342784)`<br /><br />예시:<br />`context:10.799022225751871488` (`domain_id.entity_id`는 해당 도메인-엔티티 쌍과 일치하는 포스트를 반환합니다)                                                                                                                                                                                                                                                                                                                                                                                                                 |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `entity:`               | 단독 사용 가능         | 특정 엔티티 문자열 값과 일치하는 포스트를 반환합니다. 이 연산자에 대해 더 알아보려면 [annotations](/ko/x-api/fundamentals/post-annotations) 페이지를 방문하세요.<br />**참고**: 이 기능은 최근 검색에서만 사용할 수 있습니다.<br /><br />`entity:` 연산자는 한 번에 하나만 사용할 수 있습니다.<br /><br />`entity:"string declaration of entity/place"`<br /><br />예시: `entity:"Michael Jordan" OR entity:"Barcelona"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `conversation_id:`      | 단독 사용 가능         | 공통된 대화 ID를 가진 포스트와 일치하는 게시물을 반환합니다. 대화 ID는 대화를 시작한 게시물의 게시물 ID로 설정됩니다. 게시물에 대한 답글이 게시될 때마다, 답글에 대한 답글까지 포함하여, 해당 게시물의 JSON 페이로드에 `conversation_id`가 추가됩니다.<br /><br />각 `conversation_id:` 연산자마다 하나의 대화 ID만 지정할 수 있습니다.<br /><br />예시: `conversation_id:1334987486343299072 (from:XDevelopers OR from:api)`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `list:`                 | 단독 사용 가능         | 지정된 리스트에 속한 사용자가 게시한 포스트와 일치하는 결과를 반환합니다.<br /><br />예를 들어 @XDevelopers와 @api가 리스트 123의 구성원이고, 쿼리에 `list:123`을 포함했다면 응답에는 해당 계정들이 게시한 포스트만 포함됩니다. [List lookup](/ko/x-api/lists/list-lookup/introduction) 엔드포인트를 사용해 리스트 ID를 조회할 수 있습니다.<br /><br />**주의**: 쿼리당 사용할 수 있는 `list:` 연산자는 하나뿐이며, 각 `list:` 연산자마다 하나의 리스트만 지정할 수 있습니다.<br /><br />예시: `list:123`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `place:`                | 단독 사용 가능         | 지정된 위치 또는 X place ID가 태그된 포스트와 일치합니다. 여러 단어로 구성된 장소 이름(“New York City”, “Palo Alto”)은 큰따옴표로 감싸야 합니다.<br /><br />`place:` 연산자에는 하나의 place만 전달할 수 있습니다.<br /><br />참고: X place ID를 얻는 방법은 [GET geo/search](https://developer.x.com/content/developer-twitter/en/docs/geo/places-near-location/api-reference/get-geo-search) 표준 v1.1 엔드포인트를 참조하세요.<br /><br />참고: 이 연산자는 리트윗에는 적용되지 않습니다. 리트윗의 장소 정보는 원본 포스트에 연결되기 때문입니다. 또한 Quote Tweet의 원본 포스트에 연결된 장소에도 적용되지 않습니다.<br /><br />예시: `place:"new york city" OR place:seattle OR place:fd70c22040963ac7`                                                                                                                                                                                                                                                                                                                                            |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `place_country:`        | 단독 사용 가능         | 태그된 장소/위치에 연관된 국가 코드가 지정된 ISO 알파-2 문자 코드와 일치하는 포스트를 매칭합니다.<br /><br />유효한 ISO 코드 목록은 [Wikipedia](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)에서 확인할 수 있습니다.<br /><br />`place_country:` 연산자당 하나의 ISO 코드만 전달할 수 있습니다.<br /><br />참고: Retweet에 연결된 장소 정보는 원본 게시물에 연결되므로, 이 연산자는 Retweet에는 매칭되지 않습니다. 또한 Quote Tweet의 원본 게시물에 연결된 장소에도 매칭되지 않습니다.<br /><br />예시: `place_country:US OR place_country:MX OR place_country:CA`                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `point_radius:`         | 단독 사용 가능         | 게시물에 `place.geo.coordinates` 객체가 존재하는 경우 해당 객체와, X에서는 장소 지오 폴리곤을 대상으로 매칭하며, 이때 Place 폴리곤이 지정된 영역 안에 완전히 포함되어 있어야 합니다.<br /><br />`point_radius:[longitude latitude radius]`<br /><br />- 지원되는 반지름 단위는 마일(mi)과 킬로미터(km)입니다<br />- 반지름은 25mi 미만이어야 합니다<br />- 경도는 ±180 범위여야 합니다<br />- 위도는 ±90 범위여야 합니다<br />- 모든 좌표는 십진 도(degree) 단위입니다<br />- 규칙 인수는 대괄호 안에 넣고, 공백으로 구분합니다<br /><br />`point_radius:` 연산자당 하나의 지오 폴리곤만 지정할 수 있습니다.<br /><br />참고: 이 연산자는 리트윗에는 매칭되지 않습니다. 리트윗의 장소 정보는 원본 게시물에 연결되어 있기 때문입니다. 또한 인용 Tweet의 원본 게시물에 연결된 장소에도 매칭되지 않습니다.<br /><br />예시: `point_radius:[2.355128 48.861118 16km] OR point_radius:[-41.287336 174.761070 20mi]`                                                                                                                                                                                                                                      |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `bounding_box:`         | 단독 사용 가능         | *사용 가능한 별칭:* `geo_bounding_box:`<br />Post에 `place.geo.coordinates` 객체가 있을 경우 해당 객체에 대해 매치를 수행하고, X에서는 지정된 영역 안에 장소 폴리곤이 완전히 포함되는 place geo 폴리곤에 대해 매치를 수행합니다.<br /><br />`bounding_box:[west_long south_lat east_long north_lat]`<br /><br />- `west_long south_lat`는 bounding box의 남서쪽 모서리를 나타내며, `west_long`는 그 지점의 경도, `south_lat`는 위도를 의미합니다.<br />- `east_long north_lat`는 bounding box의 북동쪽 모서리를 나타내며, `east_long`는 그 지점의 경도, `north_lat`는 위도를 의미합니다.<br />- bounding box의 너비와 높이는 25mi 미만이어야 합니다.<br />- 경도는 ±180 범위여야 합니다.<br />- 위도는 ±90 범위여야 합니다.<br />- 모든 좌표는 십진수 도(degree) 단위입니다.<br />- 규칙 인수는 대괄호 안에 공백으로 구분하여 넣습니다.<br /><br />`bounding_box:` 연산자당 하나의 geo 폴리곤만 전달할 수 있습니다.<br /><br />참고: 이 연산자는 Retweet의 장소 정보가 원본 Post에 연결되므로 Retweet에는 일치하지 않습니다. 또한 Quote Tweet의 원본 Post에 연결된 장소에도 일치하지 않습니다.<br /><br />예시: `bounding_box:[-105.301758 39.964069 -105.178505 40.09455]` |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `is:retweet`            | 다른 조건과 함께 사용해야 함 | 지정된 규칙의 다른 조건을 모두 충족하는 Retweet만 매칭합니다. 이 연산자는 Retweet 버튼을 사용해 생성된 Retweet과 같은 실제 Retweet만을 대상으로 합니다. Quote Tweet은 이 연산자로 매칭되지 않습니다.<br /><br />예시: `data @XDevelopers -is:retweet`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `is:reply`              | 다른 조건과 함께 사용해야 함 | 규칙과 일치하는 명시적인 답글만 전달합니다. 또한 부정 형태로 사용하여 쿼리와 일치하는 답글을 전달 대상에서 제외할 수도 있습니다.<br /><br />참고: 이 연산자는 filtered stream 엔드포인트에서도 사용할 수 있습니다. filtered stream과 함께 사용할 때, 이 연산자는 원본 게시물에 대한 답글, 인용된 Tweet에 달린 답글, 리트윗에 달린 답글을 대상으로 일치 여부를 평가합니다.<br /><br />예시: `from:XDevelopers is:reply`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `is:quote`              | 다른 조건과 함께 사용해야 함 | 모든 Quote Tweet, 즉 댓글이 포함된 포스트를 반환합니다.<br /><br />예: `"sentiment analysis" is:quote`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `is:verified`           | 다른 조건과 함께 사용해야 함 | X에서 인증된 사용자가 작성한 포스트만 반환합니다.<br /><br />예시: `#nowplaying is:verified`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `-is:nullcast`          | 다른 조건과 함께 사용해야 함 | ads.twitter.com에서 프로모션 용도로만 생성되고 `"source":"Twitter for Advertisers (legacy)"` 또는 `"source":"Twitter for Advertisers"` 값을 가진 포스트를 제외합니다.<br />이 연산자는 반드시 부정형으로 사용해야 합니다.<br /><br />Nullcast 처리된 포스트에 대한 자세한 내용은 [게시물 가용성](https://developer.x.com/content/developer-twitter/en/docs/twitter-api/v1/tweets/post-and-engage/guides/tweet-availability) 페이지를 참고하세요.<br /><br />Example: `"mobile games" -is:nullcast`                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:hashtags`          | 다른 조건과 함께 사용해야 함 | 적어도 하나의 해시태그를 포함하는 포스트와 일치합니다.<br /><br />예시: `from:XDevelopers -has:hashtags`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:cashtags`          | 다른 조건과 함께 사용해야 함 | 선행 문자로 ‘$’가 붙은 캐시태그(예: `$tag`)를 포함하는 포스트와 일치합니다.<br /><br />예시: `#stonks has:cashtags\`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:links`             | 다른 조건과 함께 사용해야 함 | 이 연산자는 포스트 본문에 링크와 미디어가 포함된 포스트와 일치합니다.<br /><br />예시: `from:XDevelopers announcement has:links`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:mentions`          | 다른 조건과 함께 사용해야 함 | 다른 X 사용자를 언급한 포스트와 일치합니다.<br /><br />예시: `#nowplaying has:mentions`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:media`             | 다른 조건과 함께 사용해야 함 | *사용 가능한 별칭:* `has:media_link`<br />X에서 사진, GIF, 동영상과 같은 미디어 객체가 포함되어 있다고 판단한 포스트와 일치합니다. Periscope에서 생성된 미디어나 다른 미디어 호스팅 사이트에 대한 링크가 포함된 포스트와는 일치하지 않습니다.<br /><br />예: `(kittens OR puppies) has:media`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:images`            | 다른 조건과 함께 사용해야 함 | 인식된 이미지의 URL을 포함하는 포스트와 일치합니다.<br /><br />예시: `#meme has:images`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:video_link`        | 다른 조건과 함께 사용해야 함 | *사용 가능한 별칭:* `has:videos`<br />X에 직접 업로드된 네이티브 X 동영상이 포함된 포스트와 일치합니다. Periscope로 생성된 동영상이나 다른 동영상 호스팅 사이트로 연결되는 링크가 포함된 포스트에는 일치하지 않습니다.<br /><br />예시: `#icebucketchallenge has:video_link`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `has:geo`               | 다른 조건과 함께 사용해야 함 | X 사용자가 제공한, 게시물에 특화된 지리 정보가 포함된 포스트와 일치합니다. 이는 표시 이름, geo 폴리곤 및 기타 필드를 포함하는 X place 형태의 위치이거나, 드문 경우 geo 위도/경도 좌표일 수 있습니다.<br /><br />참고: place(게시물 geo)을 기준으로 일치시키는 연산자는 원본 포스트만 대상으로 일치시킵니다. 리포스트에는 place 데이터가 포함되지 않습니다.<br /><br />예: `recommend #paris has:geo -bakery`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |           |             |                             |            |                  |                                |             |            |                                 |                |           |                           |            |             |                             |           |            |                              |                    |            |                          |            |            |                              |              |             |                            |              |            |                           |             |             |                                 |           |             |                            |            |            |                            |            |             |                              |           |                 |                            |           |           |                            |             |            |                            |              |
| `lang:`                 | 다른 조건과 함께 사용해야 함 | X에서 특정 언어로 분류된 포스트(해당 게시물이 분류된 경우에만)에 일치합니다. 각 포스트는 현재 하나의 언어로만 분류되므로, 여러 언어를 AND 조건으로 함께 사용해도 결과는 반환되지 않는다는 점에 유의해야 합니다.<br /><br />각 `lang:` 연산자마다 하나의 BCP 47 언어 식별자만 전달할 수 있습니다.<br /><br />참고: 언어 분류를 할 수 없는 경우 결과로 ‘und’(미정의)가 제공됩니다.<br /><br />예시: `recommend #paris lang:en`<br /><br />아래 목록은 현재 지원되는 언어와 해당 BCP 47 언어 식별자를 나타냅니다:<br /><br />암하라어: `am`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 독일어: `de` | 말라얄람어: `ml` | 슬로바키아어: `sk`<br />아랍어: `ar` | 그리스어: `el` | 디베히어(몰디브어): `dv` | 슬로베니아어: `sl`<br />아르메니아어: `hy` | 구자라트어: `gu` | 마라티어: `mr` | 소라니 쿠르드어: `ckb`<br />바스크어: `eu` | 아이티 크리올어: `ht` | 네팔어: `ne` | 스페인어: `es`<br />벵골어: `bn` | 히브리어: `iw` | 노르웨이어: `no` | 스웨덴어: `sv`<br />보스니아어: `bs` | 힌디어: `hi` | 오리야어: `or` | 타갈로그어: `tl`<br />불가리아어: `bg` | 로마자 힌디어: `hi-Latn` | 펀자브어: `pa` | 타밀어: `ta`<br />버마어: `my` | 헝가리어: `hu` | 파슈토어: `ps` | 텔루구어: `te`<br />크로아티아어: `hr` | 아이슬란드어: `is` | 페르시아어: `fa` | 태국어: `th`<br />카탈루냐어: `ca` | 인도네시아어: `in` | 폴란드어: `pl` | 티베트어: `bo`<br />체코어: `cs` | 이탈리아어: `it` | 포르투갈어: `pt` | 번체 중국어: `zh-TW`<br />덴마크어: `da` | 일본어: `ja` | 루마니아어: `ro` | 터키어: `tr`<br />네덜란드어: `nl` | 칸나다어: `kn` | 러시아어: `ru` | 우크라이나어: `uk`<br />영어: `en` | 크메르어: `km` | 세르비아어: `sr` | 우르두어: `ur`<br />에스토니아어: `et` | 한국어: `ko` | 간체 중국어: `zh-CN` | 위구르어: `ug`<br />핀란드어: `fi` | 라오어: `lo` | 신디어: `sd` | 베트남어: `vi`<br />프랑스어: `fr` | 라트비아어: `lv` | 싱할라어: `si` | 웨일스어: `cy`<br />조지아어: `ka` | 리투아니아어: `lt` |
