> ## 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 게시물 개수 엔드포인트는 향후 [enterprise Search API의 counts 엔드포인트](/ko/x-api/enterprise-gnip-2.0/fundamentals/search-api#counts-requests-post-count)를 대체할 예정입니다. 기존 버전의 게시물 개수 엔드포인트를 사용하는 코드, App 또는 도구가 있고 이를 새로운 X API v2 엔드포인트로 마이그레이션하는 것을 고려하고 있다면, 이 가이드는 여러분을 위한 것입니다.
***
## 최근 게시물 카운트 비교
Enterprise 버전의 게시물 카운트 엔드포인트를 사용하면 30일 또는 전체 보관 아카이브 중 하나에 대한 카운트를 가져올 수 있습니다. 따라서 7일 기간을 조회하는 v2 최근 게시물 카운트 엔드포인트는 앞에서 언급한 어느 엔드포인트의 직접적인 대체제가 되지 않습니다.
다만 비교에 도움이 되도록, v2 최근 게시물 카운트 엔드포인트가 Enterprise 30일 엔드포인트와 어떻게 비교되는지 살펴보겠습니다.
다음 표는 다양한 유형의 최근 게시물 카운트 엔드포인트를 비교한 것입니다:
| **설명** | **Enterprise** | **X API v2** |
| :-------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
| 호스트 도메인 | [https://gnip-api.x.com](https://gnip-api.x.com) | [https://api.x.com](https://api.x.com) |
| 엔드포인트 경로 | /search/30day/accounts/:account\_name/:label/counts.json | /2/tweets/counts/recent |
| [인증](/ko/resources/fundamentals/authentication) | Basic authentication | OAuth 2.0 Bearer Token |
| 타임스탬프 형식 | YYYYMMDDhhmm | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| 반환하는 게시물 카운트의 최대 경과 기간 | 31일 | 7일 |
| 지원되는 HTTP 메서드 | GET | GET |
| 기본 요청 한도 | 초당 20개 요청, 검색 데이터 및 카운트 요청 전체에 대해 합산
분당 요청 한도는 계약서에 명시된 대로 파트너별로 달라집니다. | 사용자당 15분당 180개 요청
App당 15분당 450개 요청 |
| [annotations](/ko/x-api/fundamentals/post-annotations)를 사용한 필터링 지원 | | ✔ |
| [conversation\_id](/ko/x-api/fundamentals/conversation-id)를 사용한 필터링 지원 | | ✔ |
| 게시물 데이터 배열의 JSON 키 이름 | results | data |
| 시간 단위(세분성) | 일, 시 또는 분 | 일, 시 또는 분 |
| 시간대 | UTC | UTC |
| 시간 기간 선택을 위한 요청 파라미터 | fromDate
toDate | start\_time
end\_time |
| 게시물 ID 기반 탐색을 위한 요청 파라미터 | | since\_id
until\_id |
| [developer App](/ko/resources/fundamentals/developer-apps)와 연결된 [project](/ko/resources/fundamentals/developer-apps)의 자격 증명 사용 필요 | | ✔ |
### 전체 아카이브 게시물 개수 비교
다음 표는 전체 아카이브 검색 엔드포인트의 다양한 유형을 비교합니다.
| 설명 | Enterprise | X API v2 |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
| 호스트 도메인 | [https://gnip-api.x.com](https://gnip-api.x.com) | [https://api.x.com](https://api.x.com) |
| 엔드포인트 경로 | /search/fullarchive/accounts/:account\_name/:label/counts | /2/tweets/counts/all |
| [인증](/ko/resources/fundamentals/authentication) | Basic auth | OAuth 2.0 Bearer Token |
| 타임스탬프 형식 | YYYYMMDDHHMM | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| 게시물 개수가 제공되는 최대 과거 시점 | 2006년 3월 이후 전체 아카이브 | 2006년 3월 이후 전체 아카이브 |
| 지원되는 HTTP 메서드 | GET
POST | GET |
| 기본 요청 한도 | 분당 요청 한도는 계약서에 명시된 파트너별로 다릅니다.
초당 20건의 요청 | App당 15분당 300건의 요청
App당 초당 1건의 요청 |
| 세분성 | 일, 시간, 분 | 일, 시간, 분 |
| [annotations](/ko/x-api/fundamentals/post-annotations)을 사용한 필터링 지원 | | ✔ |
| [conversation\_id](/ko/x-api/fundamentals/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](/ko/x-api/getting-started/about-x-api) 권한이 있는 [Project](/ko/resources/fundamentals/developer-apps)에 연결된 [developer App](/ko/resources/fundamentals/developer-apps)의 자격 증명 필요 | | ✔ |
### 필터링 연산자 비교
Post counts의 두 가지 버전(enterprise 및 v2)은 사용 가능한 연산자가 서로 다르며, 각 버전 내에서도 연산자 제공 수준이 다양합니다. 이에 대해서는 아래에서 설명합니다.
Enterprise
* enterprise 연산자에는 하위 등급이 없습니다. 모든 enterprise 연산자는 모든 enterprise 사용자에게 제공됩니다.
X API v2
* **Core:** 이 연산자는 모든 v2 사용자에게 제공됩니다.
* **Advanced:** 이 연산자는 Academic Research 액세스 권한이 승인된 사용자에게만 제공됩니다.
각 연산자 집합에 대한 자세한 내용은 다음 가이드를 참고하세요.
* [Enterprise 연산자](/ko/x-api/enterprise-gnip-2.0/fundamentals/search-api#building-search-queries)
* [X API v2 연산자](/ko/x-api/posts/search/integrate/build-a-query)
이제 X API v2 내의 이러한 연산자 수준을 이해했으므로, Post counts에 대해 연산자 사용 가능 여부를 정리한 표를 살펴보겠습니다(셀을 비워 둔 경우 해당 연산자는 사용할 수 없음).
| | 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 | 사용 가능 | |
**기타 마이그레이션 리소스**
[X API 마이그레이션 허브](/ko/x-api/migrate/overview)
[이 엔드포인트에 대한 샘플 코드를 확인하세요](https://github.com/xdevplatform/Twitter-API-v2-sample-code "이 엔드포인트에 대한 샘플 코드를 확인하세요")
[Post counts: Enterprise에서 X API v2로](/ko/x-api/posts/counts/migrate/overview)