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

# Python XDK

> Instala y usa la biblioteca cliente oficial Python XDK para la X API v2, incluyendo la configuración de autenticación, solicitudes paginadas y ejemplos de streaming.

El [Python XDK](https://github.com/xdevplatform/xdk-py) es la biblioteca cliente oficial para la X API v2. Maneja la autenticación, la paginación y el streaming para que puedas centrarte en construir.

<Card title="Repositorio de GitHub" icon="github" href="https://github.com/xdevplatform/xdk-py">
  Código fuente, issues y releases.
</Card>

***

## Instalación

```bash theme={null}
pip install xdk
```

Requiere Python 3.8+.

***

## Guía rápida

```python theme={null}
from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Search for posts
for page in client.posts.search_recent(query="X API", max_results=10):
    if page.data and len(page.data) > 0:
        print(page.data[0].text)
        break
```

***

## Características clave

| Característica                   | Descripción                                                                      |
| :------------------------------- | :------------------------------------------------------------------------------- |
| **Soporte de OAuth**             | Bearer Token, OAuth 2.0 con PKCE y OAuth 1.0a                                    |
| **Paginación automática**        | Itera a través de los resultados sin manejar `next_token` manualmente            |
| **Streaming**                    | Datos en tiempo real a través de conexiones persistentes (filtered stream, etc.) |
| **Cobertura completa de la API** | Todos los endpoints de la X API v2 — búsqueda, timelines, filtered stream y más  |

***

## Autenticación

<Tabs>
  <Tab title="Bearer Token">
    ```python theme={null}
    from xdk import Client

    client = Client(bearer_token="YOUR_BEARER_TOKEN")
    ```
  </Tab>

  <Tab title="OAuth 2.0">
    ```python theme={null}
    from xdk import Client
    from xdk.oauth2_auth import OAuth2PKCEAuth

    auth = OAuth2PKCEAuth(
        client_id="YOUR_CLIENT_ID",
        redirect_uri="YOUR_CALLBACK_URL",
        scope="tweet.read users.read offline.access"
    )

    auth_url = auth.get_authorization_url()
    tokens = auth.fetch_token(authorization_response=callback_url)
    client = Client(bearer_token=tokens["access_token"])
    ```
  </Tab>

  <Tab title="OAuth 1.0a">
    ```python theme={null}
    from xdk import Client
    from xdk.oauth1_auth import OAuth1

    oauth1 = OAuth1(
        api_key="YOUR_API_KEY",
        api_secret="YOUR_API_SECRET",
        access_token="YOUR_ACCESS_TOKEN",
        access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
    )

    client = Client(auth=oauth1)
    ```
  </Tab>
</Tabs>

***

## Métodos comunes

| Categoría  | Método                         |
| :--------- | :----------------------------- |
| **Posts**  | `client.posts.search_recent()` |
| **Users**  | `client.users.get_me()`        |
| **Spaces** | `client.spaces.get()`          |
| **Lists**  | `client.lists.get()`           |
| **DMs**    | `client.direct_messages.get()` |

***

## Más información

<CardGroup cols={2}>
  <Card title="Instalación" icon="download" href="/xdks/python/install">
    Instalación de desarrollo, requisitos previos y verificación.
  </Card>

  <Card title="Guía rápida" icon="rocket" href="/xdks/python/quickstart">
    Recorrido paso a paso de tu primera solicitud.
  </Card>

  <Card title="Autenticación" icon="key" href="/xdks/python/authentication">
    Guía detallada para todos los métodos de autenticación.
  </Card>

  <Card title="Paginación" icon="arrows-left-right" href="/xdks/python/pagination">
    Paginación automática e iteradores.
  </Card>

  <Card title="Streaming" icon="satellite-dish" href="/xdks/python/streaming">
    Datos en tiempo real a través de filtered stream.
  </Card>

  <Card title="Referencia de la API" icon="book" href="/xdks/python/reference/modules">
    Referencia completa del cliente y los modelos.
  </Card>
</CardGroup>

Para ver ejemplos de código, consulta el [repositorio de ejemplos](https://github.com/xdevplatform/samples/tree/main/python).