> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso

> Supervisa el uso de tu API y realiza un seguimiento del consumo de Publicaciones

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <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>;
};

El endpoint Usage te permite supervisar el uso de la API, incluido el número de Publicaciones consumidas. Controla tu uso de forma programática para gestionar los costos y mantenerte dentro de los límites.

<div id="overview">
  ## Descripción general
</div>

<CardGroup cols={2}>
  <Card title="Uso de Publicaciones" icon="chart-simple">
    Realiza un seguimiento de las Publicaciones consumidas
  </Card>

  <Card title="Desglose diario" icon="calendar-days">
    Ver el uso por día
  </Card>

  <Card title="A nivel de App" icon="gauge">
    Supervisa el uso en tu App
  </Card>
</CardGroup>

***

<div id="endpoint">
  ## Endpoint
</div>

| Método | Endpoint                                       | Descripción                           |
| :----- | :--------------------------------------------- | :------------------------------------ |
| GET    | [`/2/usage/tweets`](/es/x-api/usage/get-usage) | Obtener datos de uso de publicaciones |

***

<div id="response-data">
  ## Datos de la respuesta
</div>

La respuesta incluye recuentos diarios del consumo de Publicaciones:

```json theme={null}
{
  "data": {
    "daily_project_usage": [
      {
        "date": "2024-01-15",
        "usage": [
          {
            "app_id": "12345678",
            "tweets_consumed": 15420
          }
        ]
      }
    ],
    "project_id": "1234567890",
    "project_cap": 10000000
  }
}
```

<div id="fields">
  ### Campos
</div>

| Campo                 | Descripción                        |
| :-------------------- | :--------------------------------- |
| `daily_project_usage` | Array de datos de uso diario       |
| `date`                | Fecha en formato YYYY-MM-DD        |
| `app_id`              | ID de tu App                       |
| `tweets_consumed`     | Publicaciones consumidas ese día   |
| `project_cap`         | Tu límite mensual de Publicaciones |

***

<div id="example-request">
  ## Ejemplo de solicitud
</div>

```bash theme={null}
curl "https://api.x.com/2/usage/tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"
```

***

<div id="use-cases">
  ## Casos de uso
</div>

* **Supervisión de costos** — Realiza un seguimiento del consumo respecto a los límites de tu plan
* **Alertas** — Configura alertas cuando te acerques a los límites
* **Optimización** — Identifica endpoints con alto consumo
* **Generación de informes** — Genera informes de uso

<Tip>
  Los recursos se deduplican dentro de una ventana de 24 horas en UTC, por lo que solicitar el mismo recurso varias veces en un día solo cuenta como un único cargo. [Más información sobre precios →](/es/x-api/getting-started/pricing)
</Tip>

***

<div id="getting-started">
  ## Primeros pasos
</div>

<Note>
  **Requisitos previos**

  * Una [cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) aprobada
  * Un [Proyecto y App](/es/resources/fundamentals/developer-apps) en la Consola de desarrollador
  * El [Bearer Token](/es/resources/fundamentals/authentication) de tu App
</Note>

<CardGroup cols={2}>
  <Card title="Referencia de la API" icon="code" href="/es/x-api/usage/post-usage">
    Documentación completa de endpoints
  </Card>

  <Card title="Consola de desarrollador" icon="gauge" href="https://developer.x.com/en/portal/dashboard">
    Ver el uso en el panel de control
  </Card>
</CardGroup>