Skip to main content
Filtered Stream 엔드포인트를 사용하면 필터 규칙에 매칭되는 게시물을 거의 실시간으로 수신할 수 있습니다. 강력한 연산자로 규칙을 만들고 지속적인 스트림에 연결하여 게시물이 발행되는 대로 매칭되는 게시물을 수신하세요.
Filtered Stream은 데이터 hydration과 전달을 우선하며, P99 지연 시간은 약 6-7초입니다. 더 낮은 지연 시간이 필요한 경우 Powerstream을 참고하세요.

개요

거의 실시간 전달

게시물이 발행된 지 수 초 이내에 수신

지속적인 규칙

연결을 끊지 않고 규칙 추가 및 제거

강력한 연산자

keywords, hashtags, users 등 다양한 항목으로 매칭

Webhook 전달

선택적으로 게시물을 webhook으로 수신

동작 방식

  1. 규칙 생성 — 연산자를 사용해 필터 규칙 정의
  2. 스트림 연결 — 지속적인 HTTP 연결 수립
  3. 게시물 수신 — 매칭 게시물을 거의 실시간으로 수신

엔드포인트


접근 등급

Enterprise 문의

더 높은 한도와 추가 기능 이용
일부 연산자는 특정 티어가 필요합니다. embedding: 시맨틱 연산자는 Embedding 티어 액세스가 포함된 Enterprise plan에서 Filtered Stream에만 제공됩니다. 표준 Pay-per-use 액세스에는 core operator만 포함됩니다.

규칙 작성

규칙은 search 쿼리와 동일한 연산자를 사용합니다:

예시 규칙

규칙 작성

규칙 구문 및 연산자 익히기

스트림 연결

게시물을 수신하기 위해 지속적인 HTTP 연결을 수립합니다:

Keep-alive 신호

스트림은 연결을 유지하기 위해 20초마다 빈 줄(\r\n)을 보냅니다. 20초 동안 데이터나 keep-alive를 수신하지 않으면 재연결하세요.

연결 끊김 처리

원활하게 재연결하기

스트리밍 데이터 소비

게시물을 효율적으로 처리

Webhook 전달

지속적인 연결을 유지하는 대신, webhook을 통해 게시물을 수신할 수 있습니다:

Webhook 전달

filtered stream용 webhook 전달 설정

게시물 편집

스트림은 편집된 게시물을 편집 히스토리와 함께 전달합니다. 각 편집은 새로운 Post ID를 생성합니다:

게시물 편집 기본

게시물 편집에 대해 자세히 알아보기

시작하기

사전 요구사항

퀵스타트

몇 분 안에 스트림에 연결하기

규칙 작성

규칙 구문 익히기

연산자 레퍼런스

사용 가능한 모든 연산자

샘플 코드

동작하는 코드 예제

고급 주제

연결 끊김 처리

원활하게 재연결하기

대용량 처리 능력

높은 처리량 처리

복구 및 이중화

복원력 있는 애플리케이션 구축

반환된 게시물 매칭

어떤 규칙이 매칭되었는지 식별