메인 콘텐츠로 건너뛰기
필터링된 스트림 엔드포인트 그룹은 개발자가 공개 게시물 스트림을 필터링할 수 있도록 합니다. 이 엔드포인트 그룹에는 규칙을 생성·관리하고, 해당 규칙을 적용해 일치하는 공개 게시물만 반환하도록 스트림을 필터링할 수 있게 해주는 여러 엔드포인트가 포함됩니다. 이를 통해 특정 주제와 이벤트를 수신하고, 경쟁과 관련된 대화를 모니터링하며, 트렌드가 어떻게 형성되는지 파악하는 등 다양한 작업을 수행할 수 있습니다.
개발자는 REST rules endpoint를 사용해 정의한 기준과 일치하는 게시물을 필터링하기 위한 규칙을 추가·제거할 수 있습니다. 이러한 rules는 메시지 키워드, 해시태그, URL 등 게시물 속성과 매칭되는 연산자를 사용해 생성할 수 있습니다. 연산자와 규칙 절은 불리언 로직과 괄호를 조합해 필터의 매칭 동작을 더욱 정밀하게 조정할 수 있습니다.
규칙 세트를 추가한 후에는 X가 JSON 형식의 Post objects를 전송하기 시작할 웹훅을 등록할 수 있습니다. 웹훅에는 규칙과 일치하는 콘텐츠만 전달됩니다.
이 엔드포인트는 수정된 게시물을 지원합니다. 웹훅은 하나 이상의 필터와 일치하는 수정된 게시물과 함께 게시물 ID 배열을 포함한 편집 기록을 수신합니다. 편집 기록이 없는 게시물의 경우 이 배열에는 단일 ID가 포함됩니다. 편집된 게시물의 경우 이 배열에는 여러 ID가 포함되며, 편집 순서를 반영해 오름차순으로 정렬되고 배열의 마지막 위치에 최신 버전이 있습니다. 게시물 편집 방식에 대한 자세한 내용은 Posts edits fundamentals 페이지를 참조하세요.
참고: 이 엔드포인트 그룹은 규칙 설정 방식이 v2 filtered stream endpoint와 유사합니다. 유일한 차이는 규칙과 일치하는 게시물의 전달 메커니즘입니다.
- v2 filtered stream endpoint의 경우 지속 연결을 설정하고 규칙과 일치하는 게시물을 수신해야 합니다.
- 이 filtered stream webhook 엔드포인트의 경우 웹훅을 등록하면 X가 규칙과 일치하는 게시물을 웹훅으로 전달합니다.
이는 클라이언트 연결 끊김이나 서비스의 정상 재시작으로 인한 서버 측 연결 끊김을 처리할 필요를 없애줍니다. 초당 수백 건의 이벤트를 전달할 가능성이 높으므로,
웹훅 서버는 이러한 동시 연결 시도를 처리할 수 있어야 합니다.
이 엔드포인트는 현재 Enterprise 개발자에게 제공되며 다음 구성을 지원합니다:
- 프로젝트당 25,000개 이상의 규칙
- 규칙을 작성할 때 모든 연산자 사용 가능
- 최대 2048자 길이의 규칙 작성 가능
- Enterprise 액세스는 여기에서 신청
필터링된 스트림에서 반환되는 게시물은 월간 Post cap에 포함됩니다.
계정 설정이 엔드포인트에 액세스하려면 다음이 필요합니다:X API v2 엔드포인트 액세스 방법은 시작하기 가이드를 참고하세요. 
