> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# X API v2 の Spaces エンドポイント

> X API v2 の Spaces エンドポイントを使用して、開催中または予定されている音声 Spaces のルックアップ、キーワードによる検索、作成者・ホスト・スピーカー・リスナーの詳細確認を行います。

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 に含まれる Spaces エンドポイントについて説明します。Spaces 全般について詳しく知りたい場合は、[help.x.com](https://help.x.com/en/using-twitter/spaces) をご覧ください。

Spaces では、ライブ音声会話を通じて表現やインタラクションが可能です。Spaces エンドポイントは、Spaces を中心とした新しい機能を作るためのツールを提供します。これらのエンドポイントを使用して、開催中または予定されている Spaces をルックアップしたり、ユーザーが興味を持ちそうな Spaces を見つけるためのディスカバリ体験を構築したりできます。

私たちが構築したやり方を超えて Spaces を拡張するために、皆さんの創造性を発揮してください。これらのエンドポイントを使用すると、タイトルに含まれるキーワードに基づいてリスナーに Spaces を提案したり、ユーザーがフォローしているアカウントが開催中または今後開催予定の Spaces をホストしている場合にそれらのアカウントを表示したりする体験を構築できます。また、ホストが自分の Spaces のパフォーマンスをよりよく理解し、視聴者に関するさらに多くのインサイトを得るのを助けることもできます。

### 重要なリソース

以下のリソースは、Spaces エンドポイントの利用を始めて統合するのに役立ちます:

* [X API v2 へのアクセスを取得する](/x-api/getting-started/getting-access)
* [Spaces データディクショナリ](/x-api/fundamentals/data-dictionary/reference#space)
* [Spaces エンドポイントへの最初のリクエストを送る](/x-api/spaces/lookup/introduction)

#### 現在利用可能なもの

|                   |                                                                                                                                                                                                                                                                                                                                                    |
| :---------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Spaces lookup** | [単一の Spaces ID でルックアップ](/x-api/spaces/space-lookup-by-space-id)<br /><br />[複数の Spaces ID を使用してルックアップ](/x-api/spaces/space-lookup-up-space-ids)<br /><br />[作成者 ID でルックアップ](/x-api/spaces/space-lookup-by-their-creators)<br /><br />[チケットを購入したユーザーの一覧をルックアップ](/x-api/spaces/retrieve-the-list-of-users-who-purchased-a-ticket-to-the-given-space) |
| **Search Spaces** | [キーワードを使用して Spaces を検索](/x-api/spaces/search-for-spaces)                                                                                                                                                                                                                                                                                           |

#### Spaces のライフサイクルを理解する

X 開発者プラットフォームの他のリソースとは異なり、Spaces には決まったライフサイクルがあります。Spaces は開始予定日の最大 14 日前までにスケジュール設定でき、終了後は利用不可となります。ホストは、開始前であればいつでも予定していた Space をキャンセルすることもできます。

Spaces はライブ中のみアクセス可能です。終了した Space は Spaces エンドポイントで取得できなくなり、その状態を示すエラーメッセージが返されます。

アプリで Spaces データを扱う際は、最新の情報を返す責任があります。また、プラットフォームで利用できなくなったデータを削除する責任もあります。[Spaces ルックアップエンドポイント](/x-api/spaces/lookup/introduction)は、ユーザーの期待と意図を尊重するのに役立ちます。

### Spaces でのロール

これらのエンドポイントは、X アプリでの Spaces の動作を反映しています。Spaces では、X ユーザーは Space での関わり方に応じて定義されたロールを持つことができます。

### Creator (または primary host)

Primary Host とは、Space を作成したユーザーであり、Space 自体のオーナーです。現在、Spaces は 1 人のホストしか持てないため、primary Host が唯一のホストとなります。[Spaces データディクショナリ](/x-api/fundamentals/data-dictionary/reference#space)では、primary Host 情報は creator\_id フィールドに含まれ、[user オブジェクト](/x-api/fundamentals/data-dictionary/reference#user)に展開できます。

### Hosts

Primary Hosts は 1 人以上のユーザーを共同ホストにすることができます。Spaces データディクショナリでは、これらのホストは host\_ids として表示され、user オブジェクトのリストに展開できます。ホスト指定は Space の継続期間中に変更される可能性があり、これらのエンドポイントから返されるメタデータはリクエスト時点のステータスを反映します。

アプリは creator\_id 値を確認して primary host を、host\_ids 値を確認して共同ホストが誰かを把握できます。

### Speaker

Speakers は Space 内で発言する権限を持つユーザーです。任意の時点で 0 人以上の Speakers が存在し、Space には最大 10 人(ホストを含む)の Speakers が存在できます。Space データディクショナリでは、speakers は speaker\_ids リストで返され、user オブジェクトのリストに展開できます。

### Listener

Listener は Space を聴くことができ、事前定義されたリアクションを使用していつでも反応したり、(ホストが Space 設定で許可している場合は) speaker になることをリクエストしたりできます。Listener 情報は participant\_count フィールドで参加者数(ホストを含む)の集計値としてのみ返されます。