타임라인

사용자 타임라인과 홈 피드에서 포스트를 조회합니다

Timelines 엔드포인트를 사용하면 사용자 타임라인, 멘션 피드, 홈 피드에서 포스트를 조회할 수 있습니다. 사용자가 작성한 포스트를 가져오고, 해당 사용자를 멘션한 포스트를 확인하거나, 해당 사용자의 개인화된 홈 타임라인을 볼 수 있습니다.

​

개요

사용자 포스트

사용자가 작성한 포스트 조회

사용자 멘션

사용자가 언급된 포스트 조회

홈 타임라인

개인화된 홈 피드 조회

최신순

시간 역순으로 정렬된 포스트

---

​

엔드포인트

Method	Endpoint	Description
GET	/2/users/:id/tweets	사용자의 포스트 조회
GET	/2/users/:id/mentions	사용자가 언급된 포스트 조회
GET	/2/users/:id/timelines/reverse_chronological	홈 타임라인 조회

---

​

사용자 포스트 타임라인

특정 사용자가 작성한 가장 최근 포스트를 가져옵니다.

​

기능

• 최신 포스트 최대 3,200개
• 답글과 리트윗 제외 필터링
• 페이지네이션 지원
• 시간 기반 필터링을 통한 과거 데이터 조회

API 참조 문서

엔드포인트 전체 문서

---

​

사용자 멘션 타임라인

특정 사용자가 멘션된 포스트를 가져옵니다.

​

기능

• 최신 멘션 최대 800개
• 답글과 인용 포스트 포함
• 페이지네이션 지원

빠른 시작

사용자 멘션 가져오기

API 참조 문서

전체 엔드포인트 문서

---

​

최신순 홈 타임라인

인증된 사용자의 홈 타임라인을 최신순으로 가져옵니다.

​

기능

• 팔로우하는 계정의 포스트
• 최신 포스트 최대 3,200개(또는 최근 7일치)
• 알고리즘 기반 순위 적용 안 함
• 사용자 인증 필요

이 엔드포인트는 OAuth 1.0a User Context 또는 OAuth 2.0 Authorization Code with PKCE가 필요합니다.

빠른 시작

사용자의 홈 타임라인 가져오기

API 참조 문서

전체 엔드포인트 문서

---

​

필터 옵션

​

exclude 매개변수

특정 게시물 type을 제외합니다:

값	효과
retweets	리포스트 제외
replies	답글 제외

curl "https://api.x.com/2/users/123/tweets?exclude=retweets,replies" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

시간 기반 필터링

Parameter	Description
start_time	가장 오래된 게시물의 타임스탬프(ISO 8601)
end_time	가장 최신 게시물의 타임스탬프(ISO 8601)
since_id	이 ID 이후의 포스트를 반환합니다
until_id	이 ID 이전의 포스트를 반환합니다

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 Project 및 App
• App의 키와 토큰

홈 타임라인 빠른 시작

사용자의 홈 피드 가져오기

멘션 빠른 시작

사용자의 멘션 가져오기

통합 가이드

핵심 개념 및 모범 사례

샘플 코드

실행 가능한 코드 예제