Python XDK

O Python XDK é a biblioteca cliente oficial para a X API v2. Ele cuida de autenticação, paginação e streaming, para que você possa focar em construir.

Repositório no GitHub

Código-fonte, issues e releases.

Instalação

pip install xdk

Requer Python 3.8+.

Início rápido

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

Principais recursos

Recurso	Descrição
Suporte a OAuth	Bearer Token, OAuth 2.0 com PKCE e OAuth 1.0a
Paginação automática	Itere pelos resultados sem manipular `next_token` manualmente
Streaming	Dados em tempo real via conexões persistentes (filtered stream etc.)
Cobertura completa da API	Todos os endpoints da X API v2 — search, timelines, filtered stream e muito mais

Autenticação

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 comuns

Categoria	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()`

Saiba mais

Instalação

Instalação de desenvolvimento, pré-requisitos e verificação.

Início rápido

Passo a passo da primeira solicitação.

Autenticação

Guia detalhado para todos os métodos de autenticação.

Paginação

Paginação automática e iteradores.

Streaming

Dados em tempo real via filtered stream.

Referência da API

Referência completa de cliente e modelos.

Para ver exemplos de código, confira o repositório de samples.

Repositório no GitHub

​Instalação

​Início rápido

​Principais recursos

​Autenticação

​Métodos comuns

​Saiba mais

Instalação

Início rápido

Autenticação

Paginação

Streaming

Referência da API

Instalação

Início rápido

Principais recursos

Autenticação

Métodos comuns

Saiba mais