개요 - X

X API의 Search Posts 엔드포인트 비교

v2 Search Tweets 엔드포인트는 향후 standard v1.1 search/posts 엔드포인트와 enterprise Search API를 대체할 예정입니다. 이전 버전의 X search 엔드포인트를 사용하는 코드, 앱 또는 도구를 새로운 X API v2 엔드포인트로 마이그레이션하는 것을 고려 중이라면 이 가이드가 유용할 것입니다.

Recent search 비교

다음 표는 다양한 유형의 recent search 엔드포인트를 비교합니다:

Description	Standard v1.1	X API v2
Host domain	https://api.x.com	https://api.x.com
Endpoint path	/1.1/search/tweets.json	/2/tweets/search/recent
인증	OAuth 1.0a User Context OAuth 2.0 App-Only	OAuth 1.0a User Context OAuth 2.0 Authorization Code with PKCE OAuth 2.0 App-Only
Timestamp format	YYYYMMDD	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
반환되는 게시물의 최대 과거 기간	7일	7일
지원 HTTP 메서드	GET	GET
기본 요청 rate limit	OAuth 1.0a User Context 시 15분당 180 요청 OAuth 2.0 App-Only 시 15분당 450 요청	Self-serve: OAuth 2.0 App-Only 시 15분당 60 요청 OAuth 1.0a User Context 시 15분당 60 요청 OAuth 2.0 Authorization Code with PKCE 시 15분당 60 요청
완전 unwound URL 제공		✔
응답당 최대 게시물 수(기본값)	100 (15)	100 (10)
Post JSON 형식	Standard v1.1 format	X API v2 format (fields 및 expansions 요청 파라미터로 결정되며, v1.1 형식과 하위 호환되지 않음) Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법은 데이터 형식 마이그레이션 가이드를 참고하세요.
페이로드에 반환되는 필드 선택 지원		✔
annotations 요청 및 수신 지원		✔
Post 객체 내 특정 metrics 요청 지원		✔
conversation_id 연산자 및 필드 지원		✔
Post 편집 히스토리 제공	✔	✔
Post 데이터 배열의 JSON 키 이름	statuses	data
페이지네이션용 JSON 키 이름	search_metadata.next_results	meta.next_token
시간 범위로 아카이브 탐색 지원	✔	✔
시간 기반 요청의 시간 해상도	day	second
시간대	UTC	UTC
시간으로 탐색하기 위한 요청 파라미터	until	start_time end_time
Post ID로 탐색하기 위한 요청 파라미터	since_id max_id	since_id until_id
페이지네이션용 요청 파라미터	URL 인코딩된 쿼리 제공	next_token
Project에 연결된 developer App의 자격 증명 사용 필요		✔

Full-archive search 비교

다음 표는 다양한 유형의 full-archive search 엔드포인트를 비교합니다:

Description	Enterprise	X API v2
Host domain	https://gnip-api.x.com	https://api.x.com
Endpoint path	/search/fullarchive/accounts/:account_name/:label	/2/tweets/search/all
인증	Basic auth	OAuth 2.0 App-Only
Timestamp format	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
반환되는 게시물의 최대 과거 기간	2006년 3월 이후 전체 아카이브	2006년 3월 이후 전체 아카이브
지원 HTTP 메서드	GET POST	GET
기본 요청 rate limit	분당 rate limit은 계약에 명시된 대로 파트너에 따라 다릅니다. Basic auth 시 초당 20 요청	OAuth 2.0 App-Only 시 15분당 300 요청 OAuth 2.0 App-Only 시 초당 1 요청
완전 unwound URL 제공	✔	✔
응답당 게시물 수	최대: 500 기본값: 100	최대: 500 기본값: 10
Post JSON 형식	Native Enriched 또는 Activity Streams format	X API v2 format (fields 및 expansions 요청 파라미터로 결정)
페이로드에 반환되는 필드 선택 지원		✔
annotations 요청 및 수신 지원		✔
Post 객체 내 특정 metrics 요청 지원		✔
conversation_id 연산자 및 필드 지원		✔
Post 편집 히스토리 제공	✔	✔
Post 데이터 배열의 JSON 키 이름	results	data
페이지네이션용 JSON 키 이름	next	meta.next_token
시간 기반 요청의 시간 해상도	second	second
시간대	UTC	UTC
Post ID로 아카이브 탐색 지원		✔
시간으로 탐색하기 위한 요청 파라미터	fromDate toDate	start_time end_time
Post ID로 탐색하기 위한 요청 파라미터		since_id until_id
페이지네이션용 요청 파라미터	next_token	next_token
Academic Research access가 있는 Project에 연결된 developer App의 자격 증명 사용 필요		✔

