Skip to main content

Documentation Index

Fetch the complete documentation index at: https://x-preview-mintlify-aed10b63.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

更新情報の通知を受け取るには、@API「通知をオンにする」 を有効にしてください。
2026 年 5 月 4 日
X API v2

検索エンドポイントを新しい検索インデックスに移行

本日、X API v2 の検索エンドポイント (/2/tweets/search/recent/2/tweets/search/all/2/tweets/counts/recent/2/tweets/counts/all) を、新しい X コアプラットフォームの検索インデックスへ移行しました。これにより、パフォーマンスが大幅に向上し、503 エラーが劇的に減少し、3 つの新しい精度オペレーター min\_likes:min\_replies:min\_reposts: が利用可能になります。注: キーワードベースの検索結果にはリツイートが含まれなくなりました (Filtered Stream に変更はありません)。詳細はこちらをご覧ください。
2026 年 4 月 16 日
X API

X API 価格更新: Owned Reads が 1 件 $0.001 に

2026 年 4 月 20 日より、自身のデータにアクセスする対象エンドポイント (GET /2/users/{id}/bookmarks/blocking/muting/pinned_lists/tweets/mentions/liked_tweets/followers/following/owned_lists/followed_lists/list_memberships) について、新しい「Owned Reads」価格 **1 リソースあたり 0.001(1,000件で0.001** (1,000 件で 1) を導入しました。書き込みも更新しており、POST /2/tweets は 1 件あたり 0.015となり、URLを含む投稿は1件あたり0.015 となり、URL を含む投稿は 1 件あたり 0.20 (召喚された返信は $0.01 のまま) です。API 経由のフォロー、いいね、引用投稿は、すべてのセルフサーブ階層から削除されました。詳細はこちらをご覧ください。
2026 年 3 月 20 日
X API v2

Account Activity Replay エンドポイントの廃止

本日、POST /2/account_activity/replay/webhooks/{webhook_id}/subscriptions/all の廃止を発表しました。2026 年 3 月 25 日午後 12:00 ET より有効となります。代わりに、新しい統合エンドポイントである POST /2/webhooks/replay をご利用ください。同等の機能を提供します。詳細はこちらをご覧ください。
2026 年 3 月 18 日
X API v2

X Activity API サブスクリプションの Direction フィルター

本日、X Activity API のサブスクリプションに任意の direction フィルターを追加しました。サブスクライバーは、DM やチャットイベントを sentreceived、またはその両方にスコープできるようになり、送信または受信のみが必要な場合のノイズを削減できます。
2026 年 3 月 13 日
X API v2

X Activity API のイベントタイプ形式の更新

本日、X Activity API のイベントタイプ命名の変更を発表しました。2026 年 3 月 18 日から有効です。PascalCase のイベントタイプ (例: ProfileBioUpdate) は廃止され、ドット区切りの小文字形式 (例: profile.update.bio) に置き換えられます。古い値に依存するフィルタリング、switch 文、デシリアライズロジックを更新してください。詳細はこちらをご覧ください。
2026 年 3 月 11 日
X API v2

X Activity API のレガシー DM イベント

本日、レガシー DM イベント (dm.receiveddm.sentdm.readdm.indicate_typing) を X Activity API に追加しました。これにより、Account Activity API からの DM イベント配信が、より低レイテンシの XAA パイプラインへ移行します。
2026 年 2 月 23 日
X API v2

LLM によって生成されたスパムへの対応

本日、X 上の自動化された低品質な返信を削減するための変更を行いました。POST /2/tweets 経由のプログラム的な返信は、元の投稿の作成者が返信側のアカウントを「召喚」した場合 (そのアカウントを @メンションするか、その投稿の 1 つを引用した場合) にのみ許可されます。プログラムによるユーザーへの @メンションや引用にも追加の制限が適用されます。これらの変更はセルフサーブ階層のみが対象で、Enterprise アクセスには影響しません。詳細はこちらをご覧ください。
2026 年 2 月 6 日
X API

X API 従量課金制プランの提供開始

本日、X API 従量課金制 (Pay-Per-Use) プランを正式に提供開始しました。インディー開発者、スタートアップ、ホビイスト向けに設計された、柔軟なクレジットベースのモデルです。主なハイライト:
  • console.x.com の新しい Developer Console
  • ファーストパーティの Python および TypeScript SDK を含む XDK (X Developer Kit)
  • テスト用のインタラクティブな Playground
  • AI モデル向けの MCP サーバー
  • X API に費やした 1 ドルごとに、最大 20% を xAI/Grok API クレジットとして還元
Public Utility App は引き続き無料の拡張アクセスを受けられます。最近アクティブだった Legacy Free 階層のユーザーには、$10 のワンタイムバウチャーが付与されます。Basic および Pro プランは引き続き提供され、既存のサブスクライバーは従量課金制にオプトインできます。詳細はこちらをご覧ください。
2026 年 1 月 28 日
X API v2

X Activity API での Spaces イベント

本日、Spaces のライフサイクルイベント (spaces.startspaces.end) を X Activity API に追加しました。ユーザー ID 別にサブスクライブすると、Space の開始または終了をリアルタイムで通知します。
2026 年 1 月 19 日
X API v2

カウントベースのオペレーターの廃止

本日、/2/tweets/search/recent および /2/tweets/search/allmin\_likesmin\_repliesmin\_reposts オペレーターを廃止しました。この変更は Filtered Stream の同等のオペレーターには影響しません。将来的に最適な形でこれらを再有効化する方法を検討しています。詳細はこちらをご覧ください。
2026 年 1 月 15 日
X API v2

Account Activity API v2 に OAuth 2.0 サポートを追加

本日、Account Activity API v2 に OAuth 2.0 の完全なサポートを追加しました。開発者は、オール・オア・ナッシングの OAuth 1.0a 権限モデルではなく、きめ細やかなスコープ (例: follow.read) を持つ OAuth 2.0 を使用してサブスクリプションを作成できるようになりました。既存の OAuth 1.0a ベースの統合は引き続き中断なく動作します。OAuth 1.0a の権限が存在する場合、OAuth 2.0 のスコープを完全に上書きします。詳細はこちらをご覧ください。
2025 年 12 月 23 日
X API

X API Playground の提供開始

本日、X API Playground を発表しました。X API v2 のエンドポイントをエミュレートするセルフホスト型のローカルサーバーです。実際の API 呼び出しを行うことなく、またレート制限に到達することなく統合を開発・テストできます。現実的なモックデータ、状態の永続化、OpenAPI 検証、レート制限のシミュレーション、Web UI を備えています。go install github.com/xdevplatform/playground/cmd/playground@latest でインストールできます。詳細はこちらをご覧ください。
2025 年 11 月 19 日
X API v2

News エンドポイントの提供開始

本日、X API v2 で新しい News エンドポイント を提供開始しました:
  • GET /2/news/search — 検索クエリに一致するトレンドニュース記事を返します
  • GET /2/news/{id} — ID で特定のニュース記事をルックアップします
どちらのエンドポイントも、namesummarycontextscluster\_posts\_resultslast\_updated\_at\_ms などのフィールドを選択するための news.fields をサポートしています。詳細はこちらをご覧ください。
2025 年 11 月 3 日
X API v2

Python および TypeScript XDK の提供開始

本日、X API v2 向けの公式ファーストパーティ Python および TypeScript XDK (X Developer Kits) を提供開始しました。XDK は、認証 (Bearer Token、OAuth 2.0 PKCE、OAuth 1.0a)、自動ページネーション、再接続処理を備えたリアルタイムストリーミング、すべての v2 エンドポイントの包括的なカバレッジを提供します。pip install xdk または npm install @xdevplatform/xdk でインストールできます。詳細はこちらをご覧ください。
2025 年 10 月 27 日
X API v2

X Activity API サブスクリプションのキーワードフィルタリング

本日、X Activity API のサブスクリプションにキーワードフィルタリングを追加しました。ユーザー ID によるフィルタリングに加えて、サブスクライバーはキーワードによってイベント配信をさらに絞り込めるようになりました。これは、追加のフィルタリングが正当化されるイベント量の多い News イベントなどに有用です。
2025 年 10 月 24 日
X API v2

X Activity API での認証バッジ、Affiliate バッジ、ハンドル更新イベント

本日、X Activity API を拡張し、プロフィール関連の追加イベントタイプを配信できるようになりました:
  • profile.update.verified — ユーザーの認証ステータスが変更されたとき
  • profile.update.affiliate — ユーザーの affiliate バッジが変更されたとき
  • profile.update.screenname — ユーザーが @ハンドルを変更したとき
2025 年 10 月 20 日
X API

X API 従量課金制 (Pay-Per-Use) のパイロット

本日、新しいクレジットベースの従量制価格モデルに関する限定クローズドパイロットを発表しました。開発者はクレジットを前払いで購入し、リクエストごとに課金されます。固定のサブスクリプション料金や月次オブジェクト上限はありません。パイロットの初期レート: Post Read 0.005UserRead0.005、User Read 0.01、DM Event Read 0.01ContentCreate0.01、Content Create 0.01、DM Interaction 0.01UserInteraction0.01、User Interaction 0.015。詳細はこちらをご覧ください。
2025 年 10 月 18 日
X API v2

X Activity API オープンベータの開始

本日、X Activity API のオープンベータを開始しました。これは、X 上のリアルタイムなアクティビティイベントにサブセコンド遅延でサブスクライブできる新しいエンドポイント群です。プロフィールイベントタイプ (ProfileBioUpdateProfilePictureUpdateProfileBannerUpdateProfileGeoUpdateProfileUrlUpdate) にサブスクライブし、ユーザー ID でフィルタリングして、一致するイベントを永続的な HTTP ストリーム (GET /2/activity/stream) または Webhook 経由で受信できます。サブスクリプションは POST /2/activity/subscriptions で管理します。詳細はこちらをご覧ください。
2025 年 10 月 3 日
X API v2

X API 経由での投稿編集

本日、X API 経由で最近の投稿をプログラム的に編集する機能を提供開始しました。既存の POST /2/posts エンドポイントを、previous_post_id を含む新しい edit_options オブジェクトとともに使用します。要件: 認証ユーザーが X Premium に加入していること、対象の投稿が自身のものであること、過去 1 時間以内に作成されていること。更新された Create or Edit Post ドキュメントを参照してください。詳細はこちらをご覧ください。
2025 年 9 月 19 日
X API v2

アクティブなストリーミング接続を管理する Connections API

本日、アクティブなストリーミング接続をプログラム的に管理するための Connections API を提供開始しました:
  • GET /2/connections — アクティブおよび過去のストリーミング接続を一覧表示します
  • DELETE /2/connections/all — アプリのすべてのアクティブなストリーミング接続を終了します
  • DELETE /2/connections/{endpoint_id} — 特定のストリーミングエンドポイントの接続を終了します
  • DELETE /2/connections — UUID で特定の接続を終了します
これにより、開発者は「TooManyConnections」エラーを解決し、タイムアウトを待たずに古い接続をクリーンアップできます。
2025 年 9 月 17 日
X API v2

Community Notes: Evaluate Note エンドポイント

本日、Community Notes APIPOST /2/evaluate_note エンドポイントを追加しました。AI Note Writer は、提出前にドラフトされたノートを評価し、その潜在的な有用性、主張/意見のアラインメント、その他のモデルフィードバックに関するシグナルを受け取ることができます。
2025 年 9 月 9 日
X API v2

Filtered Stream Webhooks API の提供開始

本日、Filtered Stream Webhooks API を提供開始しました。永続的な接続を必要とせず、一致する公開投稿を登録済みの Webhook へ非同期に配信します。ルールは既存の /2/tweets/search/stream/rules エンドポイントを使用して管理し、一致する投稿 (編集履歴を含む) は JSON として Webhook に配信されます。Enterprise の開発者が利用可能で、プロジェクトあたり 25,000 以上のルール、ルール 1 件あたり最大 2,048 文字をサポートします。詳細はこちらをご覧ください。
2025 年 8 月 22 日
X API v2

Free 階層から Like および Follow エンドポイントを削除

不正利用、プラットフォーム操作、不正なエンゲージメントに対抗するため、X API Free 階層から POST /2/users/:id/likes および POST /2/users/:id/following を即時削除しました。有料階層 (Basic、Pro、Enterprise) は影響を受けません。詳細はこちらをご覧ください。
2025 年 8 月 6 日
X API v2

PowerStream Rules Lookup エンドポイント

本日、GET /2/powerstream/rules エンドポイントを追加しました。PowerStream の顧客は、PowerStream インスタンスに対して構成されたルールをプログラム的に取得できるようになりました。
2025 年 7 月 28 日
X API v2

share_with_followers によるコミュニティ投稿のブロードキャスト

本日、POST /2/tweets に新しいオプションのブール型パラメーター share_with_followers を追加しました。community_idshare_with_followers: true で投稿すると、コミュニティ投稿は認証ユーザーのフォロワーのタイムラインにもブロードキャストされます。これは x.com の「フォロワーにも共有する」チェックボックスに対応します。
2025 年 7 月 8 日
X API v2

Community Notes API の提供開始

本日、Community Notes API を提供開始しました。AI Note Writer が Community Notes にプログラム的に参加するための新しいエンドポイント群です:
  • GET /2/notes/search/posts_eligible_for_notes — Community Note の対象となる投稿を検索します
  • GET /2/notes/search/notes_written — 認証された AI Note Writer によって過去に書かれたノートを取得します
  • POST /2/notes — Community Note を提出します
アクセスには、X Developer AI への登録および Community Notes AI Note Writer の承認が必要です。