> ## 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 de busca

> Esta página fornece uma lista completa de operadores disponíveis ao criar uma query para o Search. Referência para o tier standard da X API v2 sobre integrate.

Esta página fornece uma lista completa dos operadores disponíveis ao [criar uma query](/x-api/posts/search/integrate/build-a-query) para os endpoints da Search API.

## Visão geral

Os operadores são usados para corresponder a atributos específicos de Post. Existem dois tipos:

* **Operadores independentes** — Podem ser usados sozinhos ou com quaisquer outros operadores
* **Operadores que exigem conjunção** — Devem ser usados com pelo menos um operador independente

***

## Operadores de palavra-chave e frase

| Operador         | Tipo         | Resumo                                                                        | Exemplo                             |
| :--------------- | :----------- | :---------------------------------------------------------------------------- | :---------------------------------- |
| `keyword`        | Independente | Corresponde a uma palavra-chave no corpo do Post (correspondência tokenizada) | `pepsi OR cola OR "coca cola"`      |
| `emoji`          | Independente | Corresponde a um emoji no corpo do Post                                       | `(😃 OR 😡) 😬`                     |
| `"exact phrase"` | Independente | Corresponde à frase exata no corpo do Post                                    | `("X API" OR #v2) -"recent search"` |

***

## Operadores de entidade

| Operador | Tipo         | Resumo                                                             | Exemplo                      |
| :------- | :----------- | :----------------------------------------------------------------- | :--------------------------- |
| `#`      | Independente | Corresponde a Posts que contêm uma hashtag (correspondência exata) | `#thankunext #fanart`        |
| `@`      | Independente | Corresponde a Posts que mencionam um nome de usuário               | `(@XDevelopers OR @API) -@X` |
| `$`      | Independente | Corresponde a Posts que contêm uma cashtag                         | `$twtr OR @XDevelopers -$fb` |

***

## Operadores de usuário

| Operador       | Tipo         | Resumo                                                  | Exemplo                        |
| :------------- | :----------- | :------------------------------------------------------ | :----------------------------- |
| `from:`        | Independente | Corresponde a Posts de um usuário específico            | `from:XDevelopers OR from:API` |
| `to:`          | Independente | Corresponde a Posts em resposta a um usuário específico | `to:XDevelopers OR to:API`     |
| `retweets_of:` | Independente | Corresponde a Retweets de um usuário específico         | `retweets_of:twitterdev`       |

***

## Operadores de URL

| Operador | Tipo         | Resumo                                                                             | Exemplo                               |
| :------- | :----------- | :--------------------------------------------------------------------------------- | :------------------------------------ |
| `url:`   | Independente | Correspondência tokenizada em URL (corresponde aos fields `url` ou `expanded_url`) | `url:"https://developer.twitter.com"` |

***

## Operadores de context e entity

| Operador           | Tipo         | Resumo                                                                                 | Exemplo                               |
| :----------------- | :----------- | :------------------------------------------------------------------------------------- | :------------------------------------ |
| `context:`         | Independente | Corresponde a Posts com um par domain/entity específico                                | `context:10.799022225751871488`       |
| `entity:`          | Independente | Corresponde a Posts com um valor de string de entity específico (apenas recent search) | `entity:"Michael Jordan"`             |
| `conversation_id:` | Independente | Corresponde a Posts em uma thread de conversa                                          | `conversation_id:1334987486343299072` |

***

## Operador de lista

| Operador | Tipo         | Resumo                                                | Exemplo    |
| :------- | :----------- | :---------------------------------------------------- | :--------- |
| `list:`  | Independente | Corresponde a Posts de membros de uma List específica | `list:123` |

***

## Operadores de referência de Post

| Operador                | Tipo         | Resumo                                           | Exemplo                                    |
| :---------------------- | :----------- | :----------------------------------------------- | :----------------------------------------- |
| `in_reply_to_tweet_id:` | Independente | Corresponde a replies a um Post específico       | `in_reply_to_tweet_id:1539382664746020864` |
| `retweets_of_tweet_id:` | Independente | Corresponde a Retweets de um Post específico     | `retweets_of_tweet_id:1539382664746020864` |
| `quotes_of_tweet_id:`   | Independente | Corresponde a Quote Tweets de um Post específico | `quotes_of_tweet_id:1539382664746020864`   |

***

## Operadores de localização

| Operador         | Tipo         | Resumo                                            | Exemplo                                                     |
| :--------------- | :----------- | :------------------------------------------------ | :---------------------------------------------------------- |
| `place:`         | Independente | Corresponde a Posts marcados com uma localização  | `place:"new york city" OR place:seattle`                    |
| `place_country:` | Independente | Corresponde a Posts com um código de país         | `place_country:US OR place_country:MX`                      |
| `point_radius:`  | Independente | Corresponde a Posts dentro de um raio de um ponto | `point_radius:[2.355128 48.861118 16km]`                    |
| `bounding_box:`  | Independente | Corresponde a Posts dentro de uma bounding box    | `bounding_box:[-105.301758 39.964069 -105.178505 40.09455]` |

***

## Operadores de tipo de Post

| Operador       | Tipo            | Resumo                                      | Exemplo                         |
| :------------- | :-------------- | :------------------------------------------ | :------------------------------ |
| `is:retweet`   | Exige conjunção | Corresponde a Retweets                      | `data @XDevelopers -is:retweet` |
| `is:reply`     | Exige conjunção | Corresponde a replies                       | `from:XDevelopers is:reply`     |
| `is:quote`     | Exige conjunção | Corresponde a Quote Tweets                  | `"sentiment analysis" is:quote` |
| `is:verified`  | Exige conjunção | Corresponde a Posts de autores verificados  | `#nowplaying is:verified`       |
| `-is:nullcast` | Exige conjunção | Exclui Posts promocionais (deve ser negado) | `"mobile games" -is:nullcast`   |

