Skip to main content

​
X API 타임라인 엔드포인트 비교

v2 역순(최신순) 타임라인, 사용자 포스트 타임라인, 사용자 멘션 타임라인 엔드포인트는 각각 v1.1 statuses/home_timeine, v1.1 statuses/user_timeline, v1.1 statuses/mentions_timeline 엔드포인트를 대체합니다. 해당 엔드포인트의 구버전을 사용하는 코드, App 또는 도구가 있고 최신 X API v2 엔드포인트로 마이그레이션을 고려하고 있다면, 이 가이드를 활용하면 됩니다. 보다 심층적인 마이그레이션 가이드는 Standard v1.1 migration to X API v2를 참고하세요. 이 페이지에는 다음과 같은 세 가지 비교 표가 포함되어 있습니다.
  • 역순(최신순) 홈 타임라인
  • 사용자 포스트 타임라인
  • 사용자 멘션 타임라인

​
최신순 홈 타임라인

아래 표들은 표준 v1.1 홈 타임라인 엔드포인트와 X API v2 홈 타임라인 엔드포인트를 비교합니다.
설명Standard v1.1X API v2
문서API 참조 문서API 참조 문서
지원되는 HTTP 메서드GETGET
호스트 도메인https://api.x.comhttps://api.x.com
엔드포인트 경로/1.1/statuses/home_timeline.json/2/users/:id/timelines/reverse_chronological
필수 매개변수user_id 또는 screen_name경로 매개변수 :id 로 지정하는 사용자 id
인증OAuth 1.0a 사용자 컨텍스트OAuth 1.0a 사용자 컨텍스트

PKCE를 사용하는 OAuth 2.0 Authorization Code 플로
요청 한도OAuth 1.0a User Context에서 15분당 15건의 요청

요청 한도: 24시간 기준 100,000건.		15분당 180회 요청
응답당 기본 포스트 수15100
응답당 최대 포스트 수800이 엔드포인트는 지난 7일 동안 타임라인에서 생성된 모든 게시물과, 생성일과 관계없이 가장 최근 게시물 800개를 반환합니다.
게시물 편집 내역 제공✔✔
조회 가능한 과거 포스트가장 최근 리트윗을 포함한 포스트 800개가장 최근 리트윗을 포함한 포스트 3,200개
타임라인 탐색 옵션since_id (비포함, 업데이트 폴링에 사용됨)

max_id (포함)		start_time

end_time

since_id(미포함)은 업데이트 폴링에 사용됩니다

until_id (미포함)
결과 정제를 위한 선택적 매개변수count

exclude_replies

include_rts

trim_user

tweet_mode

since_id

max_id		max_results

exclude(retweets,replies)

tweet.fields

user.fields

place.fields

media.fields

poll.fields

expansions

start_time

end_time

since_id

until_id
annotations 요청 및 수신 지원해당 없음tweet.fields 에 annotations(주석)이 포함되어 있으면 결과에 게시물 텍스트를 기반으로 추론된 주석 데이터가 함께 포함됩니다. 예를 들어 ‘Music Genre’와 ‘Folk Music’, 또는 ‘Musician’과 ‘Dolly Parton’과 같은 값이 포함될 수 있습니다.
특정 게시물 지표 요청 및 수신을 지원해당 없음주석이 tweet.fields에 포함된 경우, 결과에는 각 게시물에 대해 retweet_count, reply_count, quote_count, like_count를 포함하는 public_metrics와 impression_count, user_profile_clicks, url_link_clicks를 포함하는 non_public_metrics 주석이 추가됩니다.

view_count 및 동영상 재생 메트릭과 같은 추가 미디어 메트릭이 제공됩니다.

