NodeJS使用twitter-api-v2获取用户总点赞推文数的方法

免费版Twitter API v2未在用户public_metrics字段中返回点赞总数属于官方接口设计，client.v2.userLikedTweets()方法单次最多返回100条是单页数据上限，不是接口总返回量限制，不需要升级Premium权限，通过以下两种免费方案即可实现需求：

方案一：基于官方接口分页遍历统计（稳定性最高，推荐优先使用） #

twitter-api-v2库已经封装好了自动分页逻辑，免费层级接口支持通过分页游标逐页拉取全量公开点赞数据，累计条数即为总点赞量：

• 核心规则说明
  • 免费版接口速率限制为15分钟内可发起900次用户点赞列表请求，按单次拉取100条计算，单窗口可拉取最多9万条点赞记录，覆盖绝大多数普通用户的点赞量；如果目标用户点赞量超过该数值，在逻辑中加入速率限制等待即可，库本身自带自动等待速率重置的能力。
  • 仅能获取目标用户公开可见的点赞记录，如果目标用户为私密账号、且API绑定账号未获得对方关注权限，无法获取其私密点赞数据，该限制为平台隐私规则，与API付费层级无关。
• 可直接运行的实现代码

const { TwitterApi } = require('twitter-api-v2');

// 填入你自己的免费版Twitter API凭证
const client = new TwitterApi({
  appKey: 'YOUR_OWN_API_KEY',
  appSecret: 'YOUR_OWN_API_SECRET',
  accessToken: 'YOUR_OWN_ACCESS_TOKEN',
  accessSecret: 'YOUR_OWN_ACCESS_SECRET',
});

/**
 * 获取指定用户的公开点赞推文总数量
 * @param {string} userId 目标用户的数字ID（非用户名）
 * @returns {Promise<number>} 公开点赞总条数
 */
async function calculateUserTotalLikes(userId) {
  let totalCount = 0;
  // 首次请求拉取第一页，单页拉满100条减少请求次数，仅请求推文ID字段压缩响应体积
  let paginator = await client.v2.userLikedTweets(userId, {
    max_results: 100,
    'tweet.fields': 'id'
  });

  totalCount += paginator.tweets.length;

  // 循环拉取所有后续分页，直到没有下一页标识
  while (!paginator.done) {
    paginator = await paginator.fetchNext(); // 库自动处理分页token、速率限制等待
    totalCount += paginator.tweets.length;
  }

  return totalCount;
}

// 调用示例
calculateUserTotalLikes('替换为目标用户的数字ID')
  .then(count => console.log(`目标用户公开点赞总条数：${count}`))
  .catch(err => console.error('拉取失败：', err.message));

方案二：解析前端页面内嵌数据（无API配额消耗，稳定性较弱） #

如果不想消耗API请求配额，可以直接请求目标用户的公开个人主页，解析页面渲染时内嵌的初始化数据拿到点赞总数：

• 实现逻辑：向目标用户的个人主页点赞Tab路径发起带浏览器UA的GET请求，提取HTML中内嵌的window.__INITIAL_STATE__全局对象，解析后对应用户字段下的favourites_count值即为该用户的点赞总计数。
• 注意事项
  • 该方案属于非官方实现，Twitter前端页面结构、字段命名调整时会直接失效，需要定期调整匹配规则。
  • 高频请求会触发平台反爬机制，需要加入随机请求间隔、轮换UA等反爬策略，仅适合低频查询场景。

避坑提示：目前没有任何公开免费API可以直接返回用户点赞总数字段，所有第三方免费查询工具本质都是基于上述两种逻辑实现，部分工具会缓存历史数据，存在数值更新不及时的问题。

内容的提问来源于stack exchange，提问作者Redy