| Host domain | https://api.x.com | https://api.x.com |
| Endpoint path | /1.1/search/tweets.json | /2/tweets/search/recent |
| Authentication | OAuth 1.0a User Context OAuth 2.0 App-Only | OAuth 1.0a User Context
OAuth 2.0 Authorization Code with PKCE
OAuth 2.0 App-Only |
| Timestamp format | YYYYMMDD | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| 반환되는 게시물이 이보다 과거가 아닌 최대 기간 | 7일 | 7일 |
| 지원되는 HTTP 메서드 | GET | GET |
| 기본 요청 요청 한도 | OAuth 1.0a User Context 사용 시 15분당 180회 요청
OAuth 2.0 App-Only 사용 시 15분당 450회 요청 | 셀프 서비스(Self-serve):
OAuth 2.0 App-Only 사용 시 15분당 60회 요청
OAuth 1.0a User Context 사용 시 15분당 60회 요청
OAuth 2.0 Authorization Code with PKCE 사용 시 15분당 60회 요청 |
| 완전히 풀린 URL 제공 | | ✔ |
| 응답당 최대 게시물 수(기본값) | 100 (15) | 100 (10) |
| Post JSON format | Standard v1.1 format | X API v2 format (요청 매개변수인 fields 및 expansions에 의해 결정되며, v1.1 형식과는 하위 호환되지 않음)
Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 자세히 알아보려면 데이터 형식 마이그레이션 가이드를 방문하세요. |
| payload에서 반환할 fields를 선택하는 기능 지원 | | ✔ |
| annotations를 요청 및 수신하는 기능 지원 | | ✔ |
| Post 객체 내에서 특정 metrics를 요청하는 기능 지원 | | ✔ |
| conversation_id 연산자 및 필드 지원 | | ✔ |
| 게시물 수정 이력 제공 | ✔ | ✔ |
| Post 데이터 배열에 대한 JSON key 이름 | statuses | data |
| 페이지네이션에 대한 JSON key 이름 | search_metadata.next_results | meta.next_token |
| 시간 범위로 아카이브 탐색 지원 | ✔ | ✔ |
| 시간 기반 요청의 시간 해상도 | 일(day) | 초(second) |
| Timezone | UTC | UTC |
| 시간 기반 탐색을 위한 요청 매개변수 | until | start_time end_time |
| Post ID 기반 탐색을 위한 요청 매개변수 | since_id max_id | since_id until_id |
| 페이지네이션을 위한 요청 매개변수 | URL 인코딩된 쿼리 제공 | next_token |
| Project와 연결된 developer App의 credentials 사용 필요 | | ✔ |