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

# Search Posts

> Os endpoints Search Posts permitem encontrar Posts que correspondem a critérios específicos usando poderosos operadores de query. Referência para o tier standard da X API v2 sobre search.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

Os endpoints Search Posts permitem encontrar Posts que correspondem a critérios específicos usando poderosos operadores de query. Pesquise por palavras-chave, hashtags, menções, URLs e muito mais.

## Visão geral

A X oferece dois endpoints de busca com diferentes intervalos de tempo e requisitos de acesso:

<CardGroup cols={2}>
  <Card title="Recent Search" icon="clock">
    Pesquise Posts dos **últimos 7 dias**. Disponível para todos os desenvolvedores.
  </Card>

  <Card title="Full-Archive Search" icon="vault">
    Pesquise o **arquivo completo** desde 2006. Disponível para clientes pay-per-use e Enterprise.
  </Card>
</CardGroup>

***

## Casos de uso

* **Monitoramento de marca** — Acompanhe menções da sua marca ou produtos
* **Análise de tendências** — Analise conversas em torno de tópicos ou eventos
* **Pesquisa** — Colete dados para pesquisa acadêmica ou de mercado
* **Escuta em tempo real** — Construa aplicações que reagem a novos Posts

***

## Endpoints

| Método | Endpoint                                                      | Descrição                             | Acesso                   |
| :----- | :------------------------------------------------------------ | :------------------------------------ | :----------------------- |
| GET    | [`/2/tweets/search/recent`](/x-api/posts/search-recent-posts) | Pesquisar Posts dos últimos 7 dias    | Todos os desenvolvedores |
| GET    | [`/2/tweets/search/all`](/x-api/posts/search-all-posts)       | Pesquisar o arquivo completo de Posts | Pay-per-use, Enterprise  |

***

## Operadores de query

Crie queries usando operadores que correspondem a atributos de Post:

```
(AI OR "artificial intelligence") lang:en -is:retweet has:links
```

<AccordionGroup>
  <Accordion title="Operadores de palavra-chave">
    | Operador      | Exemplo              | Descrição                                 |
    | :------------ | :------------------- | :---------------------------------------- |
    | Palavra-chave | `python`             | Corresponde a Posts que contêm a palavra  |
    | Frase         | `"machine learning"` | Corresponde à frase exata                 |
    | Hashtag       | `#AI`                | Corresponde a Posts com hashtag           |
    | Menção        | `@XDevelopers`       | Corresponde a Posts mencionando o usuário |
  </Accordion>

  <Accordion title="Operadores de usuário">
    | Operador       | Exemplo          | Descrição                        |
    | :------------- | :--------------- | :------------------------------- |
    | `from:`        | `from:elonmusk`  | Posts de um usuário              |
    | `to:`          | `to:XDevelopers` | Replies a um usuário             |
    | `retweets_of:` | `retweets_of:X`  | Retweets dos Posts de um usuário |
  </Accordion>

  <Accordion title="Operadores de conteúdo">
    | Operador       | Exemplo          | Descrição                |
    | :------------- | :--------------- | :----------------------- |
    | `has:images`   | `cat has:images` | Posts com imagens        |
    | `has:videos`   | `has:videos`     | Posts com vídeos         |
    | `has:links`    | `has:links`      | Posts com links          |
    | `has:mentions` | `has:mentions`   | Posts com menções        |
    | `url:`         | `url:github.com` | Posts com URL específica |
  </Accordion>

  <Accordion title="Operadores de filtro">
    | Operador      | Exemplo       | Descrição                     |
    | :------------ | :------------ | :---------------------------- |
    | `lang:`       | `lang:en`     | Posts em um idioma            |
    | `-is:retweet` | `-is:retweet` | Excluir retweets              |
    | `-is:reply`   | `-is:reply`   | Excluir replies               |
    | `is:verified` | `is:verified` | Posts de usuários verificados |
  </Accordion>
</AccordionGroup>

<Card title="Referência completa de operadores" icon="list-check" href="/x-api/posts/search/integrate/operators">
  Veja todos os operadores disponíveis e seus requisitos de acesso
</Card>

***

## Recent Search

Pesquise Posts dos **últimos 7 dias**. Disponível para todos os desenvolvedores.

### Recursos

* Até 100 Posts por requisição
* Paginação para grandes conjuntos de resultados
* Todos os operadores de query core
* Query de 512 caracteres (4.096 para Enterprise)

<CardGroup cols={2}>
  <Card title="Quickstart" icon="https://mintcdn.com/x-preview/oR-aRNyj1BKPJtxM/icons/xds/icon-rocket.svg?fit=max&auto=format&n=oR-aRNyj1BKPJtxM&q=85&s=b978d7a9225de31709efbbed5b84e92d" href="/x-api/posts/search/quickstart/recent-search" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    Faça sua primeira requisição de recent search
  </Card>

  <Card title="Referência da API" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-code.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=488e23401b19225b89acc0136d242219" href="/x-api/posts/search-recent-posts" width="24" height="24" data-path="icons/xds/icon-code.svg">
    Documentação completa do endpoint
  </Card>
</CardGroup>

***

## Full-Archive Search

Pesquise o **arquivo completo de Posts** desde março de 2006.

<Note>
  O full-archive search está disponível para clientes pay-per-use e Enterprise.
</Note>

### Recursos

* Até 500 Posts por requisição
* Acesso ao histórico completo de Posts
* Todos os operadores de query disponíveis
* Query de 1.024 caracteres (4.096 para Enterprise)

<CardGroup cols={2}>
  <Card title="Quickstart" icon="https://mintcdn.com/x-preview/oR-aRNyj1BKPJtxM/icons/xds/icon-rocket.svg?fit=max&auto=format&n=oR-aRNyj1BKPJtxM&q=85&s=b978d7a9225de31709efbbed5b84e92d" href="/x-api/posts/search/quickstart/full-archive-search" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    Faça sua primeira requisição de full-archive search
  </Card>

  <Card title="Referência da API" icon="https://mintcdn.com/x-preview/ygI6sSJPehlc0qNT/icons/xds/icon-code.svg?fit=max&auto=format&n=ygI6sSJPehlc0qNT&q=85&s=488e23401b19225b89acc0136d242219" href="/x-api/posts/search-all-posts" width="24" height="24" data-path="icons/xds/icon-code.svg">
    Documentação completa do endpoint
  </Card>
</CardGroup>

***

## Introdução

<Note>
  **Pré-requisitos**

  * Uma [conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info) aprovada
  * Um [Project e App](/resources/fundamentals/developer-apps) no Developer Console
  * As [chaves e tokens](/resources/fundamentals/authentication) do seu App
</Note>

<CardGroup cols={2}>
  <Card title="Criar uma query" 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/integrate/build-a-query" width="24" height="24" data-path="icons/xds/icon-search.svg">
    Aprenda a sintaxe de query e os operadores
  </Card>

  <Card title="Paginação" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-arrow-right.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=88e933002782dbdeb204043cedef033e" href="/x-api/posts/search/integrate/paginate" width="24" height="24" data-path="icons/xds/icon-arrow-right.svg">
    Navegue por grandes conjuntos de resultados
  </Card>

  <Card title="Guia de integração" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-book.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=22ac564792481d14ae36a941546039c8" href="/x-api/posts/search/integrate/overview" width="24" height="24" data-path="icons/xds/icon-book.svg">
    Conceitos-chave e melhores práticas
  </Card>

  <Card title="Código de exemplo" icon="github" href="https://github.com/xdevplatform/Twitter-API-v2-sample-code">
    Exemplos de código funcionais
  </Card>
</CardGroup>