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

# Post Counts

> Los endpoints de Post counts devuelven el volumen de Posts que coinciden con una consulta a lo largo del tiempo, sin devolver los propios Posts. Referencia del nivel estándar de X API v2 sobre counts.

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 Post counts devuelven el volumen de Posts que coinciden con una consulta a lo largo del tiempo, sin devolver los propios Posts. Utiliza estos endpoints para analizar tendencias, comprender el tamaño de una conversación y refinar consultas antes de realizar búsquedas.

## Descripción general

<CardGroup cols={2}>
  <Card title="Análisis de volumen" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-bar-chart.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=e2a41caa858b122416f0005a55a8f143" width="24" height="24" data-path="icons/xds/icon-bar-chart.svg">
    Construye líneas de tendencia y visualizaciones que muestran el volumen de Posts a lo largo del tiempo
  </Card>

  <Card title="Refinamiento de consultas" icon="https://mintcdn.com/x-preview/szd6PKNMlRQoyyAo/icons/xds/icon-filter.svg?fit=max&auto=format&n=szd6PKNMlRQoyyAo&q=85&s=5d59aff402c1f2aeae0e9e44bb23400e" width="24" height="24" data-path="icons/xds/icon-filter.svg">
    Estima el tamaño del resultado antes de ejecutar consultas de búsqueda completas
  </Card>

  <Card title="Detección de eventos" icon="calendar">
    Identifica cuándo alcanzaron su pico las conversaciones en torno a eventos
  </Card>

  <Card title="Investigación eficiente" icon="gauge-high">
    Comprende la escala de una conversación sin recuperar todos los Posts
  </Card>
</CardGroup>

***

## Endpoints

| Endpoint                                                                | Description                            | Access                    |
| :---------------------------------------------------------------------- | :------------------------------------- | :------------------------ |
| GET [`/2/tweets/counts/recent`](/x-api/posts/get-count-of-recent-posts) | Cuenta los Posts de los últimos 7 días | Todos los desarrolladores |
| GET [`/2/tweets/counts/all`](/x-api/posts/get-count-of-all-posts)       | Cuenta los Posts del archivo completo  | Pay-per-use, Enterprise   |

***

## Opciones de granularidad

Especifica cómo se agrupan los recuentos utilizando el parámetro `granularity`:

| Granularity | Description                         | Use case                      |
| :---------- | :---------------------------------- | :---------------------------- |
| `minute`    | Recuentos por minuto                | Monitorización en tiempo real |
| `hour`      | Recuentos por hora (predeterminado) | Análisis diario               |
| `day`       | Recuentos por día                   | Tendencias a largo plazo      |

***

## Recent counts

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

### Características

* Recuentos agrupados por minuto, hora o día
* Los mismos operadores de consulta que recent search
* Longitud de consulta de 512 caracteres

### Ejemplo de respuesta

```json theme={null}
{
  "data": [
    { "start": "2024-01-15T00:00:00.000Z", "end": "2024-01-15T01:00:00.000Z", "tweet_count": 1523 },
    { "start": "2024-01-15T01:00:00.000Z", "end": "2024-01-15T02:00:00.000Z", "tweet_count": 1247 },
    { "start": "2024-01-15T02:00:00.000Z", "end": "2024-01-15T03:00:00.000Z", "tweet_count": 892 }
  ],
  "meta": {
    "total_tweet_count": 3662
  }
}
```

<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/counts/quickstart/recent-tweet-counts" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    Realiza tu primera solicitud de recent counts
  </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/get-count-of-recent-posts" width="24" height="24" data-path="icons/xds/icon-code.svg">
    Documentación completa del endpoint
  </Card>
</CardGroup>

***

## Full-archive counts

Cuenta los Posts del **archivo completo** hasta 2006.

<Note>
  Los full-archive counts están disponibles para clientes pay-per-use y Enterprise.
</Note>

### Características

* Cuenta Posts históricos de cualquier período de tiempo
* Todos los operadores de consulta disponibles
* Longitud de consulta de 1,024 caracteres (4,096 para Enterprise)

### Paginación

Los resultados paginan con 31 días por respuesta:

* **Granularidad de día**: 31 días por página
* **Granularidad de hora**: 744 horas (31 días) por página
* **Granularidad de minuto**: 44,640 minutos (31 días) por página

<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/counts/quickstart/full-archive-tweet-counts" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    Realiza tu primera solicitud de full-archive counts
  </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/get-count-of-all-posts" width="24" height="24" data-path="icons/xds/icon-code.svg">
    Documentación completa del endpoint
  </Card>
</CardGroup>

***

## Operadores de consulta

Post counts usa la misma sintaxis de consulta que los endpoints de search:

```
python lang:en -is:retweet
```

<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/counts/integrate/build-a-query" width="24" height="24" data-path="icons/xds/icon-search.svg">
  Aprende la sintaxis y los operadores de consulta
</Card>

***

## Notas importantes

<Note>
  **Counts vs resultados de búsqueda**

  Los recuentos pueden no coincidir exactamente con los resultados de búsqueda. Los endpoints de búsqueda aplican filtrado de cumplimiento adicional que los endpoints de counts no realizan.
</Note>

***

## 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
  * El [Bearer Token](/resources/fundamentals/authentication) de tu App
</Note>

<CardGroup cols={2}>
  <Card title="Quickstart de recent counts" icon="clock" href="/x-api/posts/counts/quickstart/recent-tweet-counts">
    Cuenta Posts de los últimos 7 días
  </Card>

  <Card title="Quickstart de full-archive" icon="vault" href="/x-api/posts/counts/quickstart/full-archive-tweet-counts">
    Cuenta Posts históricos
  </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/counts/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>
