List Posts lookup: Standard v1.1 と X API v2 の比較
これまで standard v1.1 の GET lists/statuses エンドポイントを利用してきた方向けに、standard v1.1 と X API v2 エンドポイントの類似点と相違点を理解するのに役立つことを目的としたガイドです。- 類似点
- 認証方式
- レート制限
- 相違点
- エンドポイント URL
- App と Project の要件
- リクエストあたりのデータオブジェクト数上限
- レスポンスデータ形式
- リクエストパラメータ
類似点
認証 いずれのエンドポイントバージョンも OAuth 1.0a User Context をサポートしています。したがって、以前 standard v1.1 の List Posts lookup エンドポイントのいずれかを利用していた場合、X API v2 版へ移行しても同じ認証方式を継続して利用できます。 利用している認証ライブラリ/パッケージによりますが、App only 認証はおそらく最も簡単に開始できる方法で、シンプルなリクエストヘッダーで設定できます。App only アクセストークンの生成方法については、App only ガイドをご確認ください。 レート制限相違点
エンドポイント URL- Standard v1.1 エンドポイント:
- GET https://api.x.com/1.1/lists/statuses.json (指定した List から Tweet をルックアップ)
- X API v2 エンドポイント:
- GET https://api.x.com/2/lists/:id/tweets (指定した List から Tweet をルックアップ)
- attachments
- author_id
- context_annotations
- created_at
- geo
- lang
これらの新しいパラメータについては、各ガイドや、fields と expansions の使い方についてのガイドをぜひご覧ください。
standard v1.1 のフィールドを新しい v2 のフィールドにマッピングするのに役立つデータ形式の移行ガイドもご用意しています。このガイドでは、特定のフィールドを v2 リクエストで返すために渡す必要がある具体的な expansion と field パラメータも提供されます。
特定フィールドのリクエスト方法の変更に加えて、X API v2 では API が返すオブジェクト (Post や 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 の値を持つ場合のみ含まれます。
コード例
List から Post を取得 (v2)
cURL