***

## Operadores de tipo de conteúdo

| Operador         | Tipo            | Resumo                                           | Exemplo                              |
| :--------------- | :-------------- | :----------------------------------------------- | :----------------------------------- |
| `has:hashtags`   | Exige conjunção | Corresponde a Posts com hashtags                 | `from:XDevelopers -has:hashtags`     |
| `has:cashtags`   | Exige conjunção | Corresponde a Posts com cashtags                 | `#stonks has:cashtags`               |
| `has:links`      | Exige conjunção | Corresponde a Posts com links                    | `from:XDevelopers has:links`         |
| `has:mentions`   | Exige conjunção | Corresponde a Posts com menções                  | `#nowplaying has:mentions`           |
| `has:media`      | Exige conjunção | Corresponde a Posts com mídia (foto, GIF, vídeo) | `(kittens OR puppies) has:media`     |
| `has:images`     | Exige conjunção | Corresponde a Posts com imagens                  | `#meme has:images`                   |
| `has:video_link` | Exige conjunção | Corresponde a Posts com vídeos nativos do X      | `#icebucketchallenge has:video_link` |
| `has:geo`        | Exige conjunção | Corresponde a Posts com dados de geolocalização  | `recommend #paris has:geo`           |

***

## Operador de idioma

| Operador | Tipo            | Resumo                                                      | Exemplo                    |
| :------- | :-------------- | :---------------------------------------------------------- | :------------------------- |
| `lang:`  | Exige conjunção | Corresponde a Posts classificados como um idioma específico | `recommend #paris lang:en` |

***

## Operadores lógicos

| Operador     | Resumo                                | Exemplo                        |
| :----------- | :------------------------------------ | :----------------------------- |
| `OR`         | OR lógico entre expressões            | `cat OR dog`                   |
| Espaço (AND) | AND lógico entre expressões           | `cat dog` (ambos obrigatórios) |
| `()`         | Agrupamento para expressões complexas | `(cat OR dog) -is:retweet`     |
| `-`          | Negação/exclusão                      | `cat -grumpy`                  |

***

## Idiomas suportados

O operador `lang:` suporta estes códigos de idioma BCP 47:

| Idioma      | Código | Idioma    | Código | Idioma              | Código  |
| :---------- | :----- | :-------- | :----- | :------------------ | :------ |
| Amárico     | `am`   | Grego     | `el`   | Português           | `pt`    |
| Árabe       | `ar`   | Guzerate  | `gu`   | Romeno              | `ro`    |
| Armênio     | `hy`   | Hebraico  | `iw`   | Russo               | `ru`    |
| Basco       | `eu`   | Hindi     | `hi`   | Sérvio              | `sr`    |
| Bengali     | `bn`   | Húngaro   | `hu`   | Chinês Simplificado | `zh-CN` |
| Búlgaro     | `bg`   | Indonésio | `in`   | Eslovaco            | `sk`    |
| Catalão     | `ca`   | Italiano  | `it`   | Esloveno            | `sl`    |
| Croata      | `hr`   | Japonês   | `ja`   | Espanhol            | `es`    |
| Tcheco      | `cs`   | Canarês   | `kn`   | Sueco               | `sv`    |
| Dinamarquês | `da`   | Coreano   | `ko`   | Tâmil               | `ta`    |
| Holandês    | `nl`   | Letão     | `lv`   | Telugu              | `te`    |
| Inglês      | `en`   | Lituano   | `lt`   | Tailandês           | `th`    |
| Estoniano   | `et`   | Malaiala  | `ml`   | Chinês Tradicional  | `zh-TW` |
| Finlandês   | `fi`   | Marata    | `mr`   | Turco               | `tr`    |
| Francês     | `fr`   | Norueguês | `no`   | Ucraniano           | `uk`    |
| Alemão      | `de`   | Persa     | `fa`   | Urdu                | `ur`    |
| Georgiano   | `ka`   | Polonês   | `pl`   | Vietnamita          | `vi`    |

***

## Limitações da query

| Nível de acesso | Recent search    | Full-archive search |
| :-------------- | :--------------- | :------------------ |
| Self-serve      | 512 caracteres   | 1.024 caracteres    |
| Enterprise      | 4.096 caracteres | 4.096 caracteres    |

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Criar uma query" icon="https://mintcdn.com/x-preview/szd6PKNMlRQoyyAo/icons/xds/icon-filter.svg?fit=max&auto=format&n=szd6PKNMlRQoyyAo&q=85&s=5d59aff402c1f2aeae0e9e44bb23400e" href="/x-api/posts/search/integrate/build-a-query" width="24" height="24" data-path="icons/xds/icon-filter.svg">
    Aprenda a sintaxe de query e melhores práticas
  </Card>

  <Card title="Introdução ao Search" icon="https://mintcdn.com/x-preview/cfyQtgCdwk8p69aa/icons/xds/icon-search.svg?fit=max&auto=format&n=cfyQtgCdwk8p69aa&q=85&s=8c11ad89387b7c09ced1553d5c232834" href="/x-api/posts/search/introduction" width="24" height="24" data-path="icons/xds/icon-search.svg">
    Comece com o Search
  </Card>

  <Card title="Query Builder Tool" icon="wrench" href="https://developer.x.com/apitools/query?query=">
    Crie e teste queries interativamente
  </Card>
</CardGroup>
