いいねの取得

​

Likes lookup エンドポイントのはじめに

このクイックスタートガイドでは、Postman を使用して、Likes lookup エンドポイントに対する初回のリクエストを送信する方法を説明します。

さまざまな言語のサンプルコードをご覧になりたい場合は、GitHub の X API v2 sample code リポジトリをご参照ください。  

​

前提条件

このガイドを完了するには、以下の手順に従って生成できるキーとトークン一式が必要です。

1. 開発者アカウントに申し込み、承認を受けます。

2. 開発者ポータルでプロジェクトと、それに関連付けられた開発者アプリを作成します。

3. アプリの「Keys and tokens」ページに移動し、API Keys、Access Tokens、Bearer Token をパスワードマネージャーに保存します。

​

Likes ルックアップリクエストを作成する手順

ステップ1: ツールまたはライブラリから始める

このエンドポイントにリクエストを送る方法はいくつかあり、さまざまなツール、コード例、ライブラリを利用できますが、ここではプロセスを簡素化するために Postman を使用します。

X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください:

Add X API v2 to Postman

Postman で X API v2 コレクションを読み込んだら、“Likes” フォルダーに移動し、“Liking users” を選択します。   

ステップ2: リクエストを認証する

このエンドポイントに正常にリクエストするには、OAuth 1.0a User Context または OAuth 2.0 Bearer Token の認証を使用する必要があります。これを行うには、“X API v2” という名前の環境を選択し、Initial value と Current value の各フィールドに次の変数を追加して、以下のキーとトークンを Postman に設定します:

• consumer_key に API Key
• consumer_secret に API Key Secret
• access_token に Access Token
• token_secret に Access Token Secret  

ステップ3: Tweet を指定する

このエンドポイントでは、いいねしたユーザーを取得したい Tweet の ID を指定する必要があります。Tweet の ID は、その Tweet を X 上で開き、URL の末尾にある数値コードを取得することで確認できます。たとえば、次の URL の Tweet ID は 1354143047324299264 です。

https://x.com/TwitterDev/status/1354143047324299264

Postman で “Params” タブに移動し、セクション最下部の tweet_id パス変数の “Value” 列にこの ID を入力します。前後にスペースを入れないようにしてください。 

Key	Value
id	いいねしたユーザーを取得したい Tweet の ID

ステップ4: 取得したい fields を特定して指定する

ステップ3の後に “Send” ボタンをクリックすると、レスポンスにはデフォルトの user object の fields（id、name、username）が返されます。

id、name、username 以外の追加の fields を受け取りたい場合は、リクエストで fields および/または expansions パラメータを使用してそれらの fields を指定します。

この演習では、異なるオブジェクトから 3 セットの追加 fields をリクエストします:

1. 主要なユーザーオブジェクトの追加フィールド user.created_at。
2. 返されたユーザーに関連付けられた固定済み Tweet オブジェクトのデフォルト fields（id、text）。
3. 関連する Tweet オブジェクトの追加フィールド tweet.created_at。

Postman で “Params” タブに移動し、“Query Params” テーブルに次の key:value のペアを追加します:

Key	Value	Returned fields
user.fields	created_at	user.created_at
expansions	pinned_tweet_id	tweet.id, tweet.text
tweet.fields	created_at	tweet.created_at

これで “Send” ボタンの横に次の URL が表示されるはずです:

https://api.x.com/2/tweets/1354143047324299264/liking_users?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at

ステップ5: リクエストを送信し、レスポンスを確認する

準備が整ったら “Send” ボタンを押すと、次のサンプルと同様のレスポンスが返されます。

{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Xサポート"
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "X"
    },
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "スペース"
    },
    {
      "pinned_tweet_id": "1293595870563381249",
      "created_at": "2007-05-23T06:01:13.000Z",
      "id": "6253282",
      "username": "XAPI",
      "name": "X API"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-05-03T17:26:09.000Z",
        "id": "1389270063807598594",
        "text": "600人以上のフォロワーを持つすべてのユーザーがスペースをホストできるようになりました。\n\nこれまでの知見から、既存のオーディエンスを持つこれらのアカウントは、ホスティングで良好な体験が得られる可能性が高いと考えられます。スペース作成機能をすべてのユーザーに提供する前に、いくつかの点に注力しています。🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2: アーリーアクセス公開\n\n本日、新しいX APIの最初のエンドポイントへのアーリーアクセスを発表しました!\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }
}

ステップ6：ユーザーの「いいね」したTweetを取得する

ユーザーが「いいね」したTweetを取得するリクエストも行えます。Likes lookupエンドポイントを使うと、ユーザーが「いいね」したTweetに関する情報を取得できます。これを行うには、“Likes” フォルダーに移動し、“Liked Tweets” を選択します。 

このエンドポイントでは、「いいね」したTweetを取得したい対象のUser IDを指定する必要があります。この情報は、user lookup エンドポイントで取得できます。

Postmanで “Params” タブに移動し、idパス変数の “Value” 列（セクションの一番下）にこのユーザー名を入力します。ユーザー名の前後にスペースを入れないようにしてください。 

Key	Value
id	「いいね」したTweetを取得したいユーザーのID
max_results	5

これで、“Send” ボタンの横に表示されるURLが、TwitterDevではなくあなたのIDに置き換わった同様の形式になります：  

https://api.x.com/2/users/2244994945/liked_tweets?max_results=5

設定が完了したら、“Send” ボタンを押すと、次の例と同様のレスポンスが返ってきます。

{
  "data": [
    {
      "id": "1362449997430542337",
      "text": "@TwitterDevのラブフェストで最初に取り上げられた開発者として光栄です 🥰♥️😍 https://t.co/g8TsPoZsij"
    },
    {
      "id": "1365416026435854338",
      "text": "公式パートナーの@Brandwatchとそのビッグニュースをとても嬉しく思います。https://t.co/3DwWBNSq0o https://t.co/bDUGbgPkKO"
    },
    {
      "id": "1296487407475462144",
      "text": "@TwitterDevのこの特集をチェックして、進化する#publichealth危機を理解するために、ソーシャルメディアデータをどのように分析しているかについて詳しく学んでください https://t.co/sIFLXRSvEX。"
    },
    {
      "id": "1294346980072624128",
      "text": "5年の眠りから目覚めました https://t.co/OEPVyAFcfB"
    },
    {
      "id": "1283153843367206912",
      "text": "@wongmjane もっとお伝えできればいいのですが、私はただのティーポットです 👀"
    }
  ],
  "meta": {
        "next_token": "7140dibdnow9c7btw4539n0vybdnx19ylpayqf16fjt4l",
    	  "result_count": 5
  }
}