> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-b4f5bfb1.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="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/NEh9mjpH7RaTDEed/icons/xds/icon-chat.svg?fit=max&auto=format&n=NEh9mjpH7RaTDEed&q=85&s=d41b5ee3c6e63a9a39acd28c6568d6dc" width="24" height="24" data-path="icons/xds/icon-chat.svg">
    投稿の検索、取得、作成、削除。タイムライン、スレッド、引用投稿へのアクセス。
  </Card>

  <Card title="ユーザー" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/VFX2XSyPqtT4SVsH/icons/xds/icon-person.svg?fit=max&auto=format&n=VFX2XSyPqtT4SVsH&q=85&s=d0d289815cdfc8e3c20af259d2f04c46" width="24" height="24" data-path="icons/xds/icon-person.svg">
    プロフィールの参照、関係の管理、フォロワーデータへのアクセス。
  </Card>

  <Card title="スペース" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/VFX2XSyPqtT4SVsH/icons/xds/icon-microphone.svg?fit=max&auto=format&n=VFX2XSyPqtT4SVsH&q=85&s=04d1ab715019f2cf6013b1a2ad97dccf" width="24" height="24" data-path="icons/xds/icon-microphone.svg">
    ライブ音声会話と参加者を発見。
  </Card>

  <Card title="ダイレクトメッセージ" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/Xkd8wjAYBUaNeVZi/icons/xds/icon-envelope.svg?fit=max&auto=format&n=Xkd8wjAYBUaNeVZi&q=85&s=a4e3fdf04c6687542b88aa6c8528830e" width="24" height="24" data-path="icons/xds/icon-envelope.svg">
    ユーザー間でプライベートメッセージを送受信。
  </Card>

  <Card title="リスト" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/NEh9mjpH7RaTDEed/icons/xds/icon-bulleted-list.svg?fit=max&auto=format&n=NEh9mjpH7RaTDEed&q=85&s=8751ac17be48cbce7d9750daf2641945" width="24" height="24" data-path="icons/xds/icon-bulleted-list.svg">
    アカウントのキュレーションリストを作成・管理。
  </Card>

  <Card title="トレンド" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/Xkd8wjAYBUaNeVZi/icons/xds/icon-feather-chart-line.svg?fit=max&auto=format&n=Xkd8wjAYBUaNeVZi&q=85&s=eb2233d5c6aa1d3b04d3fefea66c9db4" width="24" height="24" data-path="icons/xds/icon-feather-chart-line.svg">
    地域別のトレンドトピックにアクセス。
  </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="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/VFX2XSyPqtT4SVsH/icons/xds/icon-key.svg?fit=max&auto=format&n=VFX2XSyPqtT4SVsH&q=85&s=4fef3b633239874012e963a718d02e7b" href="/x-api/getting-started/getting-access" width="24" height="24" data-path="icons/xds/icon-key.svg">
    サインアップして最初のアプリを作成しましょう。
  </Card>

  <Card title="最初のリクエストを送信" icon="https://mintcdn.com/x-preview-mintlify-b4f5bfb1/CJEW78ZoFC_WB4AV/icons/xds/icon-rocket.svg?fit=max&auto=format&n=CJEW78ZoFC_WB4AV&q=85&s=c4d643f2a562a30abeccca3349337f50" href="/x-api/getting-started/make-your-first-request" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    数分で API を呼び出します。
  </Card>
</CardGroup>