Skip to main content
X API v2 はデフォルトで最小限のデータを返します。各オブジェクトタイプの追加データをリクエストするには fields パラメータ を使用します。

Fields の仕組み

デフォルトでは、post lookup は idtextedit_history_tweet_ids のみを返します。より多くのデータを取得するには、リクエストに fields パラメータを追加します。

利用可能な fields パラメータ

各オブジェクトタイプには専用の fields パラメータがあります。

例: Post fields

tweet.fields を使用して特定の post フィールドをリクエストします。
レスポンス:
Example response

例: User fields

user.fields を使用して特定のユーザーフィールドをリクエストします。
レスポンス:
Example response

関連オブジェクトの fields

関連オブジェクトのフィールド(post の作者など)を取得するには、次の 2 つが必要です。
  1. 関連オブジェクトを含めるための expansion
  2. そのオブジェクトタイプの fields パラメータ
レスポンス:
Example response
expansions の詳細を見る →

一般的な fields の組み合わせ


重要な注意事項

サブフィールドはリクエストできません。 public_metrics をリクエストすると、すべての metrics(likes、reposts、replies、quotes、bookmarks、impressions)が返されます。public_metrics.like_count のみをリクエストすることはできません。
  • レスポンスのフィールド順序はリクエスト順序と異なる場合があります
  • レスポンスに欠落しているフィールドは、値が null か空であることを意味します
  • 一部のフィールドは特定の認証が必要です(例: private metrics は user context が必要)
  • 利用可能なフィールドについては、各エンドポイントの API リファレンスを確認してください

次のステップ

Expansions

レスポンスに関連オブジェクトを含める。

Data Dictionary

すべてのオブジェクトの完全なフィールドリファレンス。