> ## 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.
# 개요
## X API의 필터링 스트림 엔드포인트 비교
v2 필터링 스트림 엔드포인트 그룹은 [표준 v1.1 statuses/filter](https://developer.x.com/en/docs/x-api/v1/tweets/filter-realtime/api-reference/post-statuses-filter) 및 [PowerTrack API](/ko/x-api/enterprise-gnip-2.0/powertrack-api)를 대체합니다. 이전 버전의 필터링 스트림 엔드포인트를 사용하는 코드, App 또는 도구가 있고 더 새로운 X API v2 엔드포인트로 마이그레이션하는 것을 고려하고 있다면, 이 비교가 시작하는 데 도움이 될 것입니다.
자세한 마이그레이션 가이드는 다음을 참고하세요.
[표준 v1.1에서 X API v2로 마이그레이션](x-api/posts/filtered-stream#standard-v1-1-compared-to-x-api-v2)
[PowerTrack API에서 X API v2로 마이그레이션](/ko/x-api/enterprise-gnip-2.0/powertrack-api#powertrack-operators)
다음 표는 X에서 제공하는 필터링 스트림 엔드포인트를 비교합니다.
| **설명** | **Standard v1.1** | **PowerTrack API** | **X API v2** |
| :--------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 액세스 | X App | 엔터프라이즈 계약 및 계정 필요 | 개발자 계정([가입](https://developer.x.com/en/portal/petition/essential/basic-info))과 [Project](/ko/resources/fundamentals/developer-apps) 내 [X App](/ko/resources/fundamentals/developer-apps)이 필요합니다 |
| :--- | :--- | :--- | :--- |
| 호스트 도메인 | ******[https://stream.x.com](https://stream.x.com)****** | ******[https://gnip-stream.x.com](https://gnip-stream.x.com)****** | ******[https://api.x.com](https://api.x.com)****** |
| 엔드포인트 경로 | ******1.1/statuses/filter.json****** | ******/stream/powertrack/accounts/{gnip_account_name}/publishers/twitter/{stream_label}.json******
******/rules/powertrack/accounts/{gnip_account_name}/publishers/twitter/{stream_label}.json ******
******/rules/powertrack/accounts/{gnip_account_name}/publishers/twitter/{stream_label}/validation.json****** | ******/2/tweets/search/stream******
******/2/tweets/search/stream/rules****** |
| [인증](/ko/resources/fundamentals/authentication) | OAuth 1.0a 사용자 컨텍스트 | HTTP Basic 인증 | OAuth 2.0 App 전용 |
| 지원되는 HTTP 메서드 | POST | GET
POST | GET
POST |
| 필수 매개변수 | 연결 시 파라미터로 정의하는 규칙으로, 다음 중 최소 하나가 포함되어야 합니다:
\* ******follow******
\* ******track******
\* ******locations****** | 스트리밍 연결에 필요한 필수 매개변수는 없으며, 선택적으로 백필(backfill) 매개변수를 사용할 수 있습니다.
규칙은 별도로 관리됩니다. | 스트리밍 연결에는 필수 매개변수가 없으며, 응답 형식을 지정하고 Academic Research 액세스를 위한 [백필(backfill) 복구 기능](/ko/x-api/posts/filtered-stream#recovering-missed-data-after-a-disconnection-backfill)을 추가하기 위한 선택적 매개변수가 제공됩니다.
규칙은 별도로 관리됩니다 |
| 전달 방식 | 스트리밍 | 스트리밍
REST (규칙 관리용) | 스트리밍
규칙 관리를 위한 REST |
| 기본 요청 한도 | 5분당 연결 시도 5회 | POST 및 GET 요청을 합산하여 분당 60개의 요청
/rules: 특정 스트림의 API에 대한 /rules 엔드포인트로의 모든 요청(POST 및 GET)을 합산하여 분당 분당 60개의 요청. | 엔드포인트마다 다릅니다. 최신 한도는 [요청 한도](/ko/x-api/fundamentals/rate-limits)에서 확인하세요. |
| 허용되는 최대 연결 수 | 인가된 사용자당 동시 연결 2개 | 계약에 따라 다중/중복 연결 지원 | 사용량 기반 과금: 1개 |
| [복구 및 중복 기능](/ko/x-api/posts/filtered-stream#filtered-stream-recovery-and-redundancy-features) | 없음 | 백필, 중복 연결 및 Replay API | |
| Keep-alive 신호/하트비트 | 20초마다 최소 한 번 빈 줄(\r\n 등) | 10초마다 빈 줄(\r\n 등) | 20초마다 최소 한 번 빈 줄(\r\n 등) |
| 지연 시간 | 10초 | 2초
URL 언와인딩 보강 처리의 경우 최소 10초 | 10초 |
| 허용되는 최대 규칙 수 | 엔드포인트 연결 요청당 규칙 1개 | 계약에 따라 최대 250,000개까지 | 사용량 기반 과금: 규칙 1,000개 |
| 규칙 필터 제한 사항 | 연결당 하나의 쿼리만 허용되며, 최대 다음 중 하나까지 가능합니다:
- 추적 키워드 400개
- 팔로우 user id 5,000개
- 위치 박스 25개 | 규칙당 최대 2,048자 | 사용량 기반 과금: 규칙당 1,024자 |
| [게시물 JSON 형식](/ko/x-api/fundamentals/data-dictionary) | Standard v1.1 형식 | [Native Enriched](/ko/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#native-enriched-tweet-object) 또는 [Activity Streams]() ([console](/ko/x-api/enterprise-gnip-2.0/fundamentals/overview)에서 선택) | [X API v2 형식](/ko/x-api/fundamentals/data-dictionary) (******fields****** 및 ******expansions****** 요청 매개변수로 결정되며, v1.1 형식과는 호환되지 않습니다)
Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 알아보려면 [데이터 형식 마이그레이션 가이드](/ko/x-api/migrate/data-format-migration)를 참조하세요. Native Enriched 및 Activity Streams용 추가 데이터 형식 마이그레이션 가이드는 곧 제공될 예정입니다. |
| 게시물 편집 이력 및 메타데이터 제공 | ✔ | ✔ | ✔ |
| 고유한 기능 | 연결 요청 시 쿼리 매개변수로 필터링
설정 UI 없음 | 독립된 엔드포인트에서 생성한 규칙을 통해 필터링 수행
계약에 [Enrichment](/ko/x-api/enterprise-gnip-2.0/enterprise-gnip#enrichments) 기능 포함
console.gnip.com UI에서 설정 | 별도의 엔드포인트를 통해 생성한 [규칙](/ko/x-api/posts/filtered-stream/integrate/build-a-rule)으로 필터링 수행
[Metrics](/ko/x-api/fundamentals/metrics) 및 URL 인리치먼트 기능 포함
객체 [fields](/ko/x-api/fundamentals/fields) 및 [expansions](/ko/x-api/fundamentals/expansions)를 요청 매개변수로 지정
게시물 [Annotations](/ko/x-api/fundamentals/post-annotations)
[Conversation ID](/ko/x-api/fundamentals/conversation-id) 연산자와 필드
[개발자 콘솔](/ko/resources/fundamentals/developer-portal)을 통한 설정 |
**추가 마이그레이션 자료**
[Standard v1.1을 X API v2로 마이그레이션](/ko/x-api/posts/filtered-stream#standard-v1-1-compared-to-x-api-v2 "Standard v1.1을 X API v2로 마이그레이션")
[PowerTrack API를 X API v2로 마이그레이션](/ko/x-api/enterprise-gnip-2.0/powertrack-api#powertrack-operators "PowerTrack API를 X API v2로 마이그레이션")
[X API 마이그레이션 허브](/ko/x-api/migrate/overview)
[이 엔드포인트에 대한 샘플 코드를 확인하세요](https://github.com/xdevplatform/Twitter-API-v2-sample-code "이 엔드포인트에 대한 샘플 코드를 확인하세요")