프로모션된 포스트에 대해 User Context를 사용할 경우 추가 organic_metrics 및 promoted_metrics를 사용할 수 있습니다.
conversation_id의 요청 및 수신을 지원합니다해당 없음대화 추적을 위해, 답글 스레드에서 가장 먼저 게시된 게시물을 가리키는 값을 담은 conversation_id 필드를 반환합니다.
게시물의 JSON 형식표준 v1.1 데이터 형식X API v2 형식(fields 및 expansions 요청 매개변수에 의해 결정되며 v1.1 형식과는 하위 호환되지 않습니다)

Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 자세히 알아보려면 데이터 형식 마이그레이션 가이드를 참조하세요.
결과 정렬 기준시간 역순(최신순)시간 역순(최신순)
결과 페이지네이션해당 없음. 게시물 id 기준 탐색만 가능pagination_token 을 사용해 결과를 앞이나 뒤로 넘겨 가며 조회할 수 있습니다.
Project에 연결된 개발자 App의 인증 정보를 사용해야 합니다✔

​
사용자 게시물 타임라인

다음 표는 표준 v1.1과 X API v2의 사용자 게시물 타임라인 엔드포인트를 비교합니다.
DescriptionStandard v1.1X API v2
DocumentationAPI 참조 문서API 참조 문서
HTTP methods supportedGETGET
Host domainhttps://api.x.comhttps://api.x.com
Endpoint paths/1.1/statuses/user_timeline.json/2/users/:id/tweets
Required parametersuser_id 또는 screen_name경로 매개변수 :id로 설정된 User ID
AuthenticationOAuth 1.0a User Context

OAuth 2.0 App-Only		OAuth 1.0a User Context

OAuth 2.0 App-Only

OAuth 2.0 Authorization Code with PKCE
Request rate limitsOAuth 1.0a User Context 사용 시 15분당 900개 요청

OAuth 2.0 App-Only 사용 시 15분당 1500개 요청

요청 상한: 24시간 기준 100,000건		OAuth 1.0a User Context 사용 시 15분당 900개 요청

OAuth 2.0 App-Only 사용 시 15분당 1500개 요청
Default Posts per response응답당 기본 포스트 수: 15응답당 기본 포스트 수: 10
Maximum Posts per response응답당 최대 포스트 수: 200응답당 최대 포스트 수: 100
Historical Posts available리트윗을 포함한 최신 3,200개의 포스트리트윗을 포함한 최신 3,200개의 포스트
Timeline navigation options업데이트 폴링에 사용되는 since_id(배타적)

max_id(포함)		start_time

end_time

업데이트 폴링에 사용되는 since_id(배타적)

until_id(배타적)
Optional parameters for results refinementcount
exclude_replies
include_rts
trim_user
tweet_mode
since_id
max_id		max_results
exclude(retweets,replies)
tweet.fields
user.fields
place.fields
media.fields
poll.fields
expansions
start_time
end_time
since_id
until_id
Supports requesting and receiving annotationsN/A포스트 텍스트를 기반으로 추론된 주석 데이터(예: ‘Music Genre’와 ‘Folk Music’, 또는 ‘Musician’과 ‘Dolly Parton’)와 함께 포스트 결과를 반환합니다.
Supports requesting and receiving specific Post metricsN/A포스트마다 retweet_count, reply_count, quote_count, like_count를 포함하는 사용 가능한 public_metrics와 함께 포스트 결과를 반환합니다.

OAuth 1.0a User Context에서 사용 가능:
impression_count, user_profile_clicks, url_link_clicks를 포함하는 추가 non_public_metrics.

view_count 및 동영상 재생 메트릭과 같은 추가 media 메트릭.

프로모션된 포스트에 대해 OAuth 1.0a User Context에서 사용 가능한 추가 organic_metrics 및 promoted_metrics.
Supports requesting and receiving conversation_idN/A대화를 추적할 수 있도록, 답글 스레드에서 처음 게시된 포스트를 나타내는 값을 가진 conversation_id 필드를 반환합니다.
Post JSON formatStandard v1.1 데이터 형식X API v2 형식(요청한 fields 및 expansions 파라미터에 의해 결정되며, v1.1 형식과 하위 호환되지 않음)

Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 자세히 알아보려면 데이터 형식 마이그레이션 가이드를 방문하세요.
Results order최신순(내림차순)최신순(내림차순)
Results paginationN/A, 포스트 ID를 사용한 탐색만 가능pagination_token을 사용하여 앞이나 뒤로 이동하면서 결과를 검토할 수 있습니다.
Requires the use of credentials from a developer App associated with a Project✔
Provides Post edit history✔✔

