API 레퍼런스

기본 URL은 https://api.xsignalfeed.com입니다. 모든 응답은 JSON이며, 실패 시에는 오류에서 설명하는 엔벨로프로, 성공 시에는 속도 제한에 나열된 헤더와 함께 전달됩니다. * 표시된 필드는 필수입니다.

모니터링

이 키가 따라갈 계정을 고릅니다. 각 계정마다 키가 허용하는 모든 이벤트 타입을 받거나, 고른 타입만 받을 수 있습니다.

엔드포인트이름스코프크레딧
GET /v1/monitor/targets모니터링 대상 목록targets:read0
POST /v1/monitor/targets계정 모니터링 시작targets:write0
GET /v1/monitor/targets/{target}모니터링 대상 조회targets:read0
PATCH /v1/monitor/targets/{target}계정의 이벤트 타입 선택targets:write0
DELETE /v1/monitor/targets/{target}계정 모니터링 중단targets:write0
POST /v1/monitor/targets:batch모니터링 배치 작업targets:write0

키워드

특정 문구에 대한 X 검색을 감시합니다. 쿼리는 X 자체 문법을 그대로 받습니다: 따옴표로 묶은 정확한 문구, OR, -exclusions, #hashtags, $cashtags, from:, to:, lang:, filter:media, -filter:replies, -filter:retweets. "최신" 탭을 감시하므로 결과는 시간순이며, 어떤 언어나 문자 체계든 동작합니다.

엔드포인트이름스코프크레딧
GET /v1/keywords키워드 목록keywords:read0
POST /v1/keywords키워드 감시keywords:write0
DELETE /v1/keywords/{keyword_id}키워드 삭제keywords:write0

스트림 & 히스토리

WebSocket은 스트리밍에서 설명합니다. 이것은 따라잡기 위한 REST 대응 API입니다.

엔드포인트이름스코프크레딧
GET /v1/events이벤트 기록replay0

사용자

프로필, 팔로우 목록, 미디어, 멘션, 구독, 사용자 검색을 지금 X에서 읽습니다. 각 호출은 표시된 크레딧을 소모합니다.

엔드포인트이름스코프크레딧
GET /v1/users/{screen_name}사용자 이름으로 사용자 조회reads1
GET /v1/users/by-id/{user_id}ID로 사용자 조회reads1
GET /v1/users/batch여러 ID로 사용자 조회reads1 per id
GET /v1/users/{screen_name}/about계정 상세 정보 조회reads1
GET /v1/users/{screen_name}/tweets사용자 게시물 조회reads2
GET /v1/users/{screen_name}/media사용자 미디어 조회reads2
GET /v1/users/{screen_name}/mentions사용자 멘션 조회reads2
GET /v1/users/{screen_name}/following팔로잉 조회reads2
GET /v1/users/{screen_name}/followers팔로워 조회reads2
GET /v1/users/{screen_name}/verified_followers인증 팔로워 조회reads2
GET /v1/users/{screen_name}/subscriptions구독 조회reads2
GET /v1/users/search사용자 검색reads2
GET /v1/users/{screen_name}/relationship/{other_screen_name}팔로우 관계 확인reads1

게시물

id로 조회하는 게시물과 그 답글, 인용, 리포스트한 사용자, 스레드, 아티클. 각 호출은 표시된 크레딧을 소모합니다.

엔드포인트이름스코프크레딧
GET /v1/tweets/{tweet_id}게시물 조회reads1
GET /v1/tweets여러 ID로 게시물 조회reads1
GET /v1/tweets/{tweet_id}/replies답글 조회reads2
GET /v1/tweets/{tweet_id}/quotes인용 조회reads2
GET /v1/tweets/{tweet_id}/retweeters리포스트한 계정 조회reads2
GET /v1/tweets/{tweet_id}/thread스레드 조회reads2
GET /v1/tweets/{tweet_id}/article아티클 조회reads1

X 자체 문법으로 하는 X 검색. 최신 또는 인기 결과, 페이지 단위.

엔드포인트이름스코프크레딧
GET /v1/search게시물 검색reads2
GET /v1/search/trends트렌드 검색reads2

리스트

공개 리스트의 타임라인과 멤버.

엔드포인트이름스코프크레딧
GET /v1/lists/{list_id}/tweets리스트 게시물 조회reads2
GET /v1/lists/{list_id}/members리스트 멤버 조회reads2

커뮤니티

X 커뮤니티의 정보, 멤버, 모더레이터, 게시물.

엔드포인트이름스코프크레딧
GET /v1/communities/{community_id}커뮤니티 조회reads1
GET /v1/communities/{community_id}/members커뮤니티 멤버 조회reads2
GET /v1/communities/{community_id}/moderators커뮤니티 모더레이터 조회reads2
GET /v1/communities/{community_id}/tweets커뮤니티 게시물 조회reads2

지금 X에서 트렌드인 것, 카테고리별.

엔드포인트이름스코프크레딧
GET /v1/trends트렌드 조회reads2

계정

이 키로 할 수 있는 일, 사용량, 웹훅 대상.

엔드포인트이름스코프크레딧
GET /v1/account계정 조회—0
GET /v1/account/usage사용량 조회—0
GET /v1/account/webhook웹훅 조회webhook0
PUT /v1/account/webhook웹훅 설정webhook0

메타 & 상태

공개이며 5분간 캐시되고 키가 필요 없습니다. 이 페이지를 복사하는 대신 여기서 유효성 검사와 UI를 구성하십시오.

엔드포인트이름스코프크레딧
GET /v1/meta/event-types이벤트 타입 목록—0
GET /v1/meta/scopes스코프 목록—0
GET /v1/meta/plans플랜 목록—0
GET /v1/meta/versions버전 목록—0
GET /v1/health헬스 체크—0
GET /v1/status상태—0

위 내용 전체의 기계 판독용 설명은 /v1/openapi.json에 있으며, /v1/docs는 이 페이지로 리디렉션됩니다.