메인 콘텐츠로 건너뛰기
Post 개수 엔드포인트는 포스트 자체를 반환하지 않고, 쿼리와 일치하는 포스트 수가 시간 경과에 따라 어떻게 변하는지를 반환합니다. 이 엔드포인트를 사용하면 트렌드를 분석하고, 대화 규모를 파악하며, 검색하기 전에 쿼리를 더 정교하게 다듬을 수 있습니다.

​
개요

볼륨 분석

시간 경과에 따른 게시물 수를 보여주는 추세선과 시각화를 생성합니다

쿼리 정교화

전체 검색 쿼리를 실행하기 전에 결과 크기를 추정합니다

이벤트 감지

이벤트와 관련된 대화가 언제 정점을 찍었는지 파악합니다

효율적인 조사

모든 포스트를 조회하지 않고도 대화 규모를 파악합니다

​
엔드포인트

Endpoint설명액세스
GET /2/tweets/counts/recent최근 7일간 포스트 수 집계모든 개발자
GET /2/tweets/counts/all전체 아카이브의 포스트 수 집계종량제, Enterprise

​
세분화 옵션

granularity 매개변수로 카운트의 집계 단위를 지정합니다.
Granularity설명사용 사례
minute분 단위 카운트실시간 모니터링
hour시간 단위 카운트 (기본값)일별 분석
day일 단위 카운트장기 추세 분석

​
최근 집계

최근 7일 동안의 포스트 수를 집계합니다. 모든 개발자가 사용할 수 있습니다.

​
기능

  • 분, 시간, 또는 일 단위로 집계된 카운트
  • 최근 검색과 동일한 쿼리 연산자
  • 최대 512자의 쿼리 길이

​
응답 예시

{
  "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
  }
}

빠른 시작

처음으로 최근 집계 요청 보내기

API 참조 문서

엔드포인트 전체 문서

​
전체 아카이브 카운트

2006년까지 소급하여 전체 아카이브에서 포스트 개수를 집계합니다.
Full-archive counts 기능은 사용량 기반 과금제 및 Enterprise 고객에게 제공됩니다.

​
기능

  • 임의의 기간에 대해 과거 포스트 수를 집계
  • 모든 쿼리 연산자 사용 가능
  • 쿼리 길이 1,024자(Enterprise의 경우 4,096자)
결과는 응답당 31일 단위로 페이징됩니다:
  • 일 단위 기준: 페이지당 31일
  • 시간 단위 기준: 페이지당 744시간(31일)
  • 분 단위 기준: 페이지당 44,640분(31일)

빠른 시작

처음으로 전체 아카이브 카운트 요청을 보내 보세요

API 참조 문서

전체 엔드포인트 문서

​
쿼리 연산자

게시물 수는 검색 엔드포인트와 동일한 쿼리 구문을 사용합니다: 
python lang:en -is:retweet

쿼리 만들기

쿼리 구문 및 연산자를 알아보세요

​
중요한 참고 사항

카운트와 검색 결과카운트가 검색 결과와 정확히 일치하지 않을 수 있습니다. 검색 엔드포인트는 카운트 엔드포인트에서는 수행하지 않는 추가적인 컴플라이언스 필터링을 적용합니다.

​
시작하기

사전 준비 사항

최근 집계 빠른 시작

지난 7일 동안의 포스트 수 집계

전체 아카이브 빠른 시작

과거 포스트 수 집계

통합 가이드

핵심 개념과 모범 사례

샘플 코드

실행 가능한 코드 예시