profile.update.bio, post.create, post.delete 등 관심 있는 이벤트를 구독하고, 이벤트를 받고자 하는 사용자의 User ID로 필터링할 수 있습니다. 해당 User ID에 매칭되는 이벤트는 1초 미만의 지연 시간으로 앱에 전달됩니다.
전달 메커니즘
X Activity API는 현재 이벤트를 앱으로 전송하기 위해 다음과 같은 전달 메커니즘을 지원합니다:- 영구 HTTP 스트림
- Webhook
지원되는 이벤트 유형
현재 X Activity API는 카테고리별로 분류된 다음 이벤트 유형을 지원합니다. 각 유형의 샘플 JSON은 이벤트 페이로드를 참조하세요.Post 이벤트
Post 이벤트는 사용자가 Post를 생성하거나 삭제할 때 트리거됩니다.XAA를 통한 Post 이벤트 vs Filtered Stream: X Activity API는
post.create 및 post.delete 이벤트를 지원합니다. user_id로 구독하여 사용자가 Post를 생성하거나 삭제할 때 실시간 알림을 받을 수 있습니다.타겟 키워드 필터링, 불리언 로직, 지역 타겟팅, 언어 필터 또는 Filtered Stream이 지원하는 기타 연산자가 필요한 경우 Filtered Stream 엔드포인트를 대신 사용하세요.Like 이벤트
Like 이벤트는 사용자가 Post에 좋아요를 누르거나 사용자 본인의 Post 중 하나에 좋아요가 눌릴 때 트리거됩니다.Direction 필터:
like.create 이벤트는 outbound 또는 inbound로 설정할 수 있는 선택적 direction 필터를 지원합니다. 사용자가 누른 좋아요에는 outbound를, 사용자의 Post가 받은 좋아요에는 inbound를 사용하세요. direction을 지정하지 않으면 인바운드와 아웃바운드 좋아요 이벤트가 모두 전달됩니다.비공개 이벤트: like.create는 비공개 이벤트이며 사용자 컨텍스트(OAuth 2.0) 인증이 필요합니다. 아래 이벤트 프라이버시 및 인증을 참조하세요.Follow 이벤트
Follow 이벤트는 필터링된 사용자가 다른 사용자를 팔로우하거나 다른 사용자에게 팔로우될 때 트리거됩니다.프로필 이벤트
프로필 이벤트는 사용자가 자신의 프로필 정보를 변경할 때 트리거됩니다.채팅 이벤트
채팅 이벤트는 새로운 암호화 메시징 스택, 즉 XChat과 관련됩니다.레거시 DM 이벤트
레거시 DM 이벤트는 암호화되지 않은 기존 DM 시스템과 관련됩니다.뉴스 이벤트
뉴스 이벤트는 Grok이 큐레이션한 트렌딩 주제 및 헤드라인에 대한 업데이트를 제공합니다.엔터프라이즈 전용:
news.new 이벤트는 현재 Enterprise 및 Partner 등급 계정에서만 사용할 수 있습니다.Spaces 이벤트
Spaces 이벤트는 사용자가 Space를 시작하거나 종료할 때 트리거됩니다.Mute 이벤트
Mute 이벤트는 필터링된 사용자가 다른 사용자를 뮤트하거나 뮤트 해제할 때 트리거됩니다.비공개 이벤트: Mute 이벤트는 비공개이며
mute.read 스코프가 포함된 사용자 컨텍스트(OAuth 2.0) 인증이 필요합니다. user_id 필터는 뮤트 또는 뮤트 해제를 수행하는 사용자와 매칭됩니다 — 어떤 사용자가 뮤트당하는 것에 대한 알림은 구독할 수 없습니다. 아래 이벤트 프라이버시 및 인증을 참조하세요.Block 이벤트
Block 이벤트는 필터링된 사용자가 다른 사용자를 차단하거나 차단 해제할 때 트리거됩니다.비공개 이벤트: Block 이벤트는 비공개이며
block.read 스코프가 포함된 사용자 컨텍스트(OAuth 2.0) 인증이 필요합니다. user_id 필터는 차단 또는 차단 해제를 수행하는 사용자와 매칭됩니다 — 어떤 사용자가 차단당하는 것에 대한 알림은 구독할 수 없습니다. 아래 이벤트 프라이버시 및 인증을 참조하세요.이벤트 프라이버시 및 인증
X Activity API는 아래에 설명된 대로 X 앱과 동등하게 공개 이벤트와 비공개 이벤트를 구분합니다.공개 이벤트
공개 이벤트는 공개 사용자 계정이 공개적으로 수행하는 활동으로, 모든 X 사용자에게 표시됩니다. 이러한 이벤트는 X 플랫폼의 모든 사용자에게 표시되며, 보기 위해 사용자로부터 OAuth 인증을 받을 필요가 없습니다. 현재 공개 이벤트:- 프로필 업데이트(자기소개, 사진, 배너, 위치, URL, 사용자 이름 변경)
- Post 생성(
post.create) 및 삭제(post.delete)
비공개 이벤트
비공개 이벤트는 OAuth 인증을 통해 사용자의 명시적 동의가 필요한 활동입니다. 사용자는 X를 통해 인증하고 이러한 이벤트에 접근할 수 있도록 개발자 앱에 명시적인 권한을 부여해야 합니다. 현재 비공개 이벤트:- 좋아요 (
like.create) - 암호화된 채팅 수신 (
chat.received) - 암호화된 채팅 발송 (
chat.sent) - DM 수신 (
dm.received) - DM 발송 (
dm.sent) - DM 읽음 (
dm.read) - DM 입력 표시기 (
dm.indicate_typing) - Post 멘션 (
post.mention.create) - 뮤트 (
mute.mute,mute.unmute) —mute.read스코프 필요 - 차단 (
block.block,block.unblock) —block.read스코프 필요
- 사용자가 OAuth 2.0을 통해 애플리케이션을 인증해야 합니다
- 애플리케이션이 적절한 OAuth 스코프를 획득해야 합니다
- 사용자가 이러한 이벤트에 접근할 수 있도록 앱에 명시적으로 권한을 부여해야 합니다
- 비공개 이벤트에 대한 구독은 애플리케이션을 승인한 사용자에 대해서만 생성할 수 있습니다