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

# Acerca de la API de X

> La API de X ofrece acceso programático a la conversación pública. Recupera posts, analiza tendencias, crea integraciones y nuevas experiencias en X.

La API de X proporciona acceso programático a la conversación pública de X. Recupera publicaciones, analiza tendencias, crea integraciones y diseña nuevas experiencias en la plataforma.

***

## Qué puedes hacer

| Capacidad                | Descripción                                                     |
| :----------------------- | :-------------------------------------------------------------- |
| **Leer publicaciones**   | Busca, consulta y transmite publicaciones en tiempo real        |
| **Publicar contenido**   | Crea publicaciones, respuestas e hilos                          |
| **Administrar usuarios** | Consulta usuarios y gestiona seguimientos, bloqueos y silencios |
| **Analizar datos**       | Accede a métricas, tendencias y análisis de interacción         |
| **Crear integraciones**  | Envía DMs, administra listas e interactúa con Spaces            |

***

## Versiones de la API

<Tabs>
  <Tab title="X API v2 (Recommended)">
    La versión actual de la API de X con funciones modernas y precios flexibles.

    **Por qué usar v2:**

    * Precios de pago por uso
    * Formato de respuesta JSON moderno
    * [Fields](/x-api/fundamentals/fields) y [expansions](/x-api/fundamentals/expansions) flexibles
    * Funciones avanzadas: anotaciones, seguimiento de conversaciones, historial de ediciones
    * Todos los nuevos endpoints y funciones

    **Primeros pasos:**

    1. Regístrate en [console.x.com](https://console.x.com)
    2. Crea una app y obtén tus credenciales
    3. [Realiza tu primera solicitud](/x-api/getting-started/make-your-first-request)
  </Tab>

  <Tab title="X API v1.1 (Legacy)">
    La versión anterior de la API de X. Soporte limitado; usa v2 para nuevos proyectos.

    **Aún disponible:**

    * Algunos endpoints de carga de medios
    * Streaming heredado (en desuso)
    * Algunos endpoints especializados

    **Migrar a v2:**
    Consulta la [guía de migración](/x-api/migrate/overview) para conocer la asignación de endpoints y los cambios de formato de datos.
  </Tab>
</Tabs>

***

## Recursos disponibles

La API de X proporciona acceso a estos tipos de recursos:

<CardGroup cols={3}>
  <Card title="Publicaciones" icon="message">
    Busca, recupera, crea y elimina publicaciones. Accede a líneas de tiempo, hilos y citas.
  </Card>

  <Card title="Usuarios" icon="user">
    Consulta perfiles, gestiona relaciones y accede a datos de seguidores.
  </Card>

  <Card title="Spaces" icon="microphone">
    Descubre conversaciones de audio en vivo y sus participantes.
  </Card>

  <Card title="Mensajes directos" icon="envelope">
    Envía y recibe mensajes privados entre usuarios.
  </Card>

  <Card title="Listas" icon="list">
    Crea y administra listas seleccionadas de cuentas.
  </Card>

  <Card title="Tendencias" icon="arrow-trend-up">
    Accede a temas en tendencia por ubicación.
  </Card>
</CardGroup>

***

## Aspectos destacados de v2

<Accordion title="Fields y expansions">
  Solicita únicamente los datos que necesitas. Usa los parámetros `fields` para seleccionar atributos específicos y `expansions` para incluir objetos relacionados.

  ```bash theme={null}
  curl "https://api.x.com/2/tweets/123?tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=username" \
    -H "Authorization: Bearer $TOKEN"
  ```

  [Más información sobre fields →](/x-api/fundamentals/fields)
</Accordion>

<Accordion title="Anotaciones de publicaciones">
  Las publicaciones incluyen anotaciones semánticas que identifican personas, lugares, productos y temas. Filtra streams y búsquedas por tema.

  [Más información sobre anotaciones →](/x-api/fundamentals/post-annotations)
</Accordion>

<Accordion title="Métricas de interacción">
  Accede a métricas públicas (me gusta, reposts, respuestas) y a métricas privadas (impresiones, clics) de tus propias publicaciones.

  [Más información sobre métricas →](/x-api/fundamentals/metrics)
</Accordion>

<Accordion title="Seguimiento de conversaciones">
  Reconstruye hilos de conversación completos usando `conversation_id`. Realiza un seguimiento de las respuestas a lo largo de todo el hilo.

  [Más información sobre el seguimiento de conversaciones →](/x-api/fundamentals/conversation-id)
</Accordion>

<Accordion title="Historial de ediciones">
  Accede al historial de ediciones de las publicaciones, incluidas todas las versiones anteriores y los metadatos de edición.

  [Más información sobre la edición de publicaciones →](/x-api/fundamentals/edit-posts)
</Accordion>

***

## Precios

X API v2 utiliza precios de **pago por uso**:

| Beneficio                      | Descripción                                                             |
| :----------------------------- | :---------------------------------------------------------------------- |
| **Sin suscripciones**          | Paga solo por lo que usas                                               |
| **Basado en créditos**         | Compra créditos que se descuentan por solicitud                         |
| **Seguimiento en tiempo real** | Monitorea el uso en la Developer Console                                |
| **Deduplicación**              | El mismo recurso solicitado dos veces en 24 horas solo se cobra una vez |

[Ver detalles de precios →](/x-api/getting-started/pricing)

***

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Obtener acceso" icon="key" href="/x-api/getting-started/getting-access">
    Regístrate y crea tu primera app.
  </Card>

  <Card title="Realizar tu primera solicitud" icon="rocket" href="/x-api/getting-started/make-your-first-request">
    Llama a la API en minutos.
  </Card>
</CardGroup>
