활동 스트림

실시간 계정 활동 이벤트 스트리밍

Activity Stream 엔드포인트는 구독한 사용자 계정의 활동 이벤트를 실시간으로 제공합니다. 사용자가 게시물을 작성하거나, 좋아요를 누르거나, 팔로우하거나, DM을 받는 등의 이벤트를 수신할 수 있습니다.

​

개요

실시간

이벤트가 실시간으로 전달됩니다

종합적

포스트, 좋아요, 팔로우, DM 등

구독형

사용자 활동을 구독합니다

Webhook 전달

이벤트가 서버로 전달됩니다

---

​

이벤트 유형

Event	Description
tweet_create_events	사용자가 새 게시물을 게시함
favorite_events	사용자가 게시물에 좋아요를 누름
follow_events	사용자가 다른 사용자를 팔로우하거나 팔로우됨
direct_message_events	사용자가 DM을 보내거나 받음
block_events	사용자가 다른 사용자를 차단하거나 차단 해제함
mute_events	사용자가 다른 사용자를 뮤트하거나 뮤트 해제함

---

​

엔드포인트

Method	Endpoint	Description
GET	/2/activity/stream	액티비티 스트림에 연결
POST	/2/activity/subscriptions	구독 생성
GET	/2/activity/subscriptions	구독 목록 조회
PUT	/2/activity/subscriptions/:id	구독 업데이트
DELETE	/2/activity/subscriptions/:id	구독 삭제

---

​

동작 방식

1. 구독 생성 — 사용자의 활동을 구독합니다
2. 스트림에 연결 — 지속적인 연결을 설정합니다
3. 이벤트 수신 — 실시간 활동 이벤트를 받습니다
4. 이벤트 처리 — 애플리케이션에서 이벤트를 처리합니다

---

​

예제: 스트림에 연결하기

import requests

def stream_activity(bearer_token):
    url = "https://api.x.com/2/activity/stream"
    headers = {"Authorization": f"Bearer {bearer_token}"}
    
    response = requests.get(url, headers=headers, stream=True)
    
    for line in response.iter_lines():
        if line:
            print(line.decode("utf-8"))

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 Project 및 App
• App의 Bearer 토큰

빠른 시작

첫 구독을 설정하세요

Account Activity API

Webhook 기반 대체 방식

API 참조 문서

전체 엔드포인트에 대한 문서