X API의 필터링 스트림 엔드포인트 비교
| 설명 | Standard v1.1 | PowerTrack API | X API v2 |
|---|---|---|---|
| 액세스 | X App | 엔터프라이즈 계약 및 계정 필요 | 개발자 계정(가입)과 Project 내 X App이 필요합니다 |
| :--- | :--- | :--- | :--- |
| 호스트 도메인 | https://stream.x.com | https://gnip-stream.x.com | https://api.x.com |
| 엔드포인트 경로 | 1.1/statuses/filter.json | /stream/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter/.json /rules/powertrack/accounts//publishers/twitter//validation.json | /2/tweets/search/stream /2/tweets/search/stream/rules |
| 인증 | OAuth 1.0a 사용자 컨텍스트 | HTTP Basic 인증 | OAuth 2.0 App 전용 |
| 지원되는 HTTP 메서드 | POST | GET POST | GET POST |
| 필수 매개변수 | 연결 시 파라미터로 정의하는 규칙으로, 다음 중 최소 하나가 포함되어야 합니다: * follow * track * locations | 스트리밍 연결에 필요한 필수 매개변수는 없으며, 선택적으로 백필(backfill) 매개변수를 사용할 수 있습니다. 규칙은 별도로 관리됩니다. | 스트리밍 연결에는 필수 매개변수가 없으며, 응답 형식을 지정하고 Academic Research 액세스를 위한 백필(backfill) 복구 기능을 추가하기 위한 선택적 매개변수가 제공됩니다. 규칙은 별도로 관리됩니다 |
| 전달 방식 | 스트리밍 | 스트리밍 REST (규칙 관리용) | 스트리밍 규칙 관리를 위한 REST |
| 기본 요청 한도 | 5분당 연결 시도 5회 | POST 및 GET 요청을 합산하여 분당 60개의 요청 /rules: 특정 스트림의 API에 대한 /rules 엔드포인트로의 모든 요청(POST 및 GET)을 합산하여 분당 분당 60개의 요청. | 엔드포인트마다 다릅니다. 최신 한도는 요청 한도에서 확인하세요. |
| 허용되는 최대 연결 수 | 인가된 사용자당 동시 연결 2개 | 계약에 따라 다중/중복 연결 지원 | 사용량 기반 과금: 1개 |
| 복구 및 중복 기능 | 없음 | 백필, 중복 연결 및 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 형식 | Standard v1.1 형식 | Native Enriched 또는 Activity Streams (console에서 선택) | X API v2 형식 (fields 및 expansions 요청 매개변수로 결정되며, v1.1 형식과는 호환되지 않습니다) Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 알아보려면 데이터 형식 마이그레이션 가이드를 참조하세요. Native Enriched 및 Activity Streams용 추가 데이터 형식 마이그레이션 가이드는 곧 제공될 예정입니다. |
| 게시물 편집 이력 및 메타데이터 제공 | ✔ | ✔ | ✔ |
| 고유한 기능 | 연결 요청 시 쿼리 매개변수로 필터링 설정 UI 없음 | 독립된 엔드포인트에서 생성한 규칙을 통해 필터링 수행 계약에 Enrichment 기능 포함 console.gnip.com UI에서 설정 | 별도의 엔드포인트를 통해 생성한 규칙으로 필터링 수행 Metrics 및 URL 인리치먼트 기능 포함 객체 fields 및 expansions를 요청 매개변수로 지정 게시물 Annotations Conversation ID 연산자와 필드 개발자 콘솔을 통한 설정 |