메인 콘텐츠로 건너뛰기
이 가이드는 다른 사용자가 리트윗한 내 포스트를 조회하는 방법을 단계별로 설명합니다.
사전 준비 사항시작하기 전에 다음이 필요합니다.
  • 승인된 App이 연결된 개발자 계정
  • 사용자 액세스 토큰(OAuth 1.0a 또는 OAuth 2.0 PKCE)

왜 Retweets of Me를 사용해야 할까요?

Retweets of Me 엔드포인트는 다음과 같은 작업에 도움이 됩니다:
  • 참여 추적 — 어떤 포스트가 공유되고 있는지 확인할 수 있습니다
  • 반응 파악 — 어떤 콘텐츠가 오디언스에게 공감되는지 파악할 수 있습니다
  • 전략 수립 — 공유 패턴을 기반으로 콘텐츠 전략을 조정할 수 있습니다

리트윗된 내 포스트 가져오기

cURL
curl "https://api.x.com/2/users/reposts_of_me?\
tweet.fields=created_at,public_metrics&\
max_results=10" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

응답

{
  "data": [
    {
      "id": "1848781937210802364",
      "text": "ever wanted to discover trends.. before they're trends?...",
      "created_at": "2024-01-15T10:30:00.000Z",
      "public_metrics": {
        "retweet_count": 42,
        "reply_count": 5,
        "like_count": 156,
        "quote_count": 8
      },
      "edit_history_tweet_ids": ["1848781937210802364"]
    },
    {
      "id": "1847990559081648620",
      "text": "posting is just journaling with an audience",
      "created_at": "2024-01-14T15:20:00.000Z",
      "public_metrics": {
        "retweet_count": 28,
        "reply_count": 12,
        "like_count": 89,
        "quote_count": 3
      },
      "edit_history_tweet_ids": ["1847990559081648620"]
    }
  ],
  "meta": {
    "result_count": 2,
    "next_token": "7140dibdnow9c7btw481s8m561gat797rboud5r80xvzm"
  }
}

시간 범위로 필터링

특정 기간 동안 리트윗된 포스트를 가져오려면:
cURL
curl "https://api.x.com/2/users/reposts_of_me?\
start_time=2024-01-01T00%3A00%3A00Z&\
end_time=2024-01-31T23%3A59%3A59Z&\
tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

공통 매개변수

매개변수설명기본값
max_results페이지당 결과 수 (1-100)10
start_time가장 오래된 게시물의 타임스탬프 (ISO 8601)
end_time가장 최근 게시물의 타임스탬프 (ISO 8601)
pagination_token다음 페이지용 토큰
tweet.fields추가 게시물 필드id, text

다음 단계

리트윗 조회

게시물을 리트윗한 사용자를 확인하세요

리트윗 관리

리트윗하고 리트윗을 취소하세요

API 참조 문서

전체 엔드포인트 문서를 확인하세요