X API 게시물 개수 엔드포인트 비교
최근 게시물 카운트 비교
| 설명 | Enterprise | X API v2 |
|---|---|---|
| 호스트 도메인 | https://gnip-api.x.com | https://api.x.com |
| 엔드포인트 경로 | /search/30day/accounts/:account_name/:label/counts.json | /2/tweets/counts/recent |
| 인증 | Basic authentication | OAuth 2.0 Bearer Token |
| 타임스탬프 형식 | YYYYMMDDhhmm | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| 반환하는 게시물 카운트의 최대 경과 기간 | 31일 | 7일 |
| 지원되는 HTTP 메서드 | GET | GET |
| 기본 요청 한도 | 초당 20개 요청, 검색 데이터 및 카운트 요청 전체에 대해 합산 분당 요청 한도는 계약서에 명시된 대로 파트너별로 달라집니다. | 사용자당 15분당 180개 요청 App당 15분당 450개 요청 |
| annotations를 사용한 필터링 지원 | ✔ | |
| conversation_id를 사용한 필터링 지원 | ✔ | |
| 게시물 데이터 배열의 JSON 키 이름 | results | data |
| 시간 단위(세분성) | 일, 시 또는 분 | 일, 시 또는 분 |
| 시간대 | UTC | UTC |
| 시간 기간 선택을 위한 요청 파라미터 | fromDate toDate | start_time end_time |
| 게시물 ID 기반 탐색을 위한 요청 파라미터 | since_id until_id | |
| developer App와 연결된 project의 자격 증명 사용 필요 | ✔ |
전체 아카이브 게시물 개수 비교
| 설명 | Enterprise | X API v2 |
|---|---|---|
| 호스트 도메인 | https://gnip-api.x.com | https://api.x.com |
| 엔드포인트 경로 | /search/fullarchive/accounts/:account_name/:label/counts | /2/tweets/counts/all |
| 인증 | Basic auth | OAuth 2.0 Bearer Token |
| 타임스탬프 형식 | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339 |
| 게시물 개수가 제공되는 최대 과거 시점 | 2006년 3월 이후 전체 아카이브 | 2006년 3월 이후 전체 아카이브 |
| 지원되는 HTTP 메서드 | GET POST | GET |
| 기본 요청 한도 | 분당 요청 한도는 계약서에 명시된 파트너별로 다릅니다. 초당 20건의 요청 | App당 15분당 300건의 요청 App당 초당 1건의 요청 |
| 세분성 | 일, 시간, 분 | 일, 시간, 분 |
| annotations을 사용한 필터링 지원 | ✔ | |
| conversation_id을 사용한 필터링 지원 | ✔ | |
| 게시물 데이터 배열에 대한 JSON 키 이름 | results | data |
| 기간 선택용 요청 파라미터 | fromDate toDate | start_time end_time |
| 게시물 ID를 기준으로 탐색하기 위한 요청 파라미터 | since_id until_id | |
| 페이지네이션용 JSON 키 이름 | next | meta.next_token |
| 페이지네이션용 요청 파라미터 | next_token | next_token 또는 pagination_token |
| 타임존 | UTC | UTC |
| Academic Research access 권한이 있는 Project에 연결된 developer App의 자격 증명 필요 | ✔ |
필터링 연산자 비교
- enterprise 연산자에는 하위 등급이 없습니다. 모든 enterprise 연산자는 모든 enterprise 사용자에게 제공됩니다.
- Core: 이 연산자는 모든 v2 사용자에게 제공됩니다.
- Advanced: 이 연산자는 Academic Research 액세스 권한이 승인된 사용자에게만 제공됩니다.
| Enterprise | v2 | |
|---|---|---|
| keyword | 사용 가능 | Core |
| emoji | 사용 가능 | Core |
| “exact phrase” | 사용 가능 | Core |
| # | 사용 가능 | Core |
| $ | 사용 가능 | Advanced |
| @ | 사용 가능 | Core |
| from: | 사용 가능 | Core |
| to: | 사용 가능 | Core |
| url: | 사용 가능 | Core |
| retweets_of: | 사용 가능 | Core |
| context: | Core | |
| entity: | Core - 최근 검색에서만 사용 가능 | |
| conversation_id: | Core | |
| place: | 사용 가능 | Advanced |
| place_country: | 사용 가능 | Advanced |
| point_radius: | 사용 가능 | Advanced |
| bounding_box: | 사용 가능 | Advanced |
| is:retweet | 사용 가능 | Core |
| is:reply | 사용 가능 | Core |
| is:quote | 사용 가능 | Core |
| is:verified | 사용 가능 | Core |
| -is:nullcast | 사용 가능 | Advanced |
| has:hashtags | 사용 가능 | Core |
| has:cashtags | 사용 가능 | Advanced |
| has:links | 사용 가능 | Core |
| has:mentions | 사용 가능 | Core |
| has:media | 사용 가능 | Core |
| has:images | 사용 가능 | Core |
| has:videos | 사용 가능 | Core |
| has:geo | 사용 가능 | Advanced |
| lang: | 사용 가능 | Core |
| list: | Advanced | |
| has:profile_geo | 사용 가능 | |
| profile_country | 사용 가능 | |
| profile_locality | 사용 가능 | |
| profile_region | 사용 가능 | |
| proximity | 사용 가능 |