> ## 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

> 投稿、ユーザー、Spaces、リスト、DM、トレンドのための v2 REST エンドポイントによる X へのプログラムからのアクセス。従量課金制とモダンな SDK を備えています。

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

X API は、X の公開会話へのプログラムによるアクセスを提供します。投稿の読み取り、コンテンツの公開、ユーザーの管理、トレンドの分析を、柔軟な従量課金制のモダンな REST エンドポイントを通じて実現できます。

<CardGroup cols={3}>
  <Card title="はじめる" icon="rocket" href="/x-api/getting-started/make-your-first-request">
    アプリを作成し、数分で最初のリクエストを送信できます。
  </Card>

  <Card title="API リファレンス" icon="code" href="/x-api/posts/create-post">
    利用可能なすべてのエンドポイントを探索できます。
  </Card>

  <Card title="SDK" icon="cube" href="/tools-and-libraries">
    公式 Python・TypeScript ライブラリ。
  </Card>
</CardGroup>

***

## 構築できるもの

<CardGroup cols={3}>
  <Card title="投稿" icon="message" href="/x-api/posts/lookup/introduction">
    投稿の検索、取得、公開。タイムライン、スレッド、引用投稿へのアクセス。
  </Card>

  <Card title="ユーザー" icon="user" href="/x-api/users/lookup/introduction">
    ユーザーの検索、フォロー、ブロック、ミュートの管理。
  </Card>

  <Card title="Spaces" icon="microphone" href="/x-api/spaces/lookup/introduction">
    ライブ音声会話とその参加者を見つけます。
  </Card>

  <Card title="ダイレクトメッセージ" icon="envelope" href="/x-api/direct-messages/lookup/introduction">
    プライベートメッセージの送受信。
  </Card>

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

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

***

## 料金

X API は **従量課金制** を採用しています。サブスクリプションはなく、使った分だけお支払いいただきます。

<CardGroup cols={2}>
  <Card title="柔軟なスケーリング" icon="chart-line">
    小さく始めて成長できます。コストは実際の使用量に応じてスケールします。
  </Card>

  <Card title="コミットメントなし" icon="unlock">
    契約や最低利用額はありません。いつでも停止できます。
  </Card>

  <Card title="リアルタイム追跡" icon="gauge-high">
    Developer Console で使用状況とコストをリアルタイムにモニタリング。
  </Card>

  <Card title="クレジットベース" icon="coins">
    クレジットを事前に購入。API を使用すると控除されます。
  </Card>
</CardGroup>

<Tip>
  X API クレジットを購入すると、無料の [xAI API](https://docs.x.ai) クレジットを獲得できます — 支出額に応じて最大 20% 還元。[詳細はこちら](/x-api/getting-started/pricing#free-xai-api-credits)
</Tip>

<div className="mt-6 flex gap-4">
  <Button href="/x-api/getting-started/pricing">料金詳細</Button>
  <Button href="https://console.x.com">クレジットを購入</Button>
</div>

***

## 主な機能

<Tabs>
  <Tab title="データアクセス">
    ### 豊富なデータオブジェクト

    投稿、ユーザー、メディアなどの詳細で構造化されたデータにアクセス:

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

    必要なデータだけを取得するために、[fields](/x-api/fundamentals/fields) と [expansions](/x-api/fundamentals/expansions) でレスポンスをカスタマイズします。
  </Tab>

  <Tab title="ほぼリアルタイムのストリーミング">
    ### Filtered stream

    投稿が公開されると、ほぼリアルタイムで配信されます。最大 1,000 のフィルタリングルールを定義し、マッチする投稿のみを受信できます。

    ```bash theme={null}
    # ルールを追加
    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"
    ```

    [Filtered stream の詳細はこちら →](/x-api/posts/filtered-stream/introduction)
  </Tab>

  <Tab title="検索 & アナリティクス">
    ### Full-archive search

    公開投稿の完全な履歴 — 2006 年までさかのぼって検索できます。ユーザー、キーワード、日付などの演算子でクエリを構築します。

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

    ### メトリクス

    インプレッション、いいね、リポスト、返信、動画再生数を含むエンゲージメントメトリクスにアクセス。

    [検索の詳細はこちら →](/x-api/posts/search/introduction)
  </Tab>
</Tabs>

***

## クイックスタート

<Steps>
  <Step title="デベロッパーアカウントを作成">
    [console.x.com](https://console.x.com) でサインアップしてアプリを作成します。
  </Step>

  <Step title="認証情報を取得">
    アプリのみリクエスト用に Bearer Token を生成します。
  </Step>

  <Step title="リクエストを送信">
    ユーザーの検索を試してみてください:

    ```bash theme={null}
    curl "https://api.x.com/2/users/by/username/xdevelopers" \
      -H "Authorization: Bearer $BEARER_TOKEN"
    ```
  </Step>
</Steps>

<Button href="/x-api/getting-started/make-your-first-request">クイックスタートガイド全文</Button>

***

## ツール & ライブラリ

<CardGroup cols={3}>
  <Card title="Python SDK" icon="python" href="/xdks/python/overview">
    非同期サポート付きの公式 Python ライブラリ。
  </Card>

  <Card title="TypeScript SDK" icon="js" href="/xdks/typescript/overview">
    公式 TypeScript/JavaScript ライブラリ。
  </Card>

  <Card title="Postman" icon="server" href="https://www.postman.com/xapidevelopers/x-api-public-workspace/collection/34902927-2efc5689-99c6-4ab6-8091-996f35c2fd80">
    インタラクティブな API エクスプローラ。
  </Card>
</CardGroup>

[すべてのライブラリを参照する →](/tools-and-libraries)

***

## サポート

<CardGroup cols={2}>
  <Card title="デベロッパーフォーラム" icon="comments" href="https://devcommunity.x.com">
    コミュニティと X チームから助けを得られます。
  </Card>

  <Card title="サポートハブ" icon="circle-question" href="https://developer.x.com/en/support/twitter-api.html">
    FAQ とトラブルシューティングガイド。
  </Card>
</CardGroup>