> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Powerstream 연산자

> 이 페이지는 규칙을 구성할 때 사용할 수 있는 연산자의 전체 목록을 제공합니다. powerstream을 다루는 X API v2 표준 계층에 대한 참고 자료입니다.

이 페이지는 [Powerstream](/x-api/powerstream/introduction) 규칙을 구성할 때 사용할 수 있는 연산자의 전체 목록을 제공합니다.

## 개요

Powerstream은 키워드와 메타데이터를 기반으로 Post를 필터링하기 위해 연산자가 포함된 Boolean 쿼리를 사용합니다. 규칙은 최대 2,048자까지 가능하며 최대 1,000개의 규칙을 가질 수 있습니다.

***

## 사용자 연산자

| 연산자            | 요약                   | 예시                                  |
| :------------- | :------------------- | :---------------------------------- |
| `from:`        | 특정 사용자의 Post와 일치     | `from:xdevelopers` 또는 `from:123456` |
| `to:`          | 특정 사용자에게 보낸 Post와 일치 | `to:jvaleski`                       |
| `retweets_of:` | 특정 사용자의 리포스트와 일치     | `retweets_of:xdevelopers`           |

***

## 콘텐츠 연산자

| 연산자             | 요약                           | 예시                                       |
| :-------------- | :--------------------------- | :--------------------------------------- |
| `contains:`     | 특정 텍스트/키워드가 포함된 Post와 일치     | `contains:hello` 또는 `contains:-2345.432` |
| `url_contains:` | 특정 텍스트가 포함된 URL이 있는 Post와 일치 | `url_contains:"com/willplayforfood"`     |
| `lang:`         | 특정 언어의 Post와 일치              | `lang:en`                                |

***

## 엔티티 연산자

| 연산자    | 요약                   | 예시                                      |
| :----- | :------------------- | :-------------------------------------- |
| `has:` | 특정 엔티티가 포함된 Post와 일치 | `has:images`, `has:geo`, `has:mentions` |
| `is:`  | 특정 유형이나 속성의 Post와 일치 | `is:retweet`, `is:reply`                |

### 사용 가능한 `has:` 옵션

* `has:mentions` — 다른 사용자를 mention하는 Post
* `has:geo` — 지오로케이션 데이터가 있는 Post
* `has:links` — 링크가 포함된 Post
* `has:media` — 미디어가 포함된 Post
* `has:lang` — 감지된 언어가 있는 Post
* `has:symbols` — cashtag가 포함된 Post
* `has:images` — 이미지가 포함된 Post
* `has:videos` — 동영상이 포함된 Post

### 사용 가능한 `is:` 옵션

* `is:retweet` — 리트윗
* `is:reply` — 다른 Post에 대한 답글

***

## 위치 연산자

| 연산자             | 요약                           | 예시                                                                                         |
| :-------------- | :--------------------------- | :----------------------------------------------------------------------------------------- |
| `place:`        | 특정 장소/위치의 Post와 일치           | `place:"Belmont Central"` 또는 `place:02763fa2a7611cf3`                                      |
| `bounding_box:` | 지리적 bounding box 내의 Post와 일치 | `bounding_box:[-112.424083 42.355283 -112.409111 42.792311]`                               |
| `point_radius:` | 지점의 반경 내에 있는 Post와 일치        | `point_radius:[-111.464973 46.371179 25mi]` 또는 `point_radius:[-111.464973 46.371179 15km]` |

***

## 사용자 프로필 연산자

| 연산자         | 요약                           | 예시                     |
| :---------- | :--------------------------- | :--------------------- |
| `bio:`      | 특정 bio 내용을 가진 사용자의 Post와 일치  | `bio:"data scientist"` |
| `bio_name:` | bio에 특정 이름을 가진 사용자의 Post와 일치 | `bio_name:PhD`         |

***

## Post 참조 연산자

| 연산자                      | 요약                 | 예시                                          |
| :----------------------- | :----------------- | :------------------------------------------ |
| `retweets_of_status_id:` | 특정 Post의 리포스트와 일치  | `retweets_of_status_id:1234567890123456789` |
| `in_reply_to_status_id:` | 특정 Post에 대한 답글과 일치 | `in_reply_to_status_id:1234567890123456789` |

***

## 특수 구문 연산자

| 연산자        | 요약          | 예시               |
| :--------- | :---------- | :--------------- |
| `@`        | Mention 연산자 | `@username`      |
| `"phrase"` | 정확한 구문 일치   | `"exact phrase"` |

***

## 논리 연산자

| 연산자       | 요약              | 예시                                 |
| :-------- | :-------------- | :--------------------------------- |
| `OR`      | 표현식 사이의 논리적 OR  | `x OR facebook`                    |
| Space/AND | 표현식 사이의 논리적 AND | `x facebook` (두 용어 모두 있어야 함)       |
| `()`      | 복잡한 표현식의 그룹화    | `(x OR facebook) iphone`           |
| `-`       | 부정/제외           | `x -facebook` (x는 있고 facebook은 없음) |

***

## 규칙 구성하기

### 기본 예시

```
# 특정 사용자의 Post와 일치

from:xdevelopers

# 키워드가 포함된 Post와 일치

contains:API contains:developer

# 영어로 된 이미지가 포함된 Post와 일치

has:images lang:en
```

### 연산자 조합

```
# 리트윗이 아닌 @xdevelopers 또는 @api의 Post

(from:xdevelopers OR from:api) -is:retweet

# 리트윗을 제외하고 이미지가 있는 AI 언급 Post

contains:AI has:images -is:retweet lang:en

# 위치로부터 25마일 이내의 Post

point_radius:[-73.935242 40.730610 25mi] lang:en
```

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="Powerstream 소개" icon="bolt" href="/x-api/powerstream/introduction">
    Powerstream 시작하기
  </Card>

  <Card title="연결 해제 처리" icon="plug" href="/x-api/fundamentals/handling-disconnections">
    스트리밍 연결 해제 처리
  </Card>

  <Card title="복구 및 이중화" icon="https://mintcdn.com/x-preview/cfyQtgCdwk8p69aa/icons/xds/icon-shield-keyhole.svg?fit=max&auto=format&n=cfyQtgCdwk8p69aa&q=85&s=a0e05514090c8a6af232297bfb9c4055" href="/x-api/fundamentals/recovery-and-redundancy" width="24" height="24" data-path="icons/xds/icon-shield-keyhole.svg">
    놓친 데이터 복구
  </Card>
</CardGroup>
