API 레퍼런스 · v1
X 계정의 모든 활동을 하나의 연결로
xSignalFeed는 지정한 X(구 Twitter) 계정을 지켜보고, 새 게시물, 답글, 리포스트, 인용, 삭제, 프로필 수정, 팔로우, 새 인증 팔로워 등 그 계정이 하는 일을 발생하는 즉시 전달합니다. 특정 문구에 대한 X 검색을 감시하고, 프로필, 게시물, 팔로워, 리스트, 커뮤니티, 트렌드를 온디맨드로 읽을 수도 있습니다. 이벤트는 하나의 WebSocket으로 전달되며, 기다리기보다 직접 물어봐야 할 때를 위해 REST가 준비되어 있습니다.
소개
이 서비스를 사용하는 방법은 세 가지입니다. 모니터링: 계정과 키워드를 지정하고, 일이 발생할 때마다 WebSocket이나 웹훅으로 이벤트를 받습니다. 히스토리: 키가 받은 이벤트를 다시 읽습니다. 읽기: 프로필, 게시물, 검색, 리스트, 커뮤니티, 또는 지금의 트렌드를 X에 직접 물어봅니다.
이벤트는 네 가지 계열로 나뉩니다. 각 계열은 하나의 페이로드 형태를 가지며, 이벤트에서 필드별로 설명합니다.
| 카테고리 | 타입 | 의미 |
|---|---|---|
| 게시물 | tweet.create, tweet.reply, tweet.retweet, tweet.quote, tweet.edit, tweet.delete | 계정이 게시하는 것: 새 게시물, 답글, 리포스트, 인용, 수정, 그리고 이들 중 어느 것의 삭제 |
| 프로필 | profile.name, profile.screen_name, profile.bio, profile.location, profile.url, profile.avatar, profile.banner, profile.pinned, profile.verified | 계정이 자신에 대해 보여주는 정보의 모든 변경. 이전 값과 새 값이 함께 담깁니다 |
| 팔로우 그래프 | follow.add, follow.remove, followers.verified.add | 계정이 누구를 팔로우하기 시작하거나 그만두는지, 그리고 어떤 인증 계정이 그 계정을 팔로우하기 시작하는지 |
| 계정 | account.status | 계정을 볼 수 있는지 여부: 비공개, 정지, 볼 수 없음, 또는 다시 정상 |
| 검색 | search.match | 감시 중인 키워드에 일치하는, X의 누구든 올린 게시물 |
접근은 API 키로 이루어집니다. 키에는 플랜에서 비롯된 스코프와 상한이 담겨 있으며, GET /v1/account가 여러분의 키로 무엇을 할 수 있는지 알려줍니다. 이벤트 양에 따라 과금되는 것은 없습니다. 스트리밍은 기본 포함이며, 온디맨드 읽기만 크레딧을 소모합니다.
xSignalFeed는 독립적인 서드파티 서비스입니다. X Corp와 제휴하거나, X Corp의 보증 또는 후원을 받지 않습니다. 저희는 공개 데이터만 읽습니다.