메인 콘텐츠로 건너뛰기이 세 가지 타임라인 엔드포인트는 수정된 게시물을 지원합니다. 이러한 엔드포인트는 항상 최신 수정본과 수정 이력을 함께 반환합니다. 게시물이 30분 편집 가능 시간 이후에 수집되면 해당 게시물은 최종 버전을 나타냅니다. 편집 메타데이터에는 해당 이력의 모든 게시물에 대한 ID 배열이 포함됩니다. 편집 이력이 없는 게시물의 경우 이 배열에는 단일 ID만 포함됩니다. 편집된 게시물의 경우 이 배열에는 여러 ID가 포함되며, 편집 순서를 반영해 오름차순으로 정렬되며 배열의 마지막에 최신 버전이 위치합니다. 게시물 편집 방식에 대한 자세한 내용은 Edit Posts fundamentals 페이지를 참고하세요.
이 엔드포인트를 사용하면 인증된 사용자와 그 사용자가 팔로우하는 계정이 게시한 최신 게시물, 리포스트, 답글을 조회할 수 있습니다.
사용자를 대신해 요청하므로, 이 엔드포인트는 OAuth 2.0 Authorization Code Flow with PKCE 또는 OAuth 1.0a 사용자 컨텍스트로 인증해야 합니다. 이 엔드포인트에는 사용자별로 15분당 180회의 요청 한도가 적용됩니다. 또한 타임라인에서 지난 7일간 생성된 모든 게시물과, 생성 날짜와 관계없이 가장 최근 800개까지 반환할 수 있습니다.
사용자 게시물 타임라인 엔드포인트는 특정 X 계정이 게시한 게시물에 대한 액세스를 제공합니다. 사용자의 게시물을 가져오면 UI에 타임라인을 표시하거나, 사용자의 게시물을 분석해 콘텐츠를 더 잘 이해하거나, 게시물과의 상호작용 워크플로를 프로그래밍 방식으로 구축하는 등의 경험을 만들 수 있습니다. 이 엔드포인트는 사용자의 프로필 타임라인에서 볼 수 있는 것과 유사하게 단일 X 계정의 최신 게시물, 리트윗, 답글, 인용 트윗에 대한 액세스를 제공합니다.
다음은 @XDevelopers의 사용자 타임라인입니다:
사용자 게시물 타임라인 엔드포인트는 대상 사용자(사용자 ID 기준)를 지정하는 단일 경로 매개변수를 받는 REST 엔드포인트입니다. 이 엔드포인트는 해당 사용자가 게시한 최신 3,200개의 게시물, 리트윗, 답글, 인용 트윗을 반환할 수 있습니다.
게시물은 최신순(역순 시간)으로 전달됩니다. 결과는 페이지당 최대 100개의 게시물로 페이지네이션됩니다. 대량의 게시물을 탐색할 수 있도록 페이지네이션 토큰이 제공됩니다. 해당 페이지에 포함된 가장 최신 및 가장 오래된 게시물의 게시물 ID도 메타데이터로 제공되며, 최근 게시물을 폴링할 때 활용할 수 있습니다. 사용자 게시물 타임라인은 또한 특정 시간 범위 내에서 생성된 게시물을 받을 수 있도록 start_time 및 end_time 매개변수 지정을 지원합니다.
사용자 게시물 타임라인 엔드포인트는 fields 및 expansions 매개변수를 지원하며, 새 JSON 데이터 형식을 반환합니다.
이 엔드포인트로 요청을 성공적으로 수행하려면 OAuth 1.0a 사용자 컨텍스트, OAuth 2.0 Authorization Code with PKCE, 또는 OAuth 2.0 App-Only 인증 방식을 사용해 요청을 인가해야 합니다. 비공개 메트릭, 프로모션 메트릭 또는 보호된 사용자의 타임라인을 요청하는 경우에는 반드시 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE를 사용해야 합니다.
사용자 게시물 타임라인 엔드포인트는 다음 두 가지 일반적인 사용 패턴을 지원하도록 설계되었습니다:
-
“사용자의 과거 게시물 가져오기”: 특정 최근 기간 동안 관심 있는 사용자가 작성한 게시물을 시간순으로 받기 위해 사용자 게시물 타임라인에 요청합니다. 기간은 start_time 및 end_time을 설정하고 전체 결과를 페이지네이션하여 지정할 수 있습니다. 경우에 따라 사용자가 계정에서 최대 3,200개까지만 게시물을 작성한 상태라면 사용자의 전체 게시물 이력을 가져올 수도 있습니다. 포함되는 게시물은 공개 범위와 요청에 사용된 인증에 따라 달라집니다.
-
“새 게시물 폴링”: 특정 사용자가 작성한 새 게시물을 가져오기 위해 사용자 게시물 타임라인에 지속적으로 요청합니다. 마지막으로 받은 게시물 ID를 이후 요청의 매개변수로 설정해 마지막 게시물 이후의 새 게시물만 받을 수 있습니다.
사용자 멘션 타임라인 엔드포인트를 사용하면 특정 X 사용자를 언급한 게시물을 조회할 수 있습니다. 예를 들어, 어떤 X 계정이 게시물에서 @XDevelopers를 언급한 경우가 해당합니다. 여기에는 요청한 사용자의 게시물에 달린 답글도 포함됩니다. 사용자의 멘션을 조회하면 누가 해당 사용자의 게시물에 답글을 달거나 언급하는지 빠르게 파악하고, 그들의 게시물과 프로그램적으로 상호작용하는 워크플로를 구축할 수 있습니다. 이 엔드포인트를 사용하면 단일 사용자의 가장 최근 멘션과 답글을 요청할 수 있으며, 이는 X의 사용자가 보는 멘션 알림과 유사합니다.
사용자 멘션 타임라인은 원하는 사용자(사용자 ID 기준)를 지정하기 위해 단일 경로 매개변수를 받는 REST 엔드포인트입니다. 이 엔드포인트는 해당 사용자의 가장 최근 멘션을 최대 800개까지 반환할 수 있습니다.
게시물은 최신순(역순 시간순)으로 제공되며, 가장 최근 항목부터 시작합니다. 결과는 페이지당 최대 100개의 게시물로 페이지네이션됩니다. 대용량 결과 탐색을 위해 페이지네이션 토큰이 제공됩니다. 해당 페이지에 포함된 가장 최신 및 가장 오래된 게시물의 게시물 ID도 메타데이터로 제공되며, 이를 사용해 최신 게시물을 폴링하거나 v1.1 mentions_timeline 엔드포인트처럼 타임라인을 탐색할 수 있습니다. 또한 start_time 및 end_time 매개변수를 지정하여 특정 시간 범위 내에 생성된 게시물을 받을 수 있습니다.
이 엔드포인트로 요청을 성공적으로 수행하려면 OAuth 1.0a 사용자 컨텍스트, OAuth 2.0 Authorization Code with PKCE, 또는 OAuth 2.0 App-Only 인증 방법으로 요청을 승인해야 합니다. 비공개 지표, 프로모션 지표 또는 보호된 사용자의 타임라인을 요청하는 경우에는 OAuth 1.0a 사용자 컨텍스트 또는 OAuth 2.0 Authorization Code with PKCE를 사용해야 합니다.
사용자 멘션 타임라인 엔드포인트는 필드 및 expansions 매개변수를 지원하며, 새 JSON 데이터 형식을 반환합니다.
계정 설정이 엔드포인트에 접근하려면 다음이 필요합니다:시작하기 가이드에서 X API v2 엔드포인트에 대한 액세스 방법을 자세히 알아보세요. 
