Python XDK

Python XDK는 X API v2의 공식 클라이언트 라이브러리입니다. 인증, 페이지네이션 및 스트리밍을 처리하므로 구축에 집중할 수 있습니다.

GitHub 저장소

소스 코드, 이슈 및 릴리스.

설치

pip install xdk

Python 3.8+가 필요합니다.

빠른 시작

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

주요 기능

기능	설명
OAuth 지원	Bearer Token, PKCE가 포함된 OAuth 2.0, OAuth 1.0a
자동 페이지네이션	수동 `next_token` 처리 없이 결과 반복
스트리밍	지속적 연결을 통한 실시간 데이터(filtered stream 등)
전체 API 지원	모든 X API v2 엔드포인트 — 검색, 타임라인, filtered stream 등

인증

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)

일반적인 메서드

카테고리	메서드
Posts	`client.posts.search_recent()`
Users	`client.users.get_me()`
Spaces	`client.spaces.get()`
Lists	`client.lists.get()`
DMs	`client.direct_messages.get()`

자세히 알아보기

설치

개발 설치, 사전 요구 사항 및 검증.

빠른 시작

첫 요청 단계별 워크스루.

인증

모든 인증 방법에 대한 자세한 가이드.

페이지네이션

자동 페이지네이션 및 반복자.

스트리밍

filtered stream을 통한 실시간 데이터.

API 레퍼런스

전체 클라이언트 및 모델 레퍼런스.

코드 예제는 samples 저장소를 참조하세요.

GitHub 저장소

​설치

​빠른 시작

​주요 기능

​인증

​일반적인 메서드

​자세히 알아보기

설치

빠른 시작

인증

페이지네이션

스트리밍

API 레퍼런스

설치

빠른 시작

주요 기능

인증

일반적인 메서드

자세히 알아보기