メインコンテンツへスキップ
このガイドでは、他のユーザーにリポストされた自分のポストを取得する方法を順を追って説明します。
前提条件始める前に、次のものが必要です。
  • 承認済みの 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"

​
共通パラメーター

Parameter説明デフォルト
max_results1ページあたりの結果数 (1-100)10
start_time最も古いポストのタイムスタンプ (ISO 8601)—
end_time最も新しいポストのタイムスタンプ (ISO 8601)—
pagination_token次ページ用のトークン—
tweet.fieldsポストの追加フィールドid, text

​
次のステップ

リツイートの取得

誰がポストをリツイートしたかを確認する

リツイートの管理

ポストをリツイートしたり、リツイートを取り消したりする

APIリファレンス

エンドポイントの完全なドキュメント