v1 から v2 へ

リスト投稿ルックアップ: Standard v1.1 と X API v2 の比較

標準 v1.1 の GET lists/statuses エンドポイントを利用している場合、このガイドでは、標準 v1.1 エンドポイントと X API v2 エンドポイントの共通点と相違点を理解できるように解説します。

共通点
- 認証方法
- レート制限
相違点
- エンドポイント URL
- App と Project の要件
- リクエストごとのデータオブジェクト数の上限
- レスポンスデータ形式
- リクエストパラメータ

類似点

認証両方のエンドポイントバージョンは OAuth 1.0a User Context をサポートしています。したがって、以前に標準 v1.1 の List Posts ルックアップエンドポイントのいずれかを使用していた場合、X API v2 のバージョンへ移行しても、同じ認証方式を引き続き利用できます。利用する認証ライブラリ／パッケージによっては、App のみ認証が最も簡単な利用開始方法であり、シンプルなリクエストヘッダーで設定できます。App のみ Access Token の生成方法については、この App のみガイドを参照してください。 レート制限


Standard v1.1	X API v2
/1.1/lists/statuses.json OAuth 1.0a User Context を使用した場合、15 分あたり 900 リクエスト App のみ認証を使用した場合、15 分あたり 900 リクエスト	/2/lists/:id/tweets OAuth 1.0a User Context を使用した場合、15 分あたり 900 リクエスト OAuth 2.0 Authorization Code with PKCE を使用した場合、15 分あたり 900 リクエスト App のみ認証を使用した場合、15 分あたり 900 リクエスト

違い

エンドポイント URL

標準 v1.1 エンドポイント:
- GET https://api.x.com/1.1/lists/statuses.json (指定したリストからツイートを取得)
X API v2 エンドポイント:
- GET https://api.x.com/2/lists/:id/tweets (指定したリストからツイートを取得)

App と Project の要件 X API v2 のエンドポイントでは、リクエストを認証する際に、developer App の認証情報を使用する必要があります。また、この App は Project に関連付けられている必要があります。X API v1.1 のすべてのエンドポイントでは、Project に関連付けられていない App の認証情報も、Project に関連付けられた App の認証情報も使用できます。 1 リクエストあたりのデータオブジェクト数の上限 標準 v1.1 の /lists/statuses エンドポイントでは、1 回のリクエストで最大 5000 件の投稿を返すことができます。新しい v2 エンドポイントでは、1 回のリクエストで最大 100 件の投稿を返すことができます。デフォルトでは 100 件の user オブジェクトが返されます。返される結果数を変更するには、クエリパラメータ max_results= に 1〜100 の数値を指定する必要があります。その後、レスポンスペイロードで返される next_token を、次のリクエストの pagination_token クエリパラメータに指定できます。 レスポンスデータ形式 標準 v1.1 と X API v2 のエンドポイントバージョンの最大の違いの 1 つは、どのフィールドをペイロードに含めるかの指定方法です。標準エンドポイントでは、多くのレスポンスフィールドがデフォルトで返され、追加で返したいフィールドまたはフィールドセットをパラメータで指定することができます。 X API v2 のバージョンでは、デフォルトで返されるのは Post の id と text フィールドのみです。追加のフィールドやオブジェクトを要求するには、fields および expansions パラメータを使用する必要があります。このエンドポイントから要求した Post のフィールドは、すべてプライマリの Post オブジェクト内に返されます。展開されたオブジェクトのフィールドは、レスポンス内の includes オブジェクトに返されます。その後、プライマリオブジェクトと展開されたオブジェクトの ID を照合することで、任意の展開オブジェクトをプライマリの Post オブジェクトに対応付けることができます。以下は、指定可能な Post のフィールドと expansions の例です:

attachments
author_id
context_annotations
created_at
geo
lang


エンドポイント	Expansion
/2/lists/:id/tweets	author_id

これらの新しいパラメータの詳細については、それぞれのガイド、または fields と expansions の使用方法に関するガイドを参照することをお勧めします。また、標準 v1.1 のフィールドを新しい v2 のフィールドにマッピングするのに役立つデータ形式移行ガイドも用意しています。このガイドでは、特定のフィールドを返すために v2 のリクエストに指定する必要がある、具体的な expansion および field パラメータも確認できます。特定のフィールドのリクエスト方法の変更に加えて、X API v2 では、Post オブジェクトや user オブジェクトを含む、API が返すオブジェクトの新しい JSON 設計も導入しています。

JSON のルートレベルでは、標準エンドポイントは Post オブジェクトを statuses 配列で返しますが、X API v2 は data 配列で返します。
Retweeted と Quoted の「statuses」を指す代わりに、X API v2 の JSON では Retweeted と Quoted のツイートを参照します。contributors や user.translator_type など、多くのレガシー／非推奨フィールドは削除されます。
Post オブジェクトでの favorites、user オブジェクトでの favourites の両方を使用する代わりに、X API v2 では like という用語を使用します。
X では、値がない JSON フィールド (たとえば null) はペイロードに書き出さないという規約を採用しています。Post および user の属性は、非 null の値を持つ場合にのみ含まれます。

リクエストパラメータ 次の標準 v1.1 リクエストパラメータには、X API v2 における対応する項目があります:


標準 v1.1	X API v2
list_id	id
slug	対応する項目なし
owner_screen_name	対応する項目なし
owner_id	expansions パラメータで author_id を指定してリクエスト
since_id	対応する項目なし
max_id	対応する項目なし
include_entities	tweet.fields パラメータで entities を指定してリクエスト
include_rts	対応する項目なし
count	max_results

コード例

リストから投稿を取得 (v2)

cURL

curl "https://api.x.com/2/lists/84839422/tweets?tweet.fields=created_at,public_metrics&max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/lists/84839422/tweets"

params = {
    "tweet.fields": "created_at,public_metrics",
    "max_results": 100
}
headers = {"Authorization": f"Bearer {bearer_token}"}

response = requests.get(url, headers=headers, params=params)
print(response.json())

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# リストから投稿を取得
for page in client.lists.get_tweets(
    "84839422",
    tweet_fields=["created_at", "public_metrics"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// リストから投稿を取得
const paginator = client.lists.getTweets("84839422", {
  tweetFields: ["created_at", "public_metrics"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.created_at}: ${post.text?.slice(0, 50)}...`);
  });
}

Getting Started

Fundamentals

Partners & Customers

Resources

v1 から v2 へ

リスト投稿ルックアップ: Standard v1.1 と X API v2 の比較

類似点

違い

コード例

リストから投稿を取得 (v2)

​リスト投稿ルックアップ: Standard v1.1 と X API v2 の比較

​類似点

​違い

​コード例

​リストから投稿を取得 (v2)

リスト投稿ルックアップ: Standard v1.1 と X API v2 の比較

類似点

違い

コード例

リストから投稿を取得 (v2)