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

# X API

> 投稿、ユーザー、Spaces、リスト、DM、トレンドのための v2 REST エンドポイントによる X へのプログラムからのアクセス。従量課金制とモダンな SDK を備えています。Filtered Stream、Recent Search、OAuth 2.0、Webhook もサポートし、迅速な開発を支援します。

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <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="https://mintcdn.com/x-preview-mintlify-5e62557c/7ox7QZkMlDBhUtvj/icons/xds/icon-rocket.svg?fit=max&auto=format&n=7ox7QZkMlDBhUtvj&q=85&s=b6c3ee24b3b5aff4ba4a87805d56fdc9" href="/x-api/getting-started/make-your-first-request" width="24" height="24" data-path="icons/xds/icon-rocket.svg">
    アプリを作成し、数分で最初のリクエストを送信できます。
  </Card>

  <Card title="API リファレンス" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/NnGYBQFO1PDkJQK7/icons/xds/icon-code.svg?fit=max&auto=format&n=NnGYBQFO1PDkJQK7&q=85&s=e6a5208c5ad4cc59a4a97fed7db5ed00" href="/x-api/posts/create-post" width="24" height="24" data-path="icons/xds/icon-code.svg">
    利用可能なすべてのエンドポイントを探索できます。
  </Card>

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

***

## 構築できるもの

<CardGroup cols={3}>
  <Card title="投稿" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/NnGYBQFO1PDkJQK7/icons/xds/icon-chat.svg?fit=max&auto=format&n=NnGYBQFO1PDkJQK7&q=85&s=bf41cffe3edf828aeb6cba9bc18a8f13" href="/x-api/posts/lookup/introduction" width="24" height="24" data-path="icons/xds/icon-chat.svg">
    投稿の検索、取得、公開。タイムライン、スレッド、引用投稿へのアクセス。
  </Card>

  <Card title="ユーザー" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/dxXIRy5tzOESXfjK/icons/xds/icon-person.svg?fit=max&auto=format&n=dxXIRy5tzOESXfjK&q=85&s=b9f49bc6c7deb6ad896faddec9f3be35" href="/x-api/users/lookup/introduction" width="24" height="24" data-path="icons/xds/icon-person.svg">
    ユーザーの検索、フォロー、ブロック、ミュートの管理。
  </Card>

  <Card title="Spaces" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/dxXIRy5tzOESXfjK/icons/xds/icon-microphone.svg?fit=max&auto=format&n=dxXIRy5tzOESXfjK&q=85&s=ef1def23493faca9afc7659d9612d446" href="/x-api/spaces/lookup/introduction" width="24" height="24" data-path="icons/xds/icon-microphone.svg">
    ライブ音声会話とその参加者を見つけます。
  </Card>

  <Card title="ダイレクトメッセージ" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/RY4xKVedFJJTxUn6/icons/xds/icon-envelope.svg?fit=max&auto=format&n=RY4xKVedFJJTxUn6&q=85&s=f7cd2642fd353b2ac21784f8590e007a" href="/x-api/direct-messages/lookup/introduction" width="24" height="24" data-path="icons/xds/icon-envelope.svg">
    プライベートメッセージの送受信。
  </Card>

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

  <Card title="トレンド" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/RY4xKVedFJJTxUn6/icons/xds/icon-feather-chart-line.svg?fit=max&auto=format&n=RY4xKVedFJJTxUn6&q=85&s=2b182f91ae2f37b28c169a99a19a5224" href="/x-api/trends/trends-by-woeid/introduction" width="24" height="24" data-path="icons/xds/icon-feather-chart-line.svg">
    地域別のトレンドトピックにアクセス。
  </Card>
</CardGroup>

***

## 料金

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

<CardGroup cols={2}>
  <Card title="柔軟なスケーリング" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/QVCcrJRuVU5c6Fli/icons/xds/icon-bar-chart.svg?fit=max&auto=format&n=QVCcrJRuVU5c6Fli&q=85&s=bcaff436a3fbfd019f5d98def14963bd" width="24" height="24" data-path="icons/xds/icon-bar-chart.svg">
    小さく始めて成長できます。コストは実際の使用量に応じてスケールします。
  </Card>

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

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

  <Card title="クレジットベース" icon="https://mintcdn.com/x-preview-mintlify-5e62557c/NnGYBQFO1PDkJQK7/icons/xds/icon-coins.svg?fit=max&auto=format&n=NnGYBQFO1PDkJQK7&q=85&s=8ea5fa0faef4474ee8c76f2d3338cae3" width="24" height="24" data-path="icons/xds/icon-coins.svg">
    クレジットを事前に購入。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="https://mintcdn.com/x-preview-mintlify-5e62557c/NnGYBQFO1PDkJQK7/icons/xds/icon-chat-unread.svg?fit=max&auto=format&n=NnGYBQFO1PDkJQK7&q=85&s=e8e1b6581e93f23a87dfd20c78b3ef8b" href="https://devcommunity.x.com" width="24" height="24" data-path="icons/xds/icon-chat-unread.svg">
    コミュニティと X チームから助けを得られます。
  </Card>

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