xdk

What it is and what it does

XDK is a Python SDK for the X API that wraps OAuth-authenticated HTTP requests into a typed client interface. It provides methods to fetch posts by ID, search recent posts, and create new posts, with support for Python 3.8 through 3.12. The package depends on pydantic for validation, requests for HTTP, and requests-oauthlib for OAuth credential handling.

The SDK is in alpha status and actively maintained, with a growing user base. It abstracts away the details of constructing X API requests and managing OAuth tokens, letting developers focus on application logic rather than authentication plumbing.

Use it for:

• Fetch and analyze posts from X by ID in a Python application
• Search for recent posts matching a query and process results programmatically
• Publish posts to X from an automated workflow or bot
• Build a Python application that reads and writes to X without manual HTTP request construction

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python SDK for interacting with the X API, providing typed client methods to retrieve, search, and create posts with OAuth authentication.

Yes, if you need to interact with the X API from Python. The package has low install friction, permissive licensing, no known vulnerabilities, and active maintenance. The alpha status and small user base mean edge cases may not be fully tested; verify that it covers the API endpoints you need before committing to it in production.

Install

xdk on PyPI

pip install xdk

uv add xdk

poetry add xdk

Installing xdk

Before you install

Low install friction; pure Python wheel with three common dependencies (pydantic, requests, requests-oauthlib). Active maintenance with a release 20 days old and recent commits.

License in practice

MIT license (permissive) means you can use, modify, and distribute this package with minimal restrictions in commercial or private projects.

Quickstart

pip install xdk

from xdk import Client

client = Client(
    api_key="your_api_key",
    api_secret="your_api_secret",
    access_token="your_access_token",
    access_token_secret="your_access_token_secret"
)

posts = client.posts.get(ids=["1234567890"])

Requires valid X API credentials (API key, secret, and OAuth tokens) to authenticate.

Verify before relying

• Whether the SDK covers the full X API v2 surface or a subset of endpoints
• Whether rate-limiting or retry logic is built in or left to the caller
• Whether the package is officially maintained by X Corp or a third party

Package facts

Evidence: xdk-0.10.6-py3-none-any.whl

Tags

More WWW/HTTP packages