Skip to main content
이 가이드는 Timelines 엔드포인트를 애플리케이션에 통합할 때 알아야 할 핵심 개념을 다룹니다.

인증

엔드포인트 요구사항

비공개 지표

비공개 지표에 접근하려면 게시물 작성자를 대신해 인증해야 합니다:
다음 필드는 User Context 인증이 필요합니다:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

Fields 및 expansions

기본적으로 응답에는 id, text, edit_history_tweet_ids만 포함됩니다. 추가 데이터를 요청하세요:

예시 요청

cURL

주요 필드

Fields 및 expansions 가이드

응답 커스터마이징에 대해 자세히 알아보기

페이지네이션

Timeline은 요청당 최대 100개의 게시물을 반환합니다. 더 큰 결과 집합에는 페이지네이션을 사용하세요.

동작 방식

  1. max_results와 함께 초기 요청을 만듭니다
  2. meta 객체에서 next_token을 가져옵니다
  3. 다음 요청에 pagination_token을 포함시킵니다
  4. next_token이 반환되지 않을 때까지 반복합니다

예시

cURL

페이지네이션 가이드

페이지네이션에 대해 자세히 알아보기

결과 필터링

시간 기반 필터링

Exclude 파라미터

결과에서 특정 게시물 유형 제거:
cURL

볼륨 제한

각 timeline에는 최대 조회 한도가 있습니다:
이러한 한도를 초과하는 게시물을 요청하면 데이터 없이 성공 응답이 반환됩니다.

게시물 편집

게시물은 30분 이내에 최대 5회까지 편집할 수 있습니다. Timeline 엔드포인트는 항상 가장 최근 버전을 반환합니다.

고려 사항

  • 30분보다 오래된 게시물은 최종 버전을 나타냅니다
  • 거의 실시간 사용 사례에서는 잠재적 편집을 고려해야 합니다
  • 필요한 경우 Post lookup으로 최종 상태를 확인하세요

게시물 편집 기본

게시물 편집에 대해 자세히 알아보기

게시물 지표

공개 지표

App-Only 또는 User Context 인증으로 모든 게시물에 대해 사용할 수 있습니다:

비공개 지표

게시물 작성자의 User Context 인증이 필요합니다:
  • 최근 30일간의 게시물에 대해서만 사용 가능
  • 인증된 사용자가 작성한 게시물에 대해서만 반환됨
  • 다른 사용자의 게시물에 대해서는 오류 반환

특수 사례

30일보다 오래된 게시물의 비공개 지표를 요청하면 result_count: 0과 함께 next_token을 받을 수 있습니다. 이를 피하려면:
  • 요청을 최근 30일 이내로 유지하세요
  • max_results를 최소 10 이상으로 사용하세요
140자를 초과하는 리트윗의 경우 text 필드가 잘립니다. 전체 텍스트를 얻으려면 referenced_tweets.id expansion을 사용하세요.

다음 단계

Home timeline 퀵스타트

사용자의 home 피드 가져오기

Mentions 퀵스타트

사용자에 대한 멘션 가져오기

API 레퍼런스

전체 엔드포인트 문서

페이지네이션

큰 결과 집합 처리