Início rápido

​

Passo 1: Instale o SDK

pip install xdk

​

Passo 2: Obtenha seu Bearer Token

1. Faça login no Console do desenvolvedor da X.
2. Crie ou selecione um app.
3. Em “Keys and Tokens”, gere um Bearer Token (autenticação apenas de app).

​

Passo 3: Escreva e execute seu primeiro script

# Import the client
from xdk import Client
# Replace with your actual Bearer Token
client = Client(bearer_token="YOUR_BEARER_TOKEN_HERE")
# Fetch recent Posts mentioning "api"
# search_recent returns an Iterator, so iterate over it
for page in client.posts.search_recent(query="api", max_results=10):
    if page.data and len(page.data) > 0:
        # Access first Post - Pydantic models support both attribute and dict access
        first_post = page.data[0]
        post_text = first_post.text if hasattr(first_post, 'text') else first_post.get('text', '')
        print(f"Latest Post: {post_text}")
        break
    else:
        print("No Posts found.")
        break

python quickstart.py

Latest Post: Exciting updates on XDK Python SDK!

​

Próximos passos

• Explore Autenticação para entender como usar autenticação por Bearer Token (apenas de app), OAuth 2.0 com PKCE (contexto de usuário) e OAuth 1.0a (contexto de usuário legado).
• Saiba mais sobre Paginação para casos de uso em que você deseja um grande número de resultados retornados sem se preocupar em fazer múltiplas chamadas de API.
• Aprofunde-se em Streaming para aprender a trabalhar com dados em tempo real. Para exemplos de código detalhados usando o XDK Python, confira nosso repositório de exemplos de código no GitHub.