> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 개요
## X API 타임라인 엔드포인트 비교
v2 역순(최신순) 타임라인, 사용자 포스트 타임라인, 사용자 멘션 타임라인 엔드포인트는 각각 [v1.1 statuses/home\_timeine,](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-home_timeline) [v1.1 statuses/user\_timeline](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-user_timeline.html), [v1.1 statuses/mentions\_timeline](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-mentions_timeline.html) 엔드포인트를 대체합니다. 해당 엔드포인트의 구버전을 사용하는 코드, App 또는 도구가 있고 최신 X API v2 엔드포인트로 마이그레이션을 고려하고 있다면, 이 가이드를 활용하면 됩니다. 보다 심층적인 마이그레이션 가이드는 [Standard v1.1 migration to X API v2](/ko/x-api/posts/timelines/migrate/standard-to-twitter-api-v2)를 참고하세요.
이 페이지에는 다음과 같은 세 가지 비교 표가 포함되어 있습니다.
* 역순(최신순) 홈 타임라인
* 사용자 포스트 타임라인
* 사용자 멘션 타임라인
### 최신순 홈 타임라인
아래 표들은 표준 v1.1 홈 타임라인 엔드포인트와 X API v2 홈 타임라인 엔드포인트를 비교합니다.
| | | |
| :------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **설명** | **Standard v1.1** | **X API v2** |
| 문서 | [API 참조 문서](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-home_timeline) | [API 참조 문서](https://developer.x.com/x-api/posts/timelines#user-mention-timeline-3) |
| 지원되는 HTTP 메서드 | `GET` | `GET` |
| 호스트 도메인 | `https://api.x.com` | `https://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 플로](/ko/resources/fundamentals/authenticationoauth-2-0/authorization-code) |
| 요청 한도 | OAuth 1.0a User Context에서 15분당 15건의 요청
요청 한도: 24시간 기준 100,000건. | 15분당 180회 요청 |
| 응답당 기본 포스트 수 | 15 | 100 |
| 응답당 최대 포스트 수 | 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](/ko/x-api/fundamentals/post-annotations) 요청 및 수신 지원 | 해당 없음 | tweet.fields 에 annotations(주석)이 포함되어 있으면 결과에 게시물 텍스트를 기반으로 추론된 주석 데이터가 함께 포함됩니다. 예를 들어 ‘Music Genre’와 ‘Folk Music’, 또는 ‘Musician’과 ‘Dolly Parton’과 같은 값이 포함될 수 있습니다. |
| 특정 게시물 [지표](/ko/x-api/fundamentals/metrics) 요청 및 수신을 지원 | 해당 없음 | 주석이 `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](/ko/x-api/fundamentals/conversation-id)의 요청 및 수신을 지원합니다 | 해당 없음 | 대화 추적을 위해, 답글 스레드에서 가장 먼저 게시된 게시물을 가리키는 값을 담은 conversation\_id 필드를 반환합니다. |
| 게시물의 JSON 형식 | [표준 v1.1 데이터 형식](https://developer.x.com/en/docs/twitter-api/v1/data-dictionary/overview.html) | [X API v2](/ko/x-api/fundamentals/data-dictionary) 형식(fields 및 expansions 요청 매개변수에 의해 결정되며 v1.1 형식과는 하위 호환되지 않습니다)
Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 자세히 알아보려면 [데이터 형식 마이그레이션 가이드](/ko/x-api/migrate/data-format-migration)를 참조하세요. |
| 결과 정렬 기준 | 시간 역순(최신순) | 시간 역순(최신순) |
| 결과 페이지네이션 | 해당 없음. 게시물 id 기준 탐색만 가능 | pagination\_token 을 사용해 결과를 앞이나 뒤로 넘겨 가며 조회할 수 있습니다. |
| [Project](/ko/resources/fundamentals/developer-apps)에 연결된 [개발자 App](/ko/resources/fundamentals/developer-apps)의 인증 정보를 사용해야 합니다 | | ✔ |
### 사용자 게시물 타임라인
다음 표는 표준 v1.1과 X API v2의 사용자 게시물 타임라인 엔드포인트를 비교합니다.
| | | |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Description** | **Standard v1.1** | **X API v2** |
| Documentation | [API 참조 문서](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-user_timeline.html) | [API 참조 문서](/ko/x-api/posts/user-posts-timeline-by-user-id) |
| HTTP methods supported | GET | GET |
| Host domain | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint paths | /1.1/statuses/user\_timeline.json | /2/users/:id/tweets |
| Required parameters | user\_id 또는 screen\_name | 경로 매개변수 :id로 설정된 User ID |
| Authentication | OAuth 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 limits | OAuth 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 refinement | 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 |
| Supports requesting and receiving [annotations](/ko/x-api/fundamentals/post-annotations) | N/A | 포스트 텍스트를 기반으로 추론된 주석 데이터(예: 'Music Genre'와 'Folk Music', 또는 'Musician'과 'Dolly Parton')와 함께 포스트 결과를 반환합니다. |
| Supports requesting and receiving specific Post [metrics](/ko/x-api/fundamentals/metrics) | N/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\_id](/ko/x-api/fundamentals/conversation-id) | N/A | 대화를 추적할 수 있도록, 답글 스레드에서 처음 게시된 포스트를 나타내는 값을 가진 conversation\_id 필드를 반환합니다. |
| Post JSON format | [Standard v1.1 데이터 형식](/ko/x-api/fundamentals/data-dictionary) | [X API v2](/ko/x-api/fundamentals/data-dictionary) 형식(요청한 fields 및 expansions 파라미터에 의해 결정되며, v1.1 형식과 하위 호환되지 않음)
Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 자세히 알아보려면 [데이터 형식 마이그레이션 가이드](/ko/x-api/migrate/data-format-migration)를 방문하세요. |
| Results order | 최신순(내림차순) | 최신순(내림차순) |
| Results pagination | N/A, 포스트 ID를 사용한 탐색만 가능 | pagination\_token을 사용하여 앞이나 뒤로 이동하면서 결과를 검토할 수 있습니다. |
| Requires the use of credentials from a [developer App](/ko/resources/fundamentals/developer-apps) associated with a [Project](/ko/resources/fundamentals/developer-apps) | | ✔ |
| Provides Post edit history | ✔ | ✔ |
### 사용자 멘션 타임라인
다음 표는 Standard v1.1과 X API v2의 사용자 멘션 타임라인 엔드포인트를 비교합니다.
| | | |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Description** | **Standard v1.1** | **X API v2** |
| Documentation | [API 참조 문서](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-mentions_timeline.html) | [API 참조 문서](/ko/x-api/posts/user-mention-timeline-by-user-id) |
| HTTP methods supported | GET | GET |
| Host domain | [https://api.x.com](https://api.x.com) | [https://api.x.com](https://api.x.com) |
| Endpoint paths | /1.1/statuses/mentions\_timeline.json | /2/users/:id/mentions |
| Required parameters | 필수 매개변수 없음 | 경로 매개변수 :id 로 설정된 사용자 ID |
| Authentication | OAuth 1.0a User Context | OAuth 1.0a User Context
OAuth 2.0 App-Only
OAuth 2.0 Authorization Code with PKCE |
| Default request rate limits | OAuth 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 response | 15 | 10 |
| Maximum Posts per response | 200 | 100 |
| Historical Posts available | 가장 최근 800개 포스트 | 가장 최근 800개 포스트 |
| Timeline navigation options | 업데이트 폴링에 사용되는 since\_id (배타적)
max\_id (포함) | start\_time
end\_time
업데이트 폴링에 사용되는 since\_id (배타적)
until\_id (배타적) |
| Optional parameters for results refinement | count
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 [annotations](/ko/x-api/fundamentals/post-annotations) | N/A | 'Music Genre'와 'Folk Music', 또는 'Musician'과 'Dolly Parton'처럼 포스트 텍스트를 기반으로 추론된 annotation 데이터를 포함하는 포스트 결과를 반환합니다 |
| Supports requesting and receiving specific Post [metrics](/ko/x-api/fundamentals/metrics) | N/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\_id](/ko/x-api/fundamentals/conversation-id) | N/A | 회신 스레드에서 가장 먼저 게시된 포스트를 나타내는 값을 제공하는 conversation\_id 필드를 반환하여 대화를 추적할 수 있도록 합니다. |
| Post JSON format | [Standard v1.1 데이터 형식](/ko/x-api/fundamentals/data-dictionary) | [X API v2 형식](/ko/x-api/fundamentals/data-dictionary) (요청 매개변수인 fields 및 expansions 에 의해 결정되며, v1.1 형식과는 하위 호환되지 않음)
Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법에 대해 자세히 알아보려면 [데이터 형식 마이그레이션 가이드](/ko/x-api/migrate/data-format-migration)를 방문하세요. |
| Results order | 최신순(내림차순) | 최신순(내림차순) |
| Request parameters for pagination | N/A, 포스트 ID를 사용해 타임라인을 탐색해야 합니다 | pagination\_token 을 사용해 결과를 앞 또는 뒤로 이동하며 검토할 수 있습니다 |
| Requires the use of credentials from a [developer App](/ko/resources/fundamentals/developer-apps) associated with a [Project](/ko/resources/fundamentals/developer-apps) | | ✔ |
| Provides Post edit history | ✔ | ✔ |
**기타 마이그레이션 리소스**
[Post lookup: Standard v1.1 to X API v2](/ko/x-api/posts/lookup/migrate/standard-to-twitter-api-v2 "Post lookup: Standard v1.1 to X API v2")
[X API 마이그레이션 허브](/ko/x-api/migrate/overview)