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

# List lookup: Standard v1.1 から X API v2 へ

> Standard v1.1 の List lookup エンドポイントと X API v2 相当エンドポイントの、パラメータ・認証・レート制限を含めたステップバイステップの比較。

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>;
};

### List lookup: Standard v1.1 と X API v2 の比較

これまで standard v1.1 の [GET lists/show](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/get-lists-show) および [GET lists/ownerships](https://developer.x.com/en/docs/twitter-api/v1/accounts-and-users/create-manage-lists/api-reference/get-lists-ownerships) エンドポイントを利用してきた方向けに、standard v1.1 と X API v2 の List lookup エンドポイントの類似点と相違点を理解するのに役立つことを目的としたガイドです。

* **類似点**
  * 認証方式
  * レート制限
* **相違点**
  * エンドポイント URL
  * App と Project の要件
  * リクエストあたりのデータオブジェクト数上限
  * レスポンスデータ形式
  * リクエストパラメータ

#### 類似点

**認証**

いずれのエンドポイントバージョンも、[OAuth 1.0a User Context](/resources/fundamentals/authentication#oauth-1-0a-2) と [App only](/resources/fundamentals/authentication#app-only-authentication-and-oauth-2-0-bearer-token) の両方をサポートしています。したがって、以前 standard v1.1 の List lookup エンドポイントのいずれかを利用していた場合、X API v2 版へ移行しても同じ認証方式を継続して利用できます。

利用している認証ライブラリ/パッケージによりますが、App only 認証はおそらく最も簡単に開始できる方法で、シンプルなリクエストヘッダーで設定できます。App only アクセストークンの生成方法については、[App only ガイド](/resources/fundamentals/authentication#using-and-generating-an-app-only-bearer-token)をご確認ください。

**レート制限**

|                                                                                                                         |                                                                                                                                                                                             |
| :---------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Standard v1.1**                                                                                                       | **X API v2**                                                                                                                                                                                |
| /1.1/lists/show\.json<br /><br />OAuth 1.0a User Context で 15 分あたり 75 リクエスト<br /><br />App only で 15 分あたり 75 リクエスト      | /2/lists/:id<br /><br />OAuth 1.0a User Context で 15 分あたり 75 リクエスト<br /><br />OAuth 2.0 Authorization Code with PKCE で 15 分あたり 75 リクエスト                                                     |
| /1.1/lists/ownerships.json<br /><br />OAuth 1.0a User Context で 15 分あたり 15 リクエスト<br /><br />App only で 15 分あたり 15 リクエスト | /2/users/:id/owned\_lists<br /><br />OAuth 1.0a User Context で 15 分あたり 15 リクエスト<br /><br />OAuth 2.0 Authorization Code with PKCE で 15 分あたり 15 リクエスト<br /><br />App only で 15 分あたり 15 リクエスト |

#### 相違点

**エンドポイント URL**

* Standard v1.1 エンドポイント:
  * GET [https://api.x.com/1.1/lists/show.json](https://api.x.com/1.1/lists/show.json)
    (指定した List をルックアップ)
  * GET [https://api.x.com/1.1/lists/ownerships.json](https://api.x.com/1.1/lists/ownerships.json)
    (指定ユーザーが所有する List をルックアップ)
* X API v2 エンドポイント:
  * GET [https://api.x.com/2/lists/:id](https://api.x.com/2/lists/:id)
    (指定した List をルックアップ)

  * GET [https://api.x.com/2/users/:id/owned\_lists](https://api.x.com/2/users/:id/owned_lists)
    (指定ユーザーが所有する List をルックアップ)

**App と Project の要件**

X API v2 エンドポイントでは、リクエスト認証時に [Project](/resources/fundamentals/developer-apps) に紐づく [developer App](/resources/fundamentals/developer-apps) の認証情報の使用が必須です。すべての X API v1.1 エンドポイントは、App または Project に関連する App の認証情報を利用できます。

**リクエストあたりのデータオブジェクト数上限**

standard v1.1 の /lists/ownerships エンドポイントでは、1 リクエストあたり最大 1000 の List を返せます。新しい v2 エンドポイントでは、1 リクエストあたり最大 100 の List を返せます。デフォルトでは 100 ユーザーオブジェクトが返され、返却件数を変更したい場合は、クエリパラメータ max\_results= に 1 - 100 の数値を渡す必要があります。次に、レスポンスペイロードで返された next\_token を、次のリクエストの pagination\_token クエリパラメータに渡します。

**レスポンスデータ形式**

standard v1.1 と X API v2 のエンドポイントバージョンにおける最も大きな違いのひとつは、ペイロードに返すフィールドをどう選ぶかです。

standard エンドポイントではデフォルトで多くのレスポンスフィールドを受け取り、パラメータを使ってペイロードに追加で返すフィールドやフィールドセットを指定するオプションがあります。

X API v2 版では、デフォルトでは List の id と name フィールドのみが返されます。追加のフィールドやオブジェクトをリクエストするには、[fields](/x-api/fundamentals/fields) と [expansions](/x-api/fundamentals/expansions) パラメータを使用する必要があります。このエンドポイントからリクエストした List フィールドはすべて、プライマリの List オブジェクトに含まれて返されます。展開された Post やユーザーオブジェクトおよびフィールドは、レスポンス内の includes オブジェクトに返されます。展開されたオブジェクトは、ユーザーおよび展開された Post オブジェクトに含まれる ID を突き合わせることで、List オブジェクトに関連付けられます。

利用可能な List フィールドと expansions の例:

* created\_at

* follower\_count

* member\_count

* owner\_id

* description

* private

|                           |               |
| :------------------------ | :------------ |
| **Endpoint**              | **Expansion** |
| /2/lists/:id              | owner\_id     |
| /2/users/:id/owned\_lists | owner\_id     |

これらの新しいパラメータについては、各ガイドや、[fields と expansions の使い方](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions)についてのガイドをぜひご覧ください。

standard v1.1 のフィールドを新しい v2 のフィールドにマッピングするのに役立つ[データ形式の移行ガイド](/x-api/migrate/data-format-migration)もご用意しています。このガイドでは、特定のフィールドを v2 リクエストで返すために渡す必要がある具体的な expansion と field パラメータも提供されます。

特定フィールドのリクエスト方法の変更に加えて、X API v2 では API が返すオブジェクト ([Post](/x-api/fundamentals/data-dictionary/reference#tweet) や [user](/x-api/fundamentals/data-dictionary/reference#user) オブジェクトを含む) の新しい JSON 設計も導入されています。

* JSON のルートレベルでは、standard エンドポイントは Post オブジェクトを statuses 配列で返しますが、X API v2 では data 配列で返します。

* Retweeted や Quoted「statuses」ではなく、X API v2 の JSON では Retweeted / Quoted Tweets を参照します。contributors や user.translator\_type など、多くのレガシー・非推奨フィールドは削除されています。

* Post オブジェクトでは favorites、user オブジェクトでは favourites という別々の表記が使われていましたが、X API v2 では like という用語に統一しています。

* X では、値が存在しない JSON 値 (たとえば null) はペイロードに書き出さないという慣習を採用しています。Post とユーザーの属性は、非 null の値を持つ場合のみ含まれます。

**リクエストパラメータ**

以下の standard v1.1 リクエストパラメータには X API v2 に相当するものがあります:

**List lookup by ID**

|                     |                               |
| :------------------ | :---------------------------- |
| **Standard v1.1**   | **X API v2**                  |
| list\_id            | id                            |
| slug                | 相当なし                          |
| owner\_screen\_name | 相当なし                          |
| owner\_id           | expansions/fields パラメータでリクエスト |

**User owned List lookup**

|                   |                   |
| :---------------- | :---------------- |
| **Standard v1.1** | **X API v2**      |
| user\_id          | id                |
| screen\_name      | 相当なし              |
| count             | max\_results      |
| cursor            | pagination\_token |