​
사용자 멘션 타임라인

다음 표는 Standard v1.1과 X API v2의 사용자 멘션 타임라인 엔드포인트를 비교합니다.
DescriptionStandard v1.1X API v2
DocumentationAPI 참조 문서API 참조 문서
HTTP methods supportedGETGET
Host domainhttps://api.x.comhttps://api.x.com
Endpoint paths/1.1/statuses/mentions_timeline.json/2/users/:id/mentions
Required parameters필수 매개변수 없음경로 매개변수 :id 로 설정된 사용자 ID
AuthenticationOAuth 1.0a User ContextOAuth 1.0a User Context

OAuth 2.0 App-Only

OAuth 2.0 Authorization Code with PKCE
Default request rate limitsOAuth 1.0a User Context 사용 시 15분당 75회 요청

24시간 동안 100,000회 요청 상한.		OAuth 1.0a User Context 사용 시 15분당 180회 요청

OAuth 2.0 App-Only 사용 시 15분당 450회 요청
Default Posts per response1510
Maximum Posts per response200100
Historical Posts available가장 최근 800개 포스트가장 최근 800개 포스트
Timeline navigation options업데이트 폴링에 사용되는 since_id (배타적)

max_id (포함)		start_time

end_time

업데이트 폴링에 사용되는 since_id (배타적)

until_id (배타적)
Optional parameters for results refinementcount
trim_user
include_entities
tweet_mode
since_id
max_id		max_results
tweet.fields
user.fields
place.fields
media.fields
poll.fields
expansions
start_time
end_time
since_id
until_id
Supports requesting and receiving annotationsN/A’Music Genre’와 ‘Folk Music’, 또는 ‘Musician’과 ‘Dolly Parton’처럼 포스트 텍스트를 기반으로 추론된 annotation 데이터를 포함하는 포스트 결과를 반환합니다
Supports requesting and receiving specific Post metricsN/A포스트별로 사용 가능한 public_metrics 를 포함한 포스트 결과를 반환하며, 여기에는 retweet_count, reply_count, quote_count, like_count 가 포함됩니다.

OAuth 1.0a User Context에서 사용 가능:
impression_count, user_profile_clicks, url_link_clicks 를 포함한 추가 non_public_metrics.

view_count 및 동영상 재생 메트릭과 같은 추가 media metrics.

프로모션된 포스트에 대해 OAuth 1.0a User Context에서 사용 가능한 추가 organic_metrics 및 promoted_metrics
Supports requesting and receiving conversation_idN/A회신 스레드에서 가장 먼저 게시된 포스트를 나타내는 값을 제공하는 conversation_id 필드를 반환하여 대화를 추적할 수 있도록 합니다.
Post JSON formatStandard v1.1 데이터 형식X API v2 형식 (요청 매개변수인 fields 및 expansions 에 의해 결정되며, v1.1 형식과는 하위 호환되지 않음)

Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법에 대해 자세히 알아보려면 데이터 형식 마이그레이션 가이드를 방문하세요.
Results order최신순(내림차순)최신순(내림차순)
Request parameters for paginationN/A, 포스트 ID를 사용해 타임라인을 탐색해야 합니다pagination_token 을 사용해 결과를 앞 또는 뒤로 이동하며 검토할 수 있습니다
Requires the use of credentials from a developer App associated with a Project✔
Provides Post edit history✔✔
기타 마이그레이션 리소스 Post lookup: Standard v1.1 to X API v2 X API 마이그레이션 허브