메인 콘텐츠로 건너뛰기
v2 게시물 집계(카운트) 엔드포인트는 개발자가 특정 쿼리에 대한 데이터 규모를 파악하고 조회할 수 있게 합니다. 이는 다음과 같은 이유로 유용합니다:
  • 키워드의 게시물량을 파악해 트렌드라인 등 시각화를 구축합니다.
  • 이벤트나 대화가 발생한 기간을 파악해 쿼리가 관련 데이터를 포착하도록 합니다.
  • 최근 검색 또는 전체 아카이브 검색 엔드포인트를 사용하기 전에, 검색 쿼리가 반환할 게시물 수를 가늠해 쿼리를 정제합니다. 주의: 검색 엔드포인트는 집계 엔드포인트와 달리 추가 컴플라이언스 절차를 거치므로, 집계 결과가 검색 엔드포인트의 실제 반환 결과와 항상 일치하지는 않습니다.
  • 원시 데이터를 직접 수집하지 않고도 특정 주제를 둘러싼 대화의 규모를 파악하고, 월별 게시물 상한을 고려해 계획할 수 있습니다. 
쿼리를 작성할 때는 액세스 수준에 따라 쿼리 길이와 사용 가능한 연산자가 제한됩니다. 
  • Pro 액세스가 있는 Project를 사용하는 경우, 모든 연산자를 사용할 수 있으며 최대 1024자 길이의 쿼리를 사용할 수 있습니다. 
  • Enterprise 액세스가 있는 Project를 사용하는 경우, 모든 연산자를 사용할 수 있으며 최대 4096자 길이의 쿼리를 사용할 수 있습니다. 
또한 세분도(일, 시간, 분)와 게시물 집계가 필요한 기간을 지정할 수 있습니다(start_time 및 end_time 매개변수 사용). 이 엔드포인트의 기본 시간 세분도는 ‘시간’이며, 세분도 매개변수를 지정하지 않으면 지난 7일 동안의 시간당 게시물 수를 반환합니다.
계정 설정이 엔드포인트에 액세스하려면 다음이 필요합니다:X API v2 엔드포인트 액세스 방법은 시작 가이드에서 자세히 알아보세요.

​
최근 게시물 수

최근 게시물 수 엔드포인트를 사용하면 지난 7일 동안 특정 쿼리에 해당하는 게시물 수를 프로그램적으로 조회할 수 있습니다. 이 엔드포인트는 Project 내의 App에 연결된 키와 토큰을 사용하는 모든 사용자에게 제공되며, 인증에는 OAuth 2.0 App-Only가 사용됩니다.

​
전체 아카이브 게시물 개수

전체 아카이브 게시물 개수 엔드포인트를 사용하면 전체 공개 아카이브에서 특정 쿼리에 대한 게시물 수를 프로그래밍 방식으로 조회할 수 있습니다. 현재 이 엔드포인트는 Academic Research 또는 Enterprise 액세스 승인을 받았고 인증에 OAuth 2.0 App-Only를 사용하는 사용자에게만 제공됩니다. 예: 전체 아카이브 게시물 개수 엔드포인트를 사용해 2017년 8월부터 9월 사이에 해시태그 #SOSHurricaneHarvey가 포함된 게시물 수를 일 단위로 확인할 수 있습니다. 참고: counts 엔드포인트는 응답당 31일 단위로 페이지가 나뉩니다. 예를 들어 granularity를 day로 설정하면 페이지당 31일에 대한 일별 결과 개수를 반환합니다. granularity를 hour로 설정하면 페이지당 744시간(31일 × 24시간)에 대한 시간별 결과 개수를 반환합니다. granularity와 기간을 지정하지 않으면 이 엔드포인트는 최근 30일 기준으로 쿼리의 시간별 게시물 개수를 제공합니다.