点赞查询

​

开始使用 Likes 查询端点

本快速入门指南将帮助你使用 Postman 向 Likes 查询端点发起第一个请求。

如果你想查看不同编程语言的示例代码，请访问我们的 X API v2 示例代码 GitHub 仓库。  

​

先决条件

要完成本指南，您需要一组密钥和令牌，可按以下步骤生成：

1. 申请开发者账号并通过审核。

2. 在开发者门户中创建一个项目以及关联的开发者应用。

3. 前往您的应用“Keys and tokens”页面，并将 API Key、Access Token 和 Bearer Token 保存到密码管理器中。

​

构建 Likes 查询请求的步骤

步骤一：选择工具或库

有多种工具、代码示例和库可用于向此端点发起请求，但为简化流程，我们将在此使用 Postman 工具。

要将 X API v2 的 Postman 集合加载到你的环境中，请点击以下按钮：

将 X API v2 添加到 Postman

在你将 X API v2 集合加载到 Postman 后，导航到 “Likes” 文件夹并选择 “Liking users.”   

步骤二：认证你的请求

要成功请求此端点，你需要使用 OAuth 1.0a User Context 或 OAuth 2.0 Bearer Token 认证。为此，你必须在 Postman 中选择名为 “X API v2” 的环境，并在 Initial value 和 Current value 字段中添加以下变量：

• consumer_key：你的 API Key
• consumer_secret：你的 API Key Secret
• access_token：你的 Access Token
• token_secret：你的 Access Token Secret  

步骤三：指定一条 Tweet

使用此端点时，你必须指定要获取点赞用户的 Tweet ID。你可以通过在 X 上打开该 Tweet，并复制 URL 末尾的数字代码来找到 Tweet 的 ID。例如，以下 URL 的 Tweet ID 是 1354143047324299264。

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

在 Postman 中，导航到 “Params” 选项卡，在 tweet_id 路径变量（该部分底部）的 “Value” 列中输入此 ID，并确保前后不包含空格。 

Key	Value
id	你想要获取其点赞用户的 Tweet ID

步骤四：确定并指定要检索的 fields

如果在完成步骤三后点击 “Send” 按钮，你将会在响应中收到默认的 user object 字段：id、name 和 username。

如果你希望接收除 id、name 和 username 之外的其他字段，你需要在请求中通过 fields 和/或 expansions 参数来指定这些字段。

在本练习中，我们将从不同对象请求三组额外字段：

1. 主 user 对象中的额外 user.created_at 字段。
2. 返回用户所关联的置顶 Tweet 对象的默认字段：id 和 text。
3. 关联 Tweet 对象中的额外 tweet.created_at 字段。

在 Postman 中，导航到 “Params” 选项卡，并将以下 key:value 对添加到 “Query Params” 表中：

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

步骤五：发起请求并查看响应

完成所有设置后，点击 “Send” 按钮，你将会收到与以下示例响应类似的结果：

{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Twitter 支持"
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "Twitter"
    },
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "Spaces"
    },
    {
      "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 名或以上关注者的用户都可以主持 Space。\n\n根据我们的学习，由于已有的受众，这些账号更有可能获得良好的主持体验。在向所有人开放创建 Space 的功能之前，我们正专注于几件事。🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2：早期访问已推出\n\n我们今天宣布对新版 Twitter API 的首批端点开放早期访问！\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }
}

步骤六：获取某位用户点赞的 Tweets

你可能还希望发起请求来获取某位用户点赞过的 Tweets。使用 Likes 查询端点（Likes lookup endpoint），你可以获取关于用户点赞 Tweets 的信息。为此，请进入 “Likes” 文件夹并选择 “Liked Tweets”。

使用此端点时，必须指定你想要获取其点赞 Tweets 的用户的 User ID。你可以使用 user lookup 端点来获取该信息。

在 Postman 中，前往 “Params” 选项卡，在 id 路径变量的 “Value” 列（位于该部分底部）中输入该用户名，注意不要在用户名前后包含任何空格。

Key	Value
id	你想获取其点赞 Tweets 的用户 ID
max_results	5

现在，你可以在 “Send” 按钮旁看到一个类似的 URL，其中包含你的 ID，而不是 TwitterDev 的：

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": "我从五年的沉睡中醒来 https://t.co/OEPVyAFcfB"
    },
    {
      "id": "1283153843367206912",
      "text": "@wongmjane 希望能告诉你更多,但我只是一个茶壶 👀"
    }
  ],
  "meta": {
        "next_token": "7140dibdnow9c7btw4539n0vybdnx19ylpayqf16fjt4l",
    	  "result_count": 5
  }
}