> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 개요
> v2 Post counts 엔드포인트는 향후 enterprise Search API의 counts 엔드포인트를 대체할 예정입니다. migrate를 다루는 X API v2 standard 티어 레퍼런스입니다.
## X API의 Post counts 엔드포인트 비교
v2 Post counts 엔드포인트는 향후 [enterprise Search API의 counts 엔드포인트](/x-api/enterprise-gnip-2.0/fundamentals/search-api#counts-requests-post-count)를 대체할 예정입니다. 이전 버전의 Post counts 엔드포인트를 사용하는 코드, 앱 또는 도구를 새로운 X API v2 엔드포인트로 마이그레이션하는 것을 고려 중이라면 이 가이드가 유용할 것입니다.
## Recent Post counts 비교
Enterprise 버전의 Post counts 엔드포인트는 30일 또는 full-archive에서 카운트를 가져올 수 있습니다. 따라서 7일간의 기간을 다루는 v2 recent Post counts 엔드포인트는 위 두 엔드포인트의 직접적인 대체는 아닙니다.
다만 비교를 돕기 위해 v2 recent Post counts 엔드포인트가 enterprise 30-day 엔드포인트와 어떻게 비교되는지 살펴보겠습니다.
다음 표는 다양한 유형의 recent Post counts 엔드포인트를 비교합니다:
| **Description** | **Enterprise** | **X API v2** |
| :-------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
| Host domain | [https://gnip-api.x.com](https://gnip-api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint path | /search/30day/accounts/:account\_name/:label/counts.json | /2/tweets/counts/recent |
| [인증](/resources/fundamentals/authentication) | Basic authentication | OAuth 2.0 Bearer Token |
| Timestamp format | YYYYMMDDhhmm | YYYY-MM-DDTHH:mm:ssZ
[ISO 8601 / RFC 3339](https://tools.ietf.org/html/rfc3339#section-5.6) |
| 반환되는 게시물 카운트의 최대 과거 기간 | 31일 | 7일 |
| 지원 HTTP 메서드 | GET | GET |
| 기본 요청 rate limit | 초당 20 요청, search data 및 counts 요청 통합 기준
분당 rate limit은 계약에 명시된 대로 파트너에 따라 다릅니다. | 사용자당 15분당 180 요청
App당 15분당 450 요청 |
| [annotations](/x-api/fundamentals/post-annotations)를 이용한 필터링 지원 | | ✔ |
| [conversation\_id](/x-api/fundamentals/conversation-id)를 이용한 필터링 지원 | | ✔ |
| 게시물 데이터 배열의 JSON 키 이름 | results | data |
| 시간 granularity | Day, hour, minute | Day, hour, minute |
| 시간대 | UTC | UTC |
| 기간 선택용 요청 파라미터 | fromDate
toDate | start\_time
end\_time |
| 게시물 ID로 탐색하기 위한 요청 파라미터 | | since\_id
until\_id |
| [Project](/resources/fundamentals/developer-apps)에 연결된 [developer App](/resources/fundamentals/developer-apps)의 자격 증명 사용 필요 | | ✔ |
### Full-archive Post counts 비교
다음 표는 다양한 유형의 full-archive search 엔드포인트를 비교합니다:
| Description | Enterprise | X API v2 |
| :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
| Host domain | [https://gnip-api.x.com](https://gnip-api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint path | /search/fullarchive/accounts/:account\_name/:label/counts | /2/tweets/counts/all |
| [인증](/resources/fundamentals/authentication) | Basic auth | OAuth 2.0 Bearer Token |
| Timestamp format | 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 |
| 기본 요청 rate limit | 분당 rate limit은 계약에 명시된 대로 파트너에 따라 다릅니다.
초당 20 요청 | App당 15분당 300 요청
App당 초당 1 요청 |
| Granularity | Day, hour, minute | Day, hour, minute |
| [annotations](/x-api/fundamentals/post-annotations)를 이용한 필터링 지원 | | ✔ |
| [conversation\_id](/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 or pagination\_token |
| 시간대 | UTC | UTC |
| [Academic Research access](/x-api/getting-started/about-x-api)가 있는 [Project](/resources/fundamentals/developer-apps)에 연결된 [developer App](/resources/fundamentals/developer-apps)의 자격 증명 사용 필요 | | ✔ |
### 필터링 연산자 비교
Post counts의 두 버전(enterprise, v2)은 사용 가능한 연산자가 서로 다르며, 각 버전 내에서도 연산자 가용성 수준이 다릅니다. 아래에서 설명합니다.
Enterprise
* enterprise 연산자에는 하위 티어가 없습니다. 모든 enterprise 연산자는 모든 enterprise 사용자에게 제공됩니다.
X API v2
* **Core:** 모든 v2 사용자가 사용할 수 있는 연산자입니다.
* **Advanced:** Academic Research access 승인을 받은 사용자만 사용할 수 있는 연산자입니다.
각 연산자 세트에 대한 자세한 내용은 다음 가이드를 참고하세요:
* [Enterprise operators](/x-api/enterprise-gnip-2.0/fundamentals/search-api#building-search-queries)
* [X API v2 operators](/x-api/posts/search/integrate/build-a-query)
X API v2 내 이 다양한 연산자 수준을 이해했으니, 이제 Post counts에 대한 연산자 가용성을 정리한 표를 살펴봅시다(셀이 비어 있으면 해당 연산자는 사용할 수 없음):
| | Enterprise | v2 |
| :---------------- | :--------- | :---------------------------- |
| keyword | Available | Core |
| emoji | Available | Core |
| "exact phrase" | Available | Core |
| # | Available | Core |
| \$ | Available | Advanced |
| @ | Available | Core |
| from: | Available | Core |
| to: | Available | Core |
| url: | Available | Core |
| retweets\_of: | Available | Core |
| context: | | Core |
| entity: | | Core - recent search에서만 사용 가능 |
| conversation\_id: | | Core |
| place: | Available | Advanced |
| place\_country: | Available | Advanced |
| point\_radius: | Available | Advanced |
| bounding\_box: | Available | Advanced |
| is:retweet | Available | Core |
| is:reply | Available | Core |
| is:quote | Available | Core |
| is:verified | Available | Core |
| -is:nullcast | Available | Advanced |
| has:hashtags | Available | Core |
| has:cashtags | Available | Advanced |
| has:links | Available | Core |
| has:mentions | Available | Core |
| has:media | Available | Core |
| has:images | Available | Core |
| has:videos | Available | Core |
| has:geo | Available | Advanced |
| lang: | Available | Core |
| list: | | Advanced |
| has:profile\_geo | Available | |
| profile\_country | Available | |
| profile\_locality | Available | |
| profile\_region | Available | |
| proximity | Available | |
**기타 마이그레이션 리소스**
[X API 마이그레이션 허브](/x-api/migrate/overview)
[이 엔드포인트의 샘플 코드 살펴보기](https://github.com/xdevplatform/Twitter-API-v2-sample-code "이 엔드포인트의 샘플 코드 살펴보기")
[Post counts: Enterprise to X API v2](/x-api/posts/counts/migrate/overview)