필터링 연산자 비교 search Posts의 네 가지 다른 버전(standard, enterprise, v2)은 사용 가능한 연산자가 서로 다르며, 각 버전 내에서도 연산자 가용성 수준이 다릅니다. 아래에서 설명합니다. Enterprise

enterprise 연산자에는 하위 티어가 없습니다

X API v2

Self-serve: 모든 Project 사용 시 이용 가능
Enterprise: Project 사용 시 이용 가능

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

X API v2 내 서로 다른 연산자 수준을 이해했으니, 이제 search Posts에 대한 연산자 가용성을 정리한 표를 살펴봅시다(셀이 비어 있으면 해당 연산자는 사용할 수 없음):

Search operator	Standard	Enterprise	v2
keyword	Available q:keyword	Available	Available
emoji	Available q:😄	Available	Available
”exact phrase”	Available	Available	Available
#	Available	Available	Available
$	Available	Available	Available
@	Available	Available	Available
from:	Available	Available	Available
to:	Available	Available	Available
url:	Available	Available	Available
retweets_of:		Available	Available
context:			Available
entity:			Self-serve - recent search에서만 사용 가능
conversation_id:			Available
place:		Available	Available
place_country:		Available	Available
point_radius:	geocode parameter	Available	Available
bounding_box:		Available	Available
is:retweet	filter:retweets	Available	Available
is:reply		Available	Available
is:quote		Available	Available
is:verified		Available	Available
-is:nullcast		Available	Available
has:hashtags		Available	Available
has:cashtags		Available	Available
has:links	filter:links	Available	Available
has:mentions		Available	Available
has:media	filter:media	Available	Available
has:images	filter:images, filter:twimg	Available	Available
has:videos	filter:videos filter:native_video	Available	Available
has:geo		Available	Available
lang:	lang - 연산자 또는 파라미터로 사용 가능	Available	Available
has:profile_geo		Available
profile_country		Available
profile_locality		Available
profile_region		Available
proximity		Available
:(	Available
:)	Available
?	Available
filter:periscope	Available
list:	Available		Available
filter:replies	Available
filter:pro_video	Available
filter:social	Available
filter:trusted	Available
filter:follows	Available
filter:has_engagement	Available
include:antisocial	Available
include:offensive_user	Available
include:antisocial_offensive_user	Available
include:sensitive_content	Available
source:	Available
min_replies:	Available
min_retweets:	Available
min_faves:	Available
card_name:	Available
card_domain:	Available

기타 마이그레이션 리소스 X API 마이그레이션 허브 이 엔드포인트의 샘플 코드 살펴보기 Search Posts: Standard v1.1 to X API v2 Search Posts: Enterprise to X API v2

Getting Started

Products

Fundamentals

Partners & Customers

Resources

개요

X API의 Search Posts 엔드포인트 비교

Recent search 비교

Full-archive search 비교

​X API의 Search Posts 엔드포인트 비교

​Recent search 비교

​Full-archive search 비교

X API의 Search Posts 엔드포인트 비교

Recent search 비교

Full-archive search 비교