메인 콘텐츠로 건너뛰기필터링된 스트림 엔드포인트 그룹은 개발자가 공개 게시물 스트림을 필터링할 수 있게 합니다. 이 엔드포인트 그룹에는 규칙을 생성·관리하고, 해당 규칙을 적용해 일치하는 공개 게시물만 반환하도록 스트림을 필터링할 수 있는 여러 엔드포인트가 포함됩니다. 이를 통해 특정 주제와 이벤트를 수신하고, 경쟁 관련 대화를 모니터링하며, 트렌드가 형성되는 양상을 파악하는 등 다양한 작업을 수행할 수 있습니다.
개발자는 연결을 끊지 않고도 지속 스트림 연결에 규칙을 추가하거나 제거하기 위해 REST rules 엔드포인트를 사용할 수 있습니다. 이러한 rules는 메시지 키워드, 해시태그, URL 등 게시물 속성과 매칭되는 연산자를 사용하여 만들 수 있습니다. 연산자와 규칙 절은 불리언 로직과 괄호를 조합해 필터의 매칭 동작을 더욱 정교하게 조정할 수 있습니다.
규칙 세트를 추가한 후에는 스트리밍 연결을 설정하여 지속적인 HTTP 스트리밍 연결을 통해 JSON 형식의 게시물 객체를 수신하기 시작할 수 있습니다. 스트림에 연결되어 있는 동안에는 규칙과 일치하는 콘텐츠만 수신합니다.
또는 Filtered Stream을 웹훅에 연결하여 웹훅 이벤트로 전달받을 수 있습니다. Filtered Stream과 웹훅 사용에 대한 자세한 내용은 Filtered Stream Webhooks 소개를 참조하세요.
필터링된 검색 엔드포인트는 수정된 게시물을 지원합니다. 이 엔드포인트는 하나 이상의 필터와 일치하는 수정된 게시물과 함께, 게시물 id 배열을 포함한 수정 이력을 제공합니다. 수정 이력이 없는 게시물의 경우 이 배열에는 단일 id가 포함됩니다. 수정된 게시물의 경우 이 배열에는 수정 순서를 반영해 오름차순으로 정렬된 여러 id가 포함되며, 가장 최신 버전은 배열의 마지막 위치에 있습니다. 게시물 수정 동작에 대한 자세한 내용은 게시물 수정 기본 사항 페이지를 참조하세요.
필터링된 스트림 엔드포인트의 일부 기능은 액세스 수준에 따라 제한됩니다:
Pro 액세스
- 프로젝트당 1,000개 규칙
- POST /2/tweets/search/stream/rules 엔드포인트로 규칙을 추가할 때 15분당 100회 요청
- 규칙 작성 시 모든 연산자 사용 가능
- 최대 1,024자 길이의 규칙 작성 가능
Enterprise 액세스
- 프로젝트당 25,000개 이상 규칙
- 규칙 작성 시 모든 연산자 사용 가능
- 최대 2,048자 길이의 규칙 작성 가능
- Enterprise 액세스는 여기에서 신청
필터링된 스트림에서 반환된 게시물은 월별 게시물 상한에 포함됩니다.
계정 설정이러한 엔드포인트에 액세스하려면 다음이 필요합니다:X API v2 엔드포인트에 대한 액세스 획득 방법은 시작 가이드를 참고하세요. 
