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

# Operadores do Powerstream

> Esta página fornece uma lista completa dos operadores disponíveis ao construir regras para. Referência para a X API v2 standard tier cobrindo powerstream.

Esta página fornece uma lista completa dos operadores disponíveis ao construir regras para o [Powerstream](/x-api/powerstream/introduction).

## Visão geral

O Powerstream usa consultas booleanas com operadores para filtrar Posts com base em palavras-chave e metadados. As regras podem ter até 2.048 caracteres e você pode ter até 1.000 regras.

***

## Operadores de usuário

| Operador       | Resumo                                                   | Exemplo                             |
| :------------- | :------------------------------------------------------- | :---------------------------------- |
| `from:`        | Corresponde a posts de um usuário específico             | `from:xdevelopers` ou `from:123456` |
| `to:`          | Corresponde a posts direcionados a um usuário específico | `to:jvaleski`                       |
| `retweets_of:` | Corresponde a reposts de um usuário específico           | `retweets_of:xdevelopers`           |

***

## Operadores de conteúdo

| Operador        | Resumo                                                          | Exemplo                                  |
| :-------------- | :-------------------------------------------------------------- | :--------------------------------------- |
| `contains:`     | Corresponde a posts que contêm texto/palavras-chave específicas | `contains:hello` ou `contains:-2345.432` |
| `url_contains:` | Corresponde a posts com URLs contendo texto específico          | `url_contains:"com/willplayforfood"`     |
| `lang:`         | Corresponde a posts em idiomas específicos                      | `lang:en`                                |

***

## Operadores de entidade

| Operador | Resumo                                                   | Exemplo                                 |
| :------- | :------------------------------------------------------- | :-------------------------------------- |
| `has:`   | Corresponde a posts contendo entidades específicas       | `has:images`, `has:geo`, `has:mentions` |
| `is:`    | Corresponde a posts de tipos ou propriedades específicas | `is:retweet`, `is:reply`                |

### Opções disponíveis para `has:`

* `has:mentions` — Posts que mencionam outro usuário
* `has:geo` — Posts com dados de geolocalização
* `has:links` — Posts contendo links
* `has:media` — Posts contendo mídia
* `has:lang` — Posts com idioma detectado
* `has:symbols` — Posts contendo cashtags
* `has:images` — Posts contendo imagens
* `has:videos` — Posts contendo vídeos

### Opções disponíveis para `is:`

* `is:retweet` — Retweets
* `is:reply` — Respostas a outros posts

***

## Operadores de localização

| Operador        | Resumo                                                          | Exemplo                                                                                    |
| :-------------- | :-------------------------------------------------------------- | :----------------------------------------------------------------------------------------- |
| `place:`        | Corresponde a posts de lugares/localizações específicas         | `place:"Belmont Central"` ou `place:02763fa2a7611cf3`                                      |
| `bounding_box:` | Corresponde a posts dentro de uma caixa delimitadora geográfica | `bounding_box:[-112.424083 42.355283 -112.409111 42.792311]`                               |
| `point_radius:` | Corresponde a posts dentro de um raio de um ponto               | `point_radius:[-111.464973 46.371179 25mi]` ou `point_radius:[-111.464973 46.371179 15km]` |

***

## Operadores de perfil de usuário

| Operador    | Resumo                                                         | Exemplo                |
| :---------- | :------------------------------------------------------------- | :--------------------- |
| `bio:`      | Corresponde a posts de usuários com conteúdo de bio específico | `bio:"data scientist"` |
| `bio_name:` | Corresponde a posts de usuários com nome específico na bio     | `bio_name:PhD`         |

***

## Operadores de referência de Post

| Operador                 | Resumo                                      | Exemplo                                     |
| :----------------------- | :------------------------------------------ | :------------------------------------------ |
| `retweets_of_status_id:` | Corresponde a reposts de posts específicos  | `retweets_of_status_id:1234567890123456789` |
| `in_reply_to_status_id:` | Corresponde a respostas a posts específicos | `in_reply_to_status_id:1234567890123456789` |

***

## Operadores de sintaxe especial

| Operador   | Resumo                      | Exemplo          |
| :--------- | :-------------------------- | :--------------- |
| `@`        | Operador de menção          | `@username`      |
| `"phrase"` | Corresponde a frases exatas | `"exact phrase"` |

***

## Operadores lógicos

| Operador   | Resumo                                | Exemplo                                              |
| :--------- | :------------------------------------ | :--------------------------------------------------- |
| `OR`       | OU lógico entre expressões            | `x OR facebook`                                      |
| Espaço/AND | E lógico entre expressões             | `x facebook` (ambos os termos devem estar presentes) |
| `()`       | Agrupamento para expressões complexas | `(x OR facebook) iphone`                             |
| `-`        | Negação/exclusão                      | `x -facebook` (x mas não facebook)                   |

***

## Construindo regras

### Exemplos básicos

```
# Corresponder a posts de um usuário específico

from:xdevelopers

# Corresponder a posts contendo palavras-chave

contains:API contains:developer

# Corresponder a posts com imagens em inglês

has:images lang:en
```

### Combinando operadores

```
# Posts de @xdevelopers OU @api que não sejam retweets

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

# Posts mencionando AI com imagens, excluindo retweets

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

# Posts dentro de 25 milhas de uma localização

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

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Introdução ao Powerstream" icon="bolt" href="/x-api/powerstream/introduction">
    Comece com o Powerstream
  </Card>

  <Card title="Lidando com desconexões" icon="plug" href="/x-api/fundamentals/handling-disconnections">
    Lide com desconexões de streaming
  </Card>

  <Card title="Recuperação e redundância" 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">
    Recupere dados perdidos
  </Card>
</CardGroup>
