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

​
개요

실시간

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

종합적

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

구독형

사용자 활동을 구독합니다

Webhook 전달

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

​
이벤트 유형

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

​
엔드포인트

MethodEndpointDescription
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"))

​
시작하기

사전 준비 사항

빠른 시작

첫 구독을 설정하세요

Account Activity API

Webhook 기반 대체 방식

API 참조 문서

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