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

> Los endpoints de Search Posts te permiten encontrar Posts que coincidan con criterios específicos usando potentes consultas. Referencia del nivel estándar de 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>;
};

Los endpoints de Search Posts te permiten encontrar Posts que coincidan con criterios específicos usando potentes operadores de consulta. Busca palabras clave, hashtags, menciones, URLs y más.

## Descripción general

X ofrece dos endpoints de búsqueda con diferentes rangos de tiempo y requisitos de acceso:

<CardGroup cols={2}>
  <Card title="Recent Search" icon="clock">
    Busca Posts de los **últimos 7 días**. Disponible para todos los desarrolladores.
  </Card>

  <Card title="Full-Archive Search" icon="vault">
    Busca en el **archivo completo** hasta 2006. Disponible para clientes pay-per-use y Enterprise.
  </Card>
</CardGroup>

***

## Casos de uso

* **Monitorización de marca** — realiza seguimiento de menciones de tu marca o productos
* **Análisis de tendencias** — analiza conversaciones sobre temas o eventos
* **Investigación** — recopila datos para investigación académica o de mercado
* **Escucha en tiempo real** — construye aplicaciones que reaccionen a nuevos Posts

***

## Endpoints

| Method | Endpoint                                                      | Description                           | Access                    |
| :----- | :------------------------------------------------------------ | :------------------------------------ | :------------------------ |
| GET    | [`/2/tweets/search/recent`](/x-api/posts/search-recent-posts) | Busca Posts de los últimos 7 días     | Todos los desarrolladores |
| GET    | [`/2/tweets/search/all`](/x-api/posts/search-all-posts)       | Busca en el archivo completo de Posts | Pay-per-use, Enterprise   |

***

## Operadores de consulta

Construye consultas usando operadores que coincidan con atributos de Post:

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

<AccordionGroup>
  <Accordion title="Operadores de palabra clave">
    | Operator | Example              | Description                                 |
    | :------- | :------------------- | :------------------------------------------ |
    | Keyword  | `python`             | Coincide con Posts que contienen la palabra |
    | Phrase   | `"machine learning"` | Coincide con la frase exacta                |
    | Hashtag  | `#AI`                | Coincide con Posts que tienen el hashtag    |
    | Mention  | `@XDevelopers`       | Coincide con Posts que mencionan al usuario |
  </Accordion>

  <Accordion title="Operadores de usuario">
    | Operator       | Example          | Description                         |
    | :------------- | :--------------- | :---------------------------------- |
    | `from:`        | `from:elonmusk`  | Posts de un usuario                 |
    | `to:`          | `to:XDevelopers` | Respuestas a un usuario             |
    | `retweets_of:` | `retweets_of:X`  | Retweets de los Posts de un usuario |
  </Accordion>

  <Accordion title="Operadores de contenido">
    | Operator       | Example          | Description              |
    | :------------- | :--------------- | :----------------------- |
    | `has:images`   | `cat has:images` | Posts con imágenes       |
    | `has:videos`   | `has:videos`     | Posts con videos         |
    | `has:links`    | `has:links`      | Posts con enlaces        |
    | `has:mentions` | `has:mentions`   | Posts con menciones      |
    | `url:`         | `url:github.com` | Posts con URL específica |
  </Accordion>

  <Accordion title="Operadores de filtro">
    | Operator      | Example       | Description                   |
    | :------------ | :------------ | :---------------------------- |
    | `lang:`       | `lang:en`     | Posts en un idioma            |
    | `-is:retweet` | `-is:retweet` | Excluir retweets              |
    | `-is:reply`   | `-is:reply`   | Excluir respuestas            |
    | `is:verified` | `is:verified` | Posts de usuarios verificados |
  </Accordion>
</AccordionGroup>

<Card title="Referencia completa de operadores" icon="list-check" href="/x-api/posts/search/integrate/operators">
  Consulta todos los operadores disponibles y sus requisitos de acceso
</Card>

***

## Recent Search

Busca Posts de los **últimos 7 días**. Disponible para todos los desarrolladores.

### Características

* Hasta 100 Posts por solicitud
* Paginación para conjuntos de resultados grandes
* Todos los operadores de consulta core
* Longitud de consulta 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">
    Realiza tu primera solicitud de recent search
  </Card>

  <Card title="Referencia de la 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">
    Documentación completa del endpoint
  </Card>
</CardGroup>

***

## Full-Archive Search

Busca en el **archivo completo de Posts** que se remonta hasta marzo de 2006.

<Note>
  Full-archive search está disponible para clientes pay-per-use y Enterprise.
</Note>

### Características

* Hasta 500 Posts por solicitud
* Acceso al historial completo de Posts
* Todos los operadores de consulta disponibles
* Longitud de consulta 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">
    Realiza tu primera solicitud de full-archive search
  </Card>

  <Card title="Referencia de la 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">
    Documentación completa del endpoint
  </Card>
</CardGroup>

***

## Cómo empezar

<Note>
  **Requisitos previos**

  * Una [cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) aprobada
  * Un [Project y App](/resources/fundamentals/developer-apps) en la Developer Console
  * Las [keys y tokens](/resources/fundamentals/authentication) de tu App
</Note>

<CardGroup cols={2}>
  <Card title="Construir una consulta" 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">
    Aprende la sintaxis y los operadores de consulta
  </Card>

  <Card title="Paginación" 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">
    Navega por conjuntos de resultados grandes
  </Card>

  <Card title="Guía de integración" 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">
    Conceptos clave y mejores prácticas
  </Card>

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