개요

X API 게시물 개수 엔드포인트 비교

v2 게시물 개수 엔드포인트는 향후 enterprise Search API의 counts 엔드포인트를 대체할 예정입니다. 기존 버전의 게시물 개수 엔드포인트를 사용하는 코드, App 또는 도구가 있고 이를 새로운 X API v2 엔드포인트로 마이그레이션하는 것을 고려하고 있다면, 이 가이드는 여러분을 위한 것입니다.

---

최근 게시물 카운트 비교

Enterprise 버전의 게시물 카운트 엔드포인트를 사용하면 30일 또는 전체 보관 아카이브 중 하나에 대한 카운트를 가져올 수 있습니다. 따라서 7일 기간을 조회하는 v2 최근 게시물 카운트 엔드포인트는 앞에서 언급한 어느 엔드포인트의 직접적인 대체제가 되지 않습니다.

다만 비교에 도움이 되도록, v2 최근 게시물 카운트 엔드포인트가 Enterprise 30일 엔드포인트와 어떻게 비교되는지 살펴보겠습니다.

다음 표는 다양한 유형의 최근 게시물 카운트 엔드포인트를 비교한 것입니다:

설명	Enterprise	X API v2
호스트 도메인	https://gnip-api.x.com	https://api.x.com
엔드포인트 경로	/search/30day/accounts/:account_name/:label/counts.json	/2/tweets/counts/recent
인증	Basic authentication	OAuth 2.0 Bearer Token
타임스탬프 형식	YYYYMMDDhhmm	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
반환하는 게시물 카운트의 최대 경과 기간	31일	7일
지원되는 HTTP 메서드	GET	GET
기본 요청 한도	초당 20개 요청, 검색 데이터 및 카운트 요청 전체에 대해 합산 분당 요청 한도는 계약서에 명시된 대로 파트너별로 달라집니다.	사용자당 15분당 180개 요청 App당 15분당 450개 요청
annotations를 사용한 필터링 지원		✔
conversation_id를 사용한 필터링 지원		✔
게시물 데이터 배열의 JSON 키 이름	results	data
시간 단위(세분성)	일, 시 또는 분	일, 시 또는 분
시간대	UTC	UTC
시간 기간 선택을 위한 요청 파라미터	fromDate toDate	start_time end_time
게시물 ID 기반 탐색을 위한 요청 파라미터		since_id until_id
developer App와 연결된 project의 자격 증명 사용 필요		✔

전체 아카이브 게시물 개수 비교

다음 표는 전체 아카이브 검색 엔드포인트의 다양한 유형을 비교합니다.

설명	Enterprise	X API v2
호스트 도메인	https://gnip-api.x.com	https://api.x.com
엔드포인트 경로	/search/fullarchive/accounts/:account_name/:label/counts	/2/tweets/counts/all
인증	Basic auth	OAuth 2.0 Bearer Token
타임스탬프 형식	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
게시물 개수가 제공되는 최대 과거 시점	2006년 3월 이후 전체 아카이브	2006년 3월 이후 전체 아카이브
지원되는 HTTP 메서드	GET POST	GET
기본 요청 한도	분당 요청 한도는 계약서에 명시된 파트너별로 다릅니다. 초당 20건의 요청	App당 15분당 300건의 요청 App당 초당 1건의 요청
세분성	일, 시간, 분	일, 시간, 분
annotations을 사용한 필터링 지원		✔
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 권한이 있는 Project에 연결된 developer App의 자격 증명 필요		✔

필터링 연산자 비교

Post counts의 두 가지 버전(enterprise 및 v2)은 사용 가능한 연산자가 서로 다르며, 각 버전 내에서도 연산자 제공 수준이 다양합니다. 이에 대해서는 아래에서 설명합니다.

Enterprise

• enterprise 연산자에는 하위 등급이 없습니다. 모든 enterprise 연산자는 모든 enterprise 사용자에게 제공됩니다.

X API v2

• Core: 이 연산자는 모든 v2 사용자에게 제공됩니다.
• Advanced: 이 연산자는 Academic Research 액세스 권한이 승인된 사용자에게만 제공됩니다.

각 연산자 집합에 대한 자세한 내용은 다음 가이드를 참고하세요.

• Enterprise 연산자
• X API v2 연산자

이제 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 마이그레이션 허브

이 엔드포인트에 대한 샘플 코드를 확인하세요

Post counts: Enterprise에서 X API v2로