> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 필터링된 스트림 웹훅 API

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

<div id="overview">
  ## 개요
</div>

filtered stream 엔드포인트 그룹을 사용하면 개발자가 공개 포스트 스트림을 필터링할 수 있습니다. 이 엔드포인트 그룹에는 규칙을 생성·관리하고, 그 규칙을 적용해 일치하는 공개 포스트만 반환하도록 스트림을 필터링할 수 있게 해 주는 여러 엔드포인트가 포함됩니다. 이 엔드포인트 그룹을 사용하면 특정 주제와 이벤트를 실시간으로 수신하고, 경쟁과 관련된 대화를 모니터링하며, 트렌드가 어떻게 형성되는지 파악하는 등 다양한 작업을 수행할 수 있습니다.

개발자는 REST [rules 엔드포인트](/ko/x-api/posts/filtered-stream#post-2-tweets-search-stream-rules)를 사용하여, 정의된 기준과 일치하는 포스트를 필터링하기 위한 규칙을 추가·삭제할 수 있습니다. 이러한 [규칙](/ko/x-api/posts/filtered-stream#building-rules-for-filtered-stream)은 메시지 키워드, 해시태그, URL과 같은 포스트 속성과 일치하도록 연산자를 사용해 생성할 수 있습니다. 연산자와 규칙 절은 불리언 로직과 괄호를 조합해, 필터의 매칭 동작을 세밀하게 조정할 수 있습니다. 

규칙 집합을 추가한 후에는 웹훅을 등록하면, X가 JSON 형식의 [Post objects](/ko/x-api/fundamentals/data-dictionary#tweet)를 전달하기 시작합니다. 웹훅에는 규칙과 일치하는 콘텐츠만 수신됩니다.

이 엔드포인트는 편집된 포스트를 지원합니다. 웹훅은 하나 이상의 필터와 일치하는 편집된 포스트와 함께, 포스트 ID 배열을 포함한 편집 이력을 수신하게 됩니다. 편집 이력이 없는 포스트의 경우 이 배열에는 단일 ID만 포함됩니다. 편집된 포스트의 경우 이 배열에는 여러 ID가 포함되며, 편집 순서를 반영해 오름차순으로 정렬되고, 가장 최근 버전이 배열의 마지막 위치에 있습니다. 포스트 편집 방식에 대해 자세히 알아보려면 [Posts edits fundamentals](/ko/x-api/fundamentals/edit-posts) 페이지를 참조하세요. 

**참고:** 이 엔드포인트 그룹은 규칙을 설정하는 방식이 [v2 filtered stream 엔드포인트](/ko/x-api/posts/filtered-stream/introduction)와 유사합니다. 유일한 차이점은 규칙과 일치하는 포스트를 전달하는 메커니즘입니다.

* v2 filtered stream 엔드포인트의 경우, 지속적인 연결을 설정하고 규칙과 일치하는 포스트를 수신 대기해야 합니다.
* 이 filtered stream 웹훅 엔드포인트의 경우, 웹훅을 등록하면 X가 규칙과 일치하는 포스트를 웹훅으로 전달합니다.

이를 통해 클라이언트 측 연결 끊김이나, 서비스의 정상적인 재시작으로 인한 서버 측 중단에서 발생하는 연결 해제를 별도로 처리할 필요가 없어집니다. 초당 수백 개의 이벤트를 전달할 수 있으므로, 웹훅 서버는 이러한 동시 연결 시도를 처리할 수 있어야 합니다.

이 엔드포인트는 현재 Enterprise 개발자에게 제공되며, 다음과 같은 구성을 지원합니다.

* 프로젝트당 25,000개 이상의 규칙
* 규칙을 작성할 때 모든 연산자 사용 가능
* 최대 2048자 길이의 규칙 생성 가능
* Enterprise 액세스를 위해서는 [여기](https://developer.x.com/en/products/x-api/enterprise/enterprise-api-interest-form)에서 신청

filtered stream에서 반환된 포스트는 월간 [Post cap](/ko/x-api/fundamentals/post-cap)에 포함됩니다.

<Note>
  **계정 설정**

  이 엔드포인트에 액세스하려면 다음이 필요합니다.

  * 승인된 [개발자 계정](https://developer.x.com/en/portal/petition/essential/basic-info)
  * [Project](/ko/resources/fundamentals/developer-apps) 내에 위치한 [developer App](/ko/resources/fundamentals/developer-apps)의 키와 토큰을 사용한 인증 

  X API v2 엔드포인트에 액세스하는 방법에 대해서는 [시작하기 가이드](/ko/x-api/getting-started/getting-access)를 참조하세요.
</Note>

<div className="flex">
  <Button href="/ko/x-api/posts/filtered-stream/quickstart">
    빠른 시작
  </Button>
</div>