> ## 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 の最新バージョンは大きな変革です。そのため、この移行セクションはいくつかのパートに分けています: X API v2 は現在、主要な X API です。

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 v2 の最新バージョンは大きな変革です。そのため、この移行セクションはいくつかのパートに分けています:

| X API v2 の新機能    | X API v2 にリリースされた新しいエンドポイントと機能について学びます。                                        |
| :--------------- | :----------------------------------------------------------------------------- |
| 移行の準備はできましたか?    | 一連のガイドと手順で移行を始めましょう。                                                           |
| データフォーマット移行ガイド   | これまで standard v1.1 と enterprise のデータフォーマットで動作していたデータパーサーを作り直す方法について学びます。       |
| X API エンドポイントマップ | standard v1.1 と enterprise のエンドポイントが新しい X API v2 エンドポイントにどのようにマッピングされるかを確認します。 |

***

## X API v2 とは?

X API v2 は現在、主要な X API であり、プロダクトの投資とイノベーションが集中している場所です。私たちは開発者とパートナーシップを組み、多様な開発者コミュニティによりよく応えるために、次世代の X API を構築しました。開発者のフィードバックに基づいて、より広範なニーズに対応できるよう API を再構築し、新機能とエンドポイントを導入し、開発者体験を改善しました。

X API v2 は現在、主要な X API であり、プロダクトの投資とイノベーションが集中している場所です。過去数年間、私たちは開発者とパートナーシップを組み、より広範なニーズに応え、新機能とエンドポイントを導入し、開発者体験を改善するために API を再構築してきました。私たちはオープンな開発者プラットフォームを構築し続けることに尽力しており、皆さんが X API v2 で何を構築するかを楽しみにしています。

## なぜ移行するのか?

X API v2 は、モダンでより持続可能な基盤の上に構築されており、standard v1.1 と enterprise 製品の改良された置き換えエンドポイントと、まったく新しい機能の両方を備えています。将来的にレガシー API (v1.1 と enterprise) を廃止する予定であるため、これらのお客様には v2 への移行を開始することを強くお勧めします。X API を使用して、公開会話をリッスンして分析したり、X の人々と関わったり、革新したりしてください。

このセクションでは、エンドポイントと機能について説明します。

## V2 エンドポイント

v2 エンドポイントの完全なリストと v2 以前の同等のエンドポイントは、次のガイドで確認できます:

<Button href="/x-api/migrate/x-api-endpoint-map">
  X API エンドポイントマップ
</Button>

X API v2 のエンドポイントのほとんどは置き換えですが、いくつかの新しいエンドポイントも導入しました。v2 にリリースした新しいエンドポイントの例をいくつか紹介します:

* [Spaces エンドポイント](/x-api/spaces/introduction) は、人々が X Spaces をより有効活用するのを助け、開発者が音声会話の未来を形作れるようにします。
* [Hide replies](/x-api/posts/hide-replies/introduction) — 虐待的、注意散漫、または誤解を招く返信の影響を大規模に制限するツールを構築できます。
* 新しい Lists エンドポイントを使用すると、[List をピン留め・ピン留め解除](/x-api/lists/pinned-lists/introduction)したり、誰かのピン留めされた List をルックアップしたりできます。
* 新しい[バッチコンプライアンスエンドポイント](/x-api/compliance/batch-compliance/introduction)を使用すると、保存しているユーザーおよび Tweet データがコンプライアンスに従っていることを確認できます。

## 新機能

X API v2 には、X API でより多くの価値を見出すのに役立つ新機能も含まれています。多くの新機能は皆さんのフィードバックに基づいており、以前は enterprise 顧客向けに提供されていた一部の機能が含まれます。

API の改善点には次のものが含まれます:

* [エンドポイント全体で一貫した設計](/x-api/fundamentals/consistency)
* [レスポンスペイロードに返すフィールドとオブジェクトを指定できる機能](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions)
* [新しくより詳細なデータオブジェクト](/x-api/fundamentals/data-dictionary)
* [Tweet annotation を活用した新しいコンテキスト情報でデータを受信・フィルタリング](/x-api/fundamentals/post-annotations)
* [新しいメトリクスへのアクセス](/x-api/fundamentals/metrics)
* [返信スレッドに属する会話を簡単に識別・フィルタリング](/x-api/fundamentals/conversation-id)
* [学術研究者向けの高度な機能とデータへのアクセス拡大](https://developer.x.com/content/developer-twitter/en/products/twitter-api/academic-research)
* [ストリーミングエンドポイントのリカバリと冗長性機能](/x-api/fundamentals/recovery-and-redundancy)
* [クエリに一致する Tweet の数を簡単に返す](/x-api/posts/counts/introduction)
* [Tweet 編集のサポート](/x-api/fundamentals/edit-posts)
* 高信頼度のスパムフィルタリング
* より効果的なフィルタリングと分析のために短縮 URL を完全展開
* 非推奨のフィールドを削除し、ラベルをモダン化して簡素化された JSON レスポンスオブジェクト
* 検索クエリで一致する公開かつ利用可能な Tweet の 100% を返す
* 接続を切断せずに変更を加えられるストリーミング「ルール」
* Tweet の検索、Tweet カウント、Filtered stream 向けのより表現力豊かなクエリ言語
* 新しいライブラリを構築し、変更をより透明に追跡するための OpenAPI spec

### 新規および更新されたレスポンスオブジェクトを発見

v2 エンドポイントでは、次の 6 つのデータオブジェクトが利用可能です:

| Object                                                        | 説明                                                                                                                                        |
| :------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------- |
| [Tweet](/x-api/fundamentals/data-dictionary/reference#tweet)  | Tweet オブジェクトには、`id`、`text`、`created_at` などのルートレベルのフィールドが多数あります。Tweet オブジェクトは、`user`、`media`、`poll`、`place` などのいくつかの子オブジェクトの親オブジェクトでもあります。 |
| [User](/x-api/fundamentals/data-dictionary/reference#user)    | user オブジェクトには、参照されているユーザーを説明する X ユーザーアカウントメタデータが含まれます。                                                                                    |
| [Spaces](/x-api/fundamentals/data-dictionary/reference#space) | Space オブジェクトは次のようなフィールドで構成されています                                                                                                          |