메인 콘텐츠로 건너뛰기
이 예제에서는 XDK를 사용해 Bearer 토큰 인증 방식으로 포스트를 빠르게 검색하는 방법을 보여줍니다.

​
1단계: SDK 설치하기

pip install xdk

​
2단계: Bearer 토큰 발급받기

  1. X 개발자 콘솔에 로그인합니다.
  2. 새 App을 생성하거나 App을 선택합니다.
  3. “Keys and Tokens”에서 app-only 인증용 Bearer 토큰을 생성합니다.

​
3단계: 첫 번째 스크립트 작성하고 실행하기

quickstart.py 파일을 생성합니다: 
# Client 가져오기
from xdk import Client
# 실제 Bearer 토큰으로 교체
client = Client(bearer_token="YOUR_BEARER_TOKEN_HERE")
# "api"를 언급하는 최근 포스트 가져오기
# search_recent는 Iterator를 반환하므로 반복 처리
for page in client.posts.search_recent(query="api", max_results=10):
    if page.data and len(page.data) > 0:
        # 첫 번째 포스트에 접근 - Pydantic 모델은 속성 및 딕셔너리 접근을 모두 지원
        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("포스트를 찾을 수 없습니다.")
        break
실행하세요: 
python quickstart.py
예상 출력: 
최신 게시물: XDK Python SDK에 대한 흥미로운 업데이트!
문제 해결: 401 오류가 발생하면 Bearer 토큰을 다시 확인하세요. 요청 한도(429) 오류인 경우, 잠시 기다렸다가 다시 시도하세요.

​
다음 단계

  • Authentication을 살펴보고 Bearer 토큰(App 전용) 인증, PKCE를 사용하는 OAuth 2.0(사용자 컨텍스트), OAuth 1.0a(레거시 사용자 컨텍스트)를 어떻게 사용하는지 이해하세요.
  • 여러 번 API 호출을 하지 않고도 대량의 결과를 반환받고자 할 때 활용하는 Pagination에 대해 알아보세요.
  • 실시간 데이터를 다루는 방법을 배우기 위해 Streaming을 살펴보세요. Python XDK를 사용하는 상세 코드 예시는 코드 샘플 GitHub 저장소를 확인하세요.