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

개요

사용자 포스트

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

사용자 멘션

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

홈 타임라인

개인화된 홈 피드 조회

최신순

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

엔드포인트

MethodEndpointDescription
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"

시간 기반 필터링

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

시작하기

사전 준비 사항

홈 타임라인 빠른 시작

사용자의 홈 피드 가져오기

멘션 빠른 시작

사용자의 멘션 가져오기

통합 가이드

핵심 개념 및 모범 사례

샘플 코드

실행 가능한 코드 예제