X API 타임라인 엔드포인트 비교
- 역순(최신순) 홈 타임라인
- 사용자 포스트 타임라인
- 사용자 멘션 타임라인
최신순 홈 타임라인
| 설명 | Standard v1.1 | X API v2 |
| 문서 | API 참조 문서 | API 참조 문서 |
| 지원되는 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 플로 |
| 요청 한도 | 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_timeend_time since_id(미포함)은 업데이트 폴링에 사용됩니다 until_id (미포함) |
| 결과 정제를 위한 선택적 매개변수 | countexclude_repliesinclude_rtstrim_usertweet_modesince_idmax_id | max_resultsexclude(retweets,replies)tweet.fieldsuser.fieldsplace.fieldsmedia.fieldspoll.fieldsexpansionsstart_timeend_timesince_iduntil_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의 인증 정보를 사용해야 합니다 | ✔ |
사용자 게시물 타임라인
| Description | Standard v1.1 | X API v2 |
| Documentation | API 참조 문서 | API 참조 문서 |
| HTTP methods supported | GET | GET |
| Host domain | 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 | N/A | 포스트 텍스트를 기반으로 추론된 주석 데이터(예: ‘Music Genre’와 ‘Folk Music’, 또는 ‘Musician’과 ‘Dolly Parton’)와 함께 포스트 결과를 반환합니다. |
| Supports requesting and receiving specific Post 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 | N/A | 대화를 추적할 수 있도록, 답글 스레드에서 처음 게시된 포스트를 나타내는 값을 가진 conversation_id 필드를 반환합니다. |
| Post JSON format | Standard v1.1 데이터 형식 | X API v2 형식(요청한 fields 및 expansions 파라미터에 의해 결정되며, v1.1 형식과 하위 호환되지 않음) Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법을 자세히 알아보려면 데이터 형식 마이그레이션 가이드를 방문하세요. |
| Results order | 최신순(내림차순) | 최신순(내림차순) |
| Results pagination | N/A, 포스트 ID를 사용한 탐색만 가능 | pagination_token을 사용하여 앞이나 뒤로 이동하면서 결과를 검토할 수 있습니다. |
| Requires the use of credentials from a developer App associated with a Project | ✔ | |
| Provides Post edit history | ✔ | ✔ |
사용자 멘션 타임라인
| Description | Standard v1.1 | X API v2 |
| Documentation | API 참조 문서 | API 참조 문서 |
| HTTP methods supported | GET | GET |
| Host domain | 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 | N/A | ’Music Genre’와 ‘Folk Music’, 또는 ‘Musician’과 ‘Dolly Parton’처럼 포스트 텍스트를 기반으로 추론된 annotation 데이터를 포함하는 포스트 결과를 반환합니다 |
| Supports requesting and receiving specific Post 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 | N/A | 회신 스레드에서 가장 먼저 게시된 포스트를 나타내는 값을 제공하는 conversation_id 필드를 반환하여 대화를 추적할 수 있도록 합니다. |
| Post JSON format | Standard v1.1 데이터 형식 | X API v2 형식 (요청 매개변수인 fields 및 expansions 에 의해 결정되며, v1.1 형식과는 하위 호환되지 않음) Standard v1.1 형식에서 X API v2 형식으로 마이그레이션하는 방법에 대해 자세히 알아보려면 데이터 형식 마이그레이션 가이드를 방문하세요. |
| Results order | 최신순(내림차순) | 최신순(내림차순) |
| Request parameters for pagination | N/A, 포스트 ID를 사용해 타임라인을 탐색해야 합니다 | pagination_token 을 사용해 결과를 앞 또는 뒤로 이동하며 검토할 수 있습니다 |
| Requires the use of credentials from a developer App associated with a Project | ✔ | |
| Provides Post edit history | ✔ | ✔ |