Skip to main content

​
いいねのルックアップ: Standard v1.1 と X API v2 の比較

Standard v1.1 の GET favorites/list エンドポイントを利用してきた場合、このガイドでは、Standard v1.1 と X API v2 の Likes ルックアップエンドポイントの共通点と相違点を理解できるように説明します。 v2 では、新たに liked users エンドポイントも導入されており、ポストに「いいね」したユーザーに関する情報を取得できるようになりました。
  • 類似点
    • 認証
    • レート制限
  • 相違点
    • エンドポイント URL
    • リクエストの制約
    • App と Project の要件
    • リクエストパラメータ
    • 新しい JSON 形式

​
類似点

認証 standard v1.1 と X API v2 の Likes lookup エンドポイントは、どちらも OAuth 1.0a User Context か OAuth 2.0 Bearer Token を使用します。したがって、以前に standard v1.1 の GET favorites/list エンドポイント を使用していた場合、X API v2 版へ移行しても、引き続き同じ認証方法を使用できます。  利用している認証ライブラリやパッケージにもよりますが、Bearer Token 認証はおそらく最も簡単に始められる方法であり、シンプルなリクエストヘッダーで設定できます。Bearer Token の生成方法については、この OAuth 2.0 Bearer Token ガイド を参照してください。    レート制限 standard v1.1 の GET favorites/list エンドポイントには、ユーザーごとに 15 分あたり 75 リクエストのレート制限があります。v2 の対応する、いいねした投稿のエンドポイントにも同じレート制限があります。ただし、この v2 エンドポイントには、さらに App ごとに 15 分あたり 75 リクエストという追加のレート制限もあります。

​
相違点

エンドポイント URL リクエストの制限事項 v2 の liked Posts エンドポイントでは、1 回のリクエストで 5 ～ 100 件のポストをリクエストできますが、ページネーショントークンを使うことで、特定のポストへのすべての「いいね」を取得できます。v1.1 の GET favorites/list エンドポイントでもポストへのすべての「いいね」を取得できますが、1 回のリクエストで 20 ～ 200 件のポストを取得できます。 v2 の liking users エンドポイントでは、1 件のポストにつき取得できる liking users は最大 100 人までに制限されています。    App と Project の要件 X API v2 の各エンドポイントでは、リクエストの認証時に developer App の認証情報を使用する必要があります。この App は Project に関連付けられている必要があります。X API v1.1 のすべてのエンドポイントは、Project に関連付けられていない App か、Project に関連付けられた App のいずれかの認証情報を使用できます。 リクエストパラメータ 以下の標準 v1.1 リクエストパラメータは、user_id と screen_name の 2 つのクエリパラメータを受け付けていました。X API v2 では数値のユーザー ID のみを受け付け、エンドポイントパスの一部として渡す必要があります。 標準 v1.1 と X API v2 のエンドポイントバージョンの最大の違いの 1 つは、ペイロードにどのフィールドを含めるかの指定方法です。標準エンドポイントでは、ペイロードにどのフィールドまたはフィールドのセットを含めるかを指定するために、複数のパラメータを使用できましたが、X API v2 ではこれらさまざまなパラメータを fields と expansions に統一して簡素化しています。    新しい JSON 形式 X API v2 は、Post や user オブジェクトを含む、API が返すオブジェクトに対して新しい JSON デザインを導入しています。
  • JSON のルートレベルでは、標準エンドポイントは statuses 配列内に user オブジェクトを返しますが、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 と user の属性は、null 以外の値を持つ場合にのみ含まれます。  
新しい JSON 形式への変更に加えて、Post オブジェクトに次のような新しいフィールド群も導入しました。

​
コードサンプル

​
いいねした投稿を取得 (v2)

cURL
curl "https://api.x.com/2/users/2244994945/liked_tweets?tweet.fields=created_at,public_metrics&max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
いいねしたユーザーを取得する (v2)

cURL
curl "https://api.x.com/2/tweets/1234567890/liking_users?user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"