Python XDK

El Python XDK 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.

Repositorio de GitHub

Código fuente, issues y releases.

Instalación

pip install xdk

Requiere Python 3.8+.

Guía rápida

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

Bearer Token
OAuth 2.0
OAuth 1.0a

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

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"])

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)

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

Instalación

Instalación de desarrollo, requisitos previos y verificación.

Guía rápida

Recorrido paso a paso de tu primera solicitud.

Autenticación

Guía detallada para todos los métodos de autenticación.

Paginación

Paginación automática e iteradores.

Streaming

Datos en tiempo real a través de filtered stream.

Referencia de la API

Referencia completa del cliente y los modelos.

Para ver ejemplos de código, consulta el repositorio de ejemplos.

Repositorio de GitHub

​Instalación

​Guía rápida

​Características clave

​Autenticación

​Métodos comunes

​Más información

Instalación

Guía rápida

Autenticación

Paginación

Streaming

Referencia de la API

Instalación

Guía rápida

Características clave

Autenticación

Métodos comunes

Más información