X API

Xの投稿、ユーザー、スペースなどへのプログラムによるアクセス

The X API を使うと、X 上の公開された会話にプログラムからアクセスできます。投稿を読み取り、コンテンツを投稿し、ユーザーを管理し、トレンドを分析できます。これらすべてを、柔軟な従量課金制料金を備えたモダンな REST エンドポイント経由で実現できます。

はじめに

数分で App を作成し、最初のリクエストを送信しましょう。

APIリファレンス

利用可能なすべてのエンドポイントを確認できます。

SDK

公式の Python および TypeScript ライブラリです。

---

​

構築できるもの

投稿

投稿を検索、取得、投稿します。タイムラインやスレッド、引用ポストにアクセスできます。

ユーザー

ユーザーを検索し、フォロー、ブロック、ミュートを管理します。

スペース

ライブ音声の会話とその参加者を見つけます。

ダイレクトメッセージ

プライベートメッセージを送受信します。

リスト

アカウントの厳選リストを作成・管理します。

トレンド

地域ごとのトレンドトピックにアクセスします。

---

​

料金

X API は 従量課金制 を採用しています。サブスクリプション契約や月額上限はなく、利用した分だけお支払いいただきます。

柔軟なスケーリング

小規模から始めて成長させられます。コストは実際の利用量に応じてスケールします。

契約不要

契約や最低利用金額は不要です。いつでも利用を停止できます。

リアルタイムトラッキング

開発者コンソールで利用状況とコストをリアルタイムに確認できます。

クレジット制

事前にクレジットを購入し、API の利用に応じて消費されます。

料金の詳細

クレジットを購入

---

​

主な機能

データアクセス

​

リッチなデータオブジェクト

投稿、ユーザー、メディアなどについて、詳細で構造化されたデータにアクセスできます。

• 投稿: テキスト全文、メトリクス、エンティティ、アノテーション、会話スレッド
• ユーザー: プロフィール、フォロワー数、認証状況
• メディア: メタデータ付き画像、動画、GIF
• 投票: 選択肢および投票数

fields と expansions を使ってレスポンスをカスタマイズし、必要なデータだけを取得できます。

リアルタイムストリーミング

​

フィルタ済みストリーム

投稿が公開され次第、リアルタイムで受信します。最大 1,000 個のフィルタリングルールを定義して、一致する投稿のみを受け取ることができます。

# ルールを追加
curl -X POST "https://api.x.com/2/tweets/search/stream/rules" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"add": [{"value": "from:xdevelopers"}]}'

# ストリームへ接続
curl "https://api.x.com/2/tweets/search/stream" \
  -H "Authorization: Bearer $TOKEN"

フィルタ済みストリームの詳細 →

検索と分析

​

全アーカイブ検索

2006 年までさかのぼる公開投稿の履歴全体を検索できます。ユーザー、キーワード、日付などのオペレーターを使ってクエリを構築できます。

curl "https://api.x.com/2/tweets/search/all?query=AI%20lang:en" \
  -H "Authorization: Bearer $TOKEN"

​

メトリクス

インプレッション、いいね、リポスト、返信、動画再生数などのエンゲージメントメトリクスにアクセスできます。

検索の詳細 →

---

​

API バージョン

バージョン	ステータス	説明
v2	現行	モダンなエンドポイント、柔軟な料金体系、すべての新機能
Enterprise	利用可能	専任サポート付きの大規模アクセス

新しいプロジェクトには X API v2 を使用してください。新機能や改善はすべてこのバージョンで提供されます。

---

​

クイックスタート

1. 開発者アカウントを作成する

   console.x.com にサインアップして、App を作成します。

2. 認証情報を取得する

   App-only リクエスト用のベアラートークンを生成します。

3. リクエストを送信する

   ユーザー情報を取得してみましょう:

   curl "https://api.x.com/2/users/by/username/xdevelopers" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

クイックスタートガイドの全文

---

​

ツールとライブラリ

Python SDK

非同期処理対応の公式 Python ライブラリ。

TypeScript SDK

公式 TypeScript/JavaScript ライブラリ。

Postman

インタラクティブな API エクスプローラー。

すべてのツールとライブラリを表示 →

---

​

サポート

開発者フォーラム

コミュニティやXチームからヘルプを得られます。

サポートハブ

FAQやトラブルシューティングガイドを提供しています。