메인 콘텐츠로 건너뛰기
Filtered Stream 엔드포인트를 사용하면 필터 규칙과 일치하는 실시간 포스트를 받아볼 수 있습니다. 강력한 연산자를 사용해 규칙을 만든 다음, 지속적인 스트림에 연결하여 게시될 때마다 일치하는 포스트를 받아 보세요.

​
개요

실시간 전달

게시된 후 몇 초 이내에 포스트를 수신합니다

지속 규칙

연결을 끊지 않고도 규칙을 추가하거나 제거할 수 있습니다

강력한 연산자

키워드, 해시태그, 사용자 등으로 매칭합니다

웹훅 전달

선택적으로 웹훅을 통해 포스트를 수신합니다

​
동작 방식

  1. 규칙 생성 — 연산자를 사용하여 필터 규칙을 정의합니다
  2. 스트림 연결 — 지속적인 HTTP 연결을 설정합니다
  3. 포스트 수신 — 일치하는 포스트를 실시간으로 수신합니다
┌─────────────┐      ┌─────────────┐      ┌─────────────┐
│ Create/     │      │ Connect to  │      │ Receive     │
│ manage      │  →   │ streaming   │  →   │ matching    │
│ rules       │      │ endpoint    │      │ Posts       │
└─────────────┘      └─────────────┘      └─────────────┘

​
엔드포인트

메서드엔드포인트설명
GET/2/tweets/search/stream스트림에 연결합니다
POST/2/tweets/search/stream/rules규칙을 추가하거나 삭제합니다
GET/2/tweets/search/stream/rules현재 규칙을 조회합니다

​
액세스 수준

기능사용량 기반 과금Enterprise
프로젝트당 규칙 수1,00025,000+
규칙 길이1,024자2,048자
연결 수1여러 개
모든 연산자✓✓

Enterprise 문의

더 높은 한도와 추가 기능을 이용해 보세요

​
규칙 작성

규칙은 검색 쿼리와 동일한 연산자를 사용합니다. 
(AI OR "machine learning") lang:en -is:retweet

​
규칙 예시

규칙매칭 대상
#python#python 해시태그가 있는 포스트
from:elonmusk@elonmusk가 작성한 포스트
"breaking news" has:images해당 문구와 이미지를 모두 포함한 포스트
(@XDevelopers OR @X) -is:retweet리트윗을 제외한 멘션 포스트

규칙 만들기

규칙 문법과 연산자에 대해 알아보기

​
스트림에 연결하기

포스트를 수신하기 위해 지속적인 HTTP 연결을 설정합니다. 
import requests

def stream_posts(bearer_token):
    url = "https://api.x.com/2/tweets/search/stream"
    headers = {"Authorization": f"Bearer {bearer_token}"}
    
    response = requests.get(url, headers=headers, stream=True)
    
    for line in response.iter_lines():
        if line:
            print(line.decode("utf-8"))

​
Keep-alive 신호

스트림은 연결을 유지하기 위해 20초마다 빈 줄(\r\n)을 전송합니다. 20초 동안 데이터나 keep-alive 신호를 받지 못하면 재연결하십시오.

연결 끊김 처리

원활하게 재연결하기

스트리밍 데이터 처리

포스트를 효율적으로 처리하기

​
Webhook 전달

지속적인 연결을 유지하는 대신, webhook을 통해 포스트를 수신할 수 있습니다.

Webhook 전달

필터 스트림용 webhook 전달 설정

​
게시물 편집

이 스트림은 편집된 포스트와 해당 편집 내역을 제공합니다. 각 편집마다 새로운 게시물 ID가 생성됩니다: 
{
  "data": {
    "id": "1234567893",
    "text": "Hello world! (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891", "1234567893"]
  }
}

포스트 편집 기본사항

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

​
시작하기

사전 준비 사항

빠른 시작

몇 분 안에 스트림에 연결하세요

규칙 생성

규칙 구문 살펴보기

연산자 참조

사용 가능한 모든 연산자

샘플 코드

실행 가능한 코드 예제

​
고급 주제

연결 끊김 처리

안정적으로 재연결하기

대용량 처리 용량

높은 처리량 처리하기

복구 및 이중화

탄력적인 애플리케이션 구축

반환된 포스트 매칭

어떤 규칙이 일치했는지 식별하기