> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-066e8699.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# X API について

> X API は X の公開会話へのプログラムからのアクセスを提供します。投稿の取得や検索、トレンドやエンゲージメントの分析、ユーザー検索、外部サービスとの連携の構築、v2 エンドポイントの活用、新しいプラットフォーム体験の創出までさまざまな用途で利用できます。

X API は、X の公開会話へのプログラムによるアクセスを提供します。投稿の取得、トレンドの分析、連携の構築、そしてプラットフォーム上での新しい体験の創出を可能にします。

***

## できること

| 機能           | 説明                          |
| :----------- | :-------------------------- |
| **投稿の読み取り**  | 投稿の検索、取得、リアルタイムストリーミング      |
| **コンテンツの公開** | 投稿、返信、スレッドの作成               |
| **ユーザーの管理**  | ユーザーの参照、フォロー、ブロック、ミュートの管理   |
| **データの分析**   | メトリクス、トレンド、エンゲージメント分析へのアクセス |
| **連携の構築**    | DM の送信、リストの管理、スペースとの対話      |

***

## API バージョン

<Tabs>
  <Tab title="X API v2 (Recommended)">
    最新機能と柔軟な料金体系を備えた現行バージョンの X API。

    **v2 を使用する理由:**

    * 従量課金制の料金体系
    * 最新の JSON レスポンス形式
    * 柔軟な [fields](/x-api/fundamentals/fields) と [expansions](/x-api/fundamentals/expansions)
    * 高度な機能: アノテーション、会話追跡、編集履歴
    * すべての新規エンドポイントと機能

    **始め方:**

    1. [console.x.com](https://console.x.com) でサインアップ
    2. アプリを作成して認証情報を取得
    3. [最初のリクエストを送信](/x-api/getting-started/make-your-first-request)
  </Tab>

  <Tab title="X API v1.1 (Legacy)">
    X API の旧バージョン。サポートは限定的です。新規プロジェクトには v2 を使用してください。

    **引き続き利用可能:**

    * 一部のメディアアップロードエンドポイント
    * レガシーストリーミング (非推奨)
    * 一部の特殊なエンドポイント

    **v2 への移行:**
    エンドポイントのマッピングとデータ形式の変更については、[移行ガイド](/x-api/migrate/overview) を参照してください。
  </Tab>
</Tabs>

***

## 利用可能なリソース

X API では、以下のリソースタイプにアクセスできます:

<CardGroup cols={3}>
  <Card title="投稿" icon="message">
    投稿の検索、取得、作成、削除。タイムライン、スレッド、引用投稿へのアクセス。
  </Card>

  <Card title="ユーザー" icon="user">
    プロフィールの参照、関係の管理、フォロワーデータへのアクセス。
  </Card>

  <Card title="スペース" icon="microphone">
    ライブ音声会話と参加者を発見。
  </Card>

  <Card title="ダイレクトメッセージ" icon="envelope">
    ユーザー間でプライベートメッセージを送受信。
  </Card>

  <Card title="リスト" icon="list">
    アカウントのキュレーションリストを作成・管理。
  </Card>

  <Card title="トレンド" icon="arrow-trend-up">
    地域別のトレンドトピックにアクセス。
  </Card>
</CardGroup>

***

## v2 のハイライト

<Accordion title="Fields と expansions">
  必要なデータのみをリクエストします。`fields` パラメータで特定の属性を選択し、`expansions` で関連オブジェクトを含めます。

  ```bash theme={null}
  curl "https://api.x.com/2/tweets/123?tweet.fields=created_at,public_metrics&expansions=author_id&user.fields=username" \
    -H "Authorization: Bearer $TOKEN"
  ```

  [fields の詳細はこちら →](/x-api/fundamentals/fields)
</Accordion>

<Accordion title="投稿アノテーション">
  投稿には、人物、場所、製品、トピックを識別する意味的アノテーションが含まれます。トピック別にストリームや検索をフィルタリングできます。

  [アノテーションの詳細はこちら →](/x-api/fundamentals/post-annotations)
</Accordion>

<Accordion title="エンゲージメントメトリクス">
  パブリックメトリクス (いいね、リポスト、返信) と、自身の投稿のプライベートメトリクス (インプレッション、クリック) にアクセスできます。

  [メトリクスの詳細はこちら →](/x-api/fundamentals/metrics)
</Accordion>

<Accordion title="会話追跡">
  `conversation_id` を使用して会話スレッド全体を再構築します。スレッド全体の返信を追跡できます。

  [会話追跡の詳細はこちら →](/x-api/fundamentals/conversation-id)
</Accordion>

<Accordion title="編集履歴">
  投稿の編集履歴 (過去のすべてのバージョンと編集メタデータを含む) にアクセスできます。

  [投稿の編集の詳細はこちら →](/x-api/fundamentals/edit-posts)
</Accordion>

***

## 料金

X API v2 は **従量課金制** の料金体系を採用しています:

| 利点              | 説明                                   |
| :-------------- | :----------------------------------- |
| **サブスクリプション不要** | 利用した分だけ支払い                           |
| **クレジットベース**    | クレジットを購入し、リクエストごとに減算                 |
| **リアルタイム追跡**    | デベロッパーコンソールで使用状況をモニタリング              |
| **重複排除**        | 24 時間以内に同じリソースを 2 回リクエストしても課金は 1 回のみ |

[料金詳細を見る →](/x-api/getting-started/pricing)

***

## 次のステップ

<CardGroup cols={2}>
  <Card title="アクセスを取得" icon="key" href="/x-api/getting-started/getting-access">
    サインアップして最初のアプリを作成しましょう。
  </Card>

  <Card title="最初のリクエストを送信" icon="rocket" href="/x-api/getting-started/make-your-first-request">
    数分で API を呼び出します。
  </Card>
</CardGroup>