인증
엔드포인트 요구사항
비공개 지표
비공개 지표에 접근하려면 게시물 작성자를 대신해 인증해야 합니다:Fields 및 expansions
기본적으로 응답에는id, text, edit_history_tweet_ids만 포함됩니다. 추가 데이터를 요청하세요:
예시 요청
cURL
주요 필드
Fields 및 expansions 가이드
응답 커스터마이징에 대해 자세히 알아보기
페이지네이션
Timeline은 요청당 최대 100개의 게시물을 반환합니다. 더 큰 결과 집합에는 페이지네이션을 사용하세요.동작 방식
max_results와 함께 초기 요청을 만듭니다meta객체에서next_token을 가져옵니다- 다음 요청에
pagination_token을 포함시킵니다 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 이상으로 사용하세요
프로모션되지 않은 게시물의 promoted 지표
프로모션되지 않은 게시물의 promoted 지표
프로모션되지 않은 게시물의 promoted 지표를 요청하면 빈 응답이 반환됩니다. 알려진 문제입니다.
잘린 Retweet 텍스트
잘린 Retweet 텍스트
140자를 초과하는 리트윗의 경우 text 필드가 잘립니다. 전체 텍스트를 얻으려면
referenced_tweets.id expansion을 사용하세요.다음 단계
Home timeline 퀵스타트
사용자의 home 피드 가져오기
Mentions 퀵스타트
사용자에 대한 멘션 가져오기
API 레퍼런스
전체 엔드포인트 문서
페이지네이션
큰 결과 집합 처리