> ## 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.
# Post Counts
> Post counts 엔드포인트는 게시물 자체를 반환하지 않고, 시간에 따라 쿼리에 매칭되는 게시물의 볼륨을 반환합니다. counts를 다루는 X API v2 standard 티어 레퍼런스입니다.
export const Button = ({href, children}) => {
return ;
};
Post counts 엔드포인트는 게시물 자체를 반환하지 않고, 시간에 따라 쿼리에 매칭되는 게시물의 볼륨을 반환합니다. 이 엔드포인트를 사용해 트렌드를 분석하고, 대화 규모를 파악하고, 검색 전에 쿼리를 다듬을 수 있습니다.
## 개요
시간에 따른 게시물 볼륨을 보여주는 트렌드라인과 시각화 자료 구축
전체 검색 쿼리를 실행하기 전에 결과 규모 추정
이벤트를 중심으로 대화가 정점에 이른 시점 확인
모든 게시물을 가져오지 않고도 대화 규모 파악
***
## 엔드포인트
| Endpoint | Description | Access |
| :---------------------------------------------------------------------- | :--------------- | :---------------------- |
| GET [`/2/tweets/counts/recent`](/x-api/posts/get-count-of-recent-posts) | 최근 7일간의 게시물 카운트 | 모든 개발자 |
| GET [`/2/tweets/counts/all`](/x-api/posts/get-count-of-all-posts) | 전체 아카이브의 게시물 카운트 | Pay-per-use, Enterprise |
***
## Granularity 옵션
`granularity` 파라미터를 사용해 카운트가 어떻게 그룹화될지 지정합니다:
| Granularity | Description | Use case |
| :---------- | :-------------- | :------- |
| `minute` | 분 단위 카운트 | 실시간 모니터링 |
| `hour` | 시간 단위 카운트 (기본값) | 일별 분석 |
| `day` | 일 단위 카운트 | 장기 트렌드 |
***
## Recent counts
**최근 7일**의 게시물을 카운트합니다. 모든 개발자가 사용할 수 있습니다.
### 기능
* 분, 시간, 일 단위로 그룹화된 카운트
* recent search와 동일한 쿼리 연산자
* 512자 쿼리 길이
### 예시 응답
```json theme={null}
{
"data": [
{ "start": "2024-01-15T00:00:00.000Z", "end": "2024-01-15T01:00:00.000Z", "tweet_count": 1523 },
{ "start": "2024-01-15T01:00:00.000Z", "end": "2024-01-15T02:00:00.000Z", "tweet_count": 1247 },
{ "start": "2024-01-15T02:00:00.000Z", "end": "2024-01-15T03:00:00.000Z", "tweet_count": 892 }
],
"meta": {
"total_tweet_count": 3662
}
}
```
첫 recent counts 요청 만들기
전체 엔드포인트 문서
***
## Full-archive counts
2006년까지의 **전체 아카이브**에서 게시물을 카운트합니다.
Full-archive counts는 pay-per-use 및 Enterprise 고객이 사용할 수 있습니다.
### 기능
* 임의의 기간에 대한 과거 게시물 카운트
* 모든 쿼리 연산자 사용 가능
* 1,024자 쿼리 길이 (Enterprise의 경우 4,096자)
### 페이지네이션
결과는 응답당 31일 단위로 페이지네이션됩니다:
* **Day granularity**: 페이지당 31일
* **Hour granularity**: 페이지당 744시간 (31일)
* **Minute granularity**: 페이지당 44,640분 (31일)
첫 full-archive counts 요청 만들기
전체 엔드포인트 문서
***
## 쿼리 연산자
Post counts는 search 엔드포인트와 동일한 쿼리 구문을 사용합니다:
```
python lang:en -is:retweet
```
쿼리 구문 및 연산자 익히기
***
## 중요 참고사항
**Counts vs 검색 결과**
카운트가 검색 결과와 정확히 일치하지 않을 수 있습니다. Search 엔드포인트는 카운트 엔드포인트가 수행하지 않는 추가적인 컴플라이언스 필터링을 적용합니다.
***
## 시작하기
**사전 요구사항**
* 승인된 [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* Developer Console 내의 [Project와 App](/resources/fundamentals/developer-apps)
* App의 [Bearer Token](/resources/fundamentals/authentication)
최근 7일간의 게시물 카운트
과거 게시물 카운트
핵심 개념 및 모범 사례
동작하는 코드 예제