メインコンテンツへスキップ
X API は、投稿やメディアに対するエンゲージメントメトリクスを提供します。任意の認証方式で公開メトリクスにアクセスでき、自身のコンテンツについてはユーザー認証を用いて非公開メトリクスにアクセスできます。

​
指標の種類

TypeAuthenticationDescription
Publicベアラートークンすべてのユーザーに表示される指標 (いいね、リポスト、返信など)
Non-publicユーザーコンテキスト非公開指標 (インプレッション、クリック)
Organicユーザーコンテキストプロモーションされていない表示から得られる指標
Promotedユーザーコンテキスト広告の表示から得られる指標
30日間の制限：非公開指標、オーガニック指標、およびプロモーション指標は、過去30日以内に作成されたポストに対してのみ取得できます。

​
利用可能な指標

​
ポストのメトリクス

メトリクス種別フィールドパス
Reposts公開public_metrics.retweet_count
Quotes公開public_metrics.quote_count
Likes公開public_metrics.like_count
Replies公開public_metrics.reply_count
Impressions非公開non_public_metrics.impression_count
URL クリック数非公開non_public_metrics.url_link_clicks
プロフィールクリック数非公開non_public_metrics.user_profile_clicks

​
メディア指標 (動画)

指標種別フィールドパス
再生回数公開public_metrics.view_count
再生進捗 0%非公開non_public_metrics.playback_0_count
再生進捗 25%非公開non_public_metrics.playback_25_count
再生進捗 50%非公開non_public_metrics.playback_50_count
再生進捗 75%非公開non_public_metrics.playback_75_count
再生進捗 100%非公開non_public_metrics.playback_100_count

​
メトリクスの取得

​
公開メトリクス (認証方法を問わず)

curl "https://api.x.com/2/tweets/1234567890?tweet.fields=public_metrics" \
  -H "Authorization: Bearer $TOKEN"
レスポンス： 
{
  "data": {
    "id": "1234567890",
    "text": "Hello world!",
    "public_metrics": {
      "retweet_count": 50,
      "reply_count": 12,
      "like_count": 234,
      "quote_count": 5
    }
  }
}

​
プライベートメトリクス (ユーザーコンテキスト)

あなたが所有する投稿には、ユーザーコンテキストの OAuth 1.0a または OAuth 2.0 が必要です。 
curl "https://api.x.com/2/tweets/1234567890?tweet.fields=non_public_metrics,organic_metrics" \
  -H "Authorization: OAuth oauth_consumer_key=...,oauth_token=..."
レスポンス： 
{
  "data": {
    "id": "1234567890",
    "text": "Hello world!",
    "non_public_metrics": {
      "impression_count": 5432,
      "url_link_clicks": 89,
      "user_profile_clicks": 156
    },
    "organic_metrics": {
      "impression_count": 5432,
      "like_count": 234,
      "reply_count": 12,
      "retweet_count": 50,
      "url_link_clicks": 89,
      "user_profile_clicks": 156
    }
  }
}

​
動画メトリクス

動画再生メトリクスには、media エクスパンションを使用します。 
curl "https://api.x.com/2/tweets/1234567890?\
tweet.fields=attachments&\
expansions=attachments.media_keys&\
media.fields=public_metrics,non_public_metrics" \
  -H "Authorization: OAuth ..."
レスポンス: 
{
  "data": {
    "id": "1234567890",
    "text": "Check out this video!",
    "attachments": {
      "media_keys": ["13_9876543210"]
    }
  },
  "includes": {
    "media": [{
      "media_key": "13_9876543210",
      "type": "video",
      "public_metrics": {
        "view_count": 12543
      },
      "non_public_metrics": {
        "playback_0_count": 12543,
        "playback_25_count": 9876,
        "playback_50_count": 7654,
        "playback_75_count": 5432,
        "playback_100_count": 3210
      }
    }]
  }
}

​
オーガニック指標とプロモーション指標

ポストが広告としてプロモーションされた場合、指標はオーガニック表示とプロモーション表示に分かれて集計されます。
コンテキスト説明
Organic通常のタイムライン表示からの指標
Promoted有料広告インプレッションからの指標
Public合算値 (オーガニック + プロモーション)
内訳を確認するには、両方の指標をリクエストしてください。 
tweet.fields=public_metrics,organic_metrics,promoted_metrics

​
指標の定義

ポストがユーザーの画面に表示された回数の合計。ユニークユーザー数ではありません。同じユーザーが2回閲覧した場合は、2インプレッションとしてカウントされます。
リポスト (リツイート) の数。引用ポストは含まれません。
引用ポスト (コメント付きリポスト) の数。これらは常にオーガニック配信です。
その動画を含むすべての投稿を合計した値。動画が複数のポストでリポストされている場合でも、視聴回数は1つの合算値として扱われます。
動画をそれぞれの再生パーセンテージまで視聴したユニークユーザー数。離脱率を把握するのに有用です。

​
要件の概要

Metric field必要な認証
public_metricsベアラートークン (いずれか)
non_public_metricsユーザーコンテキスト (自分の投稿のみ)
organic_metricsユーザーコンテキスト (自分の投稿のみ)
promoted_metricsユーザーコンテキスト (自分のプロモーション投稿のみ)

​
次のステップ

データディクショナリ

フィールドの完全なリファレンスです。

認証

ユーザーコンテキストでの認証を設定します。