通过 Twitter API 能获取哪些数据？

#API 能返回的 15 类 X 公开数据

X 公开数据指 X 向任何人展示的内容：没有设为受保护的账号发的帖子、资料、粉丝列表，以及旁边的各种计数。API 以 JSON 返回，共 15 类：

• 资料： 名称、简介、所在地、注册日期、粉丝数、关注数和发帖数、头像和认证标识。
• 账号简介（About）： X 关联到该账号的国家，用户名改过几次、何时改的，以及它的 X Premium 状态。
• 粉丝和关注： 任何一方的完整列表，每个账号附带资料。
• 帖子： 文本、语言、日期、六项互动计数（点赞、转发、回复、引用、浏览量、书签）、链接、媒体和作者。
• 时间线： 某个账号发的帖子、它的回复和它的转发。
• 互动列表： 一条帖子下的回复、它的引用帖，以及转发过它的账号。
• 帖子搜索： 带运算符的任意 X 高级搜索查询，覆盖回溯到 2006 年的存档。
• 提及： @ 了某个账号的帖子，可按点赞、回复、转发和日期筛选。
• 账号搜索： 名称、用户名或简介匹配某个关键词的账号。
• 列表： 一个列表的成员、它的关注者，以及其成员帖子的汇总信息流。
• 社群： 一个社群的详情、成员和帖子，以及在其中搜索。
• Space： 一个直播音频房间的标题、状态、主持人、发言者、听众和听众数。
• 趋势： 某个国家或城市正在流行的话题。
• X 文章： 长文帖子的完整文本，附封面图和各项数据。
• 检查： 是或否的回答，比如一个账号是否关注了另一个，或是否转发了某条帖子。

私密数据不在这份清单里。自 2024 年 6 月起，X 只向帖子的作者显示谁点了赞，只向账号本人显示该账号的点赞，没有任何 API 会返回别人的点赞、书签或私信；你无法获取的完整清单在后面。

获取数据的途径也不同。官方 X API 涵盖这 15 类中的大部分，没有 About 数据的字段，并且对返回的每一项都计费；我们的 X API 价格指南列出了每一档费率。

#用 Sorsa API 获取每一类数据

要把一个项目对应到 X 数据上，用 Sorsa API：它通过 45 个接口、一个 API 密钥返回全部 15 类，所有套餐统一每秒 20 次请求，价格从每 1,000 个粉丝 $0.007、每 1,000 条推文 $0.014 起。它不需要 X 开发者账号、应用或 OAuth，详见我们的不用开发者账号使用 Twitter API指南。

每次请求的价格相同，所以下表给出一次请求能带多少项，以及 1,000 项的费用，并与官方 X API 对同样数据的按量付费价格（在新标签页打开）放在一起。全部 45 个接口及其参数见 Sorsa API 接口页面。

• 资料

  Sorsa API 接口

  GET /info-batch（在新标签页打开）

  每次请求

  100 份资料

  Sorsa API，每 1,000 项

  $0.014 起

  官方 X API，每 1,000 项

  $10.00

• 账号简介（About）

  Sorsa API 接口

  GET /about（在新标签页打开）

  每次请求

  1 个账号

  Sorsa API，每 1,000 项

  $1.40 起

  官方 X API，每 1,000 项

  没有对应字段

• 粉丝、关注

  Sorsa API 接口

  GET /followers（在新标签页打开）、GET /follows（在新标签页打开）

  每次请求

  200 个粉丝

  Sorsa API，每 1,000 项

  $0.007 起

  官方 X API，每 1,000 项

  $10.00

• 按 ID 或链接取帖子

  Sorsa API 接口

  POST /tweet-info-bulk（在新标签页打开）

  每次请求

  100 条帖子

  Sorsa API，每 1,000 项

  $0.014 起

  官方 X API，每 1,000 项

  $5.00，11 月 22 日起作者另加 $10.00

• 时间线

  Sorsa API 接口

  POST /user-tweets（在新标签页打开）

  每次请求

  20 条帖子

  Sorsa API，每 1,000 项

  $0.07 起

  官方 X API，每 1,000 项

  $5.00

• 回复、引用、转发者

  Sorsa API 接口

  POST /comments（在新标签页打开）、POST /quotes（在新标签页打开）、POST /retweeters（在新标签页打开）

  每次请求

  20

  Sorsa API，每 1,000 项

  $0.07 起

  官方 X API，每 1,000 项

  帖子 $5.00，账号 $10.00

• 帖子搜索

  Sorsa API 接口

  POST /search-tweets（在新标签页打开）

  每次请求

  20 条帖子

  Sorsa API，每 1,000 项

  $0.07 起

  官方 X API，每 1,000 项

  $5.00

• 提及

  Sorsa API 接口

  POST /mentions（在新标签页打开）

  每次请求

  20 条帖子

  Sorsa API，每 1,000 项

  $0.07 起

  官方 X API，每 1,000 项

  $5.00

• 账号搜索

  Sorsa API 接口

  POST /search-users（在新标签页打开）

  每次请求

  20 个账号

  Sorsa API，每 1,000 项

  $0.07 起

  官方 X API，每 1,000 项

  $10.00

• 列表

  Sorsa API 接口

  GET /list-tweets（在新标签页打开）、GET /list-members（在新标签页打开）

  每次请求

  20

  Sorsa API，每 1,000 项

  $0.07 起

  官方 X API，每 1,000 项

  帖子 $5.00，成员 $10.00

• 社群

  Sorsa API 接口

  POST /community-tweets（在新标签页打开）、POST /community-members（在新标签页打开）

  每次请求

  20

  Sorsa API，每 1,000 项

  $0.07 起

  官方 X API，每 1,000 项

  社群 $5.00，之后每条帖子或每个成员另计

• Space

  Sorsa API 接口

  GET /spaces（在新标签页打开）

  每次请求

  1 个 Space

  Sorsa API，每 1,000 项

  $1.40 起

  官方 X API，每 1,000 项

  $5.00

• 趋势

  Sorsa API 接口

  GET /trends（在新标签页打开）

  每次请求

  1 个地区

  Sorsa API，每 1,000 项

  $1.40 起

  官方 X API，每 1,000 项

  $10.00

• X 文章

  Sorsa API 接口

  POST /article（在新标签页打开）

  每次请求

  1 篇文章

  Sorsa API，每 1,000 项

  $1.40 起

  官方 X API，每 1,000 项

  $5.00，按帖子读取

• 检查

  Sorsa API 接口

  POST /check-follow（在新标签页打开），另有 5 个

  每次请求

  1 个回答

  Sorsa API，每 1,000 项

  $1.40 起

  官方 X API，每 1,000 项

  没有单一调用：读取列表，$10.00

每项工作需要哪些数据

大多数项目会读取这 15 类中的两三类，每项工作对应一小组接口：

• 品牌和关键词监控

  它读取的数据

  帖子搜索、提及

  Sorsa API 接口

  POST /search-tweets、POST /mentions

• 受众和影响者研究

  它读取的数据

  粉丝、资料、About 数据

  Sorsa API 接口

  GET /followers、GET /info-batch、GET /about

• 竞品跟踪

  它读取的数据

  时间线、回复、引用

  Sorsa API 接口

  POST /user-tweets、POST /comments、POST /quotes

• 研究和 AI 数据集

  它读取的数据

  回溯到 2006 年的搜索、按 ID 取帖子

  Sorsa API 接口

  POST /search-tweets、POST /tweet-info-bulk

• 抽奖和营销活动

  它读取的数据

  检查

  Sorsa API 接口

  POST /check-follow、POST /check-retweet

• 监视大量账号或某个市场

  它读取的数据

  列表、趋势

  Sorsa API 接口

  GET /list-tweets、GET /trends

你的第一次请求

三步让你从没有账号走到拿到第一份资料：

1. 获取密钥。 注册并从控制台复制你的 API 密钥。前 100 次请求免费。

2. 请求一份资料。 调用 GET /info（在新标签页打开），密钥放在 ApiKey 请求头里，并用 username、user_id 或 user_link 中恰好一个来指明账号。

   curl -G "https://api.sorsa.io/v3/info" \
     -H "ApiKey: YOUR_API_KEY" \
     --data-urlencode "username=orbit_data_studio"
   

   {
     "id": "1593004418823766016",
     "username": "orbit_data_studio",
     "display_name": "Orbit Data Studio",
     "description": "Charts and notes on public conversation.",
     "location": "Lisbon",
     "created_at": "2022-11-16T09:41:12Z",
     "followers_count": 18420,
     "followings_count": 312,
     "tweets_count": 4127,
     "favourites_count": 9230,
     "media_count": 688,
     "verified": false,
     "protected": false,
     "can_dm": true,
     "possibly_sensitive": false,
     "bio_urls": ["https://orbit-data.example"],
     "pinned_tweet_ids": ["1981442093318201344"],
     "profile_image_url": "https://pbs.twimg.com/profile_images/orbit.jpg"
   }
   

   显示完整响应

3. 在列表上跟随游标。 返回列表的接口会附带 next_cursor；把它放进下一次请求，直到返回为空。401 表示密钥错误，403 表示缺少密钥或请求次数用完，429 表示一秒内发出了超过 20 次请求。

#一条帖子包含什么：22 个字段和它的作者

Sorsa API 返回的一条帖子带有 22 个字段，作者的完整资料就在其中：POST /tweet-info（在新标签页打开） 按链接或 ID 返回一条帖子，POST /tweet-info-bulk 一次请求最多返回 100 条。回复、引用和转发会连同原帖一并返回，原帖的作者也包含在内。

官方 X API 一开始给得更少。正如它的字段指南（在新标签页打开）所说，帖子查询默认只返回三个字段：id、text 和 edit_history_tweet_ids；其余的需要 tweet.fields，作者则需要一个 expansion，据 X 的通知（在新标签页打开），从 2026 年 11 月 22 日起，X 会把它按 $0.010 的用户读取计费。

下面是每个字段，以及官方 X API v2 对同一内容使用的名称，这样针对任一方写的代码都能对应起来：

• id、created_at、lang

  它保存什么

  字符串形式的帖子 ID、ISO 8601 日期和语言代码

  官方 X API v2 字段

  id、created_at、lang

• full_text

  它保存什么

  完整文本，包括长帖

  官方 X API v2 字段

  text，长帖用 note_tweet.text

• likes_count、retweet_count、reply_count、quote_count、bookmark_count

  它保存什么

  发出请求那一刻的互动计数

  官方 X API v2 字段

  public_metrics.like_count、retweet_count、reply_count、quote_count、bookmark_count

• view_count

  它保存什么

  浏览量，X 称之为 impressions

  官方 X API v2 字段

  public_metrics.impression_count

• conversation_id_str

  它保存什么

  会话串里第一条帖子的 ID

  官方 X API v2 字段

  conversation_id

• is_reply、in_reply_to_tweet_id、in_reply_to_username

  它保存什么

  是否为回复、回复哪条帖子、回复谁

  官方 X API v2 字段

  referenced_tweets、in_reply_to_user_id

• is_quote_status、quoted_status、retweeted_status

  它保存什么

  被引用的帖子，或被转发帖子的原帖，完整返回

  官方 X API v2 字段

  referenced_tweets 加一个 expansion

• entities

  它保存什么

  图片、视频和链接：类型、链接、预览

  官方 X API v2 字段

  entities，attachments 加媒体 expansion

• user

  它保存什么

  作者的完整资料

  官方 X API v2 字段

  author_id 加一个 expansion

• is_replies_limited、paid_partnership、made_with_ai

  它保存什么

  回复限制，以及 X 的付费合作和 AI 生成标签

  官方 X API v2 字段

  reply_settings、paid_partnership

要一次读取 100 条帖子，把它们的 ID 或链接发给批量接口：

import requests

URL = "https://api.sorsa.io/v3/tweet-info-bulk"
HEADERS = {"ApiKey": "YOUR_API_KEY"}

ids = ["1985274530112847105", "1985190021774452736"]  # up to 100
r = requests.post(URL, headers=HEADERS, json={"tweet_links": ids})
r.raise_for_status()
for t in r.json()["tweets"]:
    print(t["id"], t["view_count"], t["likes_count"], t["user"]["username"])

const res = await fetch("https://api.sorsa.io/v3/tweet-info-bulk", {
  method: "POST",
  headers: { ApiKey: "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ tweet_links: ["1985274530112847105"] }),
});
const { tweets } = await res.json();
for (const t of tweets) console.log(t.id, t.view_count, t.user.username);

须知

每个计数都是快照。likes_count、view_count 等是你发出请求那一刻的值，之后还会继续增长，所以在对比两条帖子之前，先记下每次读取的时间。

#一份资料包含什么，以及 About 数据

Sorsa API 返回的一份资料有 19 个字段，来自读取一个账号的 GET /info，或最多读取 100 个的 GET /info-batch。GET /about 再加 7 个字段，这些是 X 只在账号的“关于此账号”页面上展示的内容。

• id

  它保存什么

  字符串形式的永久账号 ID

  官方 X API v2 字段

  id

• username、display_name

  它保存什么

  不带 @ 的用户名，以及显示名称

  官方 X API v2 字段

  username、name

• description、bio_urls、location、created_at

  它保存什么

  简介、其中的链接、按填写原样的所在地、注册日期

  官方 X API v2 字段

  description、entities、location、created_at

• followers_count、followings_count、tweets_count、favourites_count、media_count

  它保存什么

  粉丝、关注、帖子、点赞过的帖子、发布的媒体

  官方 X API v2 字段

  public_metrics 里的各项计数

• verified、protected、possibly_sensitive、can_dm

  它保存什么

  认证标识、受保护帖子、敏感标记、是否接收私信

  官方 X API v2 字段

  verified、protected、receives_your_dm

• pinned_tweet_ids、profile_image_url、profile_background_image_url

  它保存什么

  置顶帖子、头像和横幅

  官方 X API v2 字段

  pinned_tweet_id、profile_image_url、profile_banner_url

About 数据在官方 X API 里没有对应项：它的数据字典（在新标签页打开）没有为用户列出国家或用户名历史。GET /about 返回：

• country：X 关联到该账号的国家；
• username_change_count 和 last_username_change_at：用户名改过几次，以及最近一次是什么时候；
• is_blue_verified 和 premium_start_at：X Premium 认证勾标，以及从何时开始；
• source 和 affiliate_username：X 显示的账号来源，以及其隶属标识背后的账号。

对单个账号，免费的 Twitter 账号所在地查询可以在浏览器里显示同一个国家。

须知

ID 要按字符串保存。帖子 ID 和账号 ID 是 64 位数字，JavaScript 把它们当数字解析时会四舍五入。请保存账号的 id，而不是 username，因为账号主人随时可以修改用户名。

#粉丝、互动列表和是或否的检查

账号列表按页返回完整资料。GET /followers、GET /follows 和 GET /verified-followers（在新标签页打开） 每次请求最多返回 200 个，所以 100 万个粉丝要 5K 次请求，$7 起；导出 Twitter 粉丝指南里有游标循环和 CSV 导出的做法。

围绕单条帖子，有三个接口返回它的公开互动，每页 20 项：

• POST /comments：它下面的回复，可按相关性、时间或点赞排序；
• POST /quotes：引用它的帖子，每条带有作者；
• POST /retweeters：转发过它的账号，最新的在前，以完整资料返回。

一个账号自己的产出来自 POST /user-tweets，把 type 设为 posts、replies 或 retweets。它可以翻页读完整条时间线，突破官方 X API 时间线接口止步的最新 3,200 条帖子；下载某个用户的全部推文指南会把它变成一个文件。

检查每次请求回答一个问题，每次 $0.0014 起：

• POST /check-follow：一个账号是否关注了另一个；
• POST /check-retweet（在新标签页打开）：一个账号是否转发了某条帖子，每次请求扫描 100 条转发；
• POST /check-quoted（在新标签页打开）：quoted、retweet 或 not_found；
• GET /check-comment（在新标签页打开）：一个账号是否回复过，以及那条回复本身；
• POST /check-community-member（在新标签页打开）：一个账号是否在某个社群里；
• GET /check-shadowban（在新标签页打开）：搜索封禁和搜索建议封禁，结果为 clean、banned 或 unknown，缓存一小时。

Twitter 验证 API指南会把它们用于抽奖或营销活动。

#搜索、列表、社群、Space、趋势和文章

POST /search-tweets 接受任何 X 高级搜索查询，支持 from:、to:、since:、until:、精确短语和话题标签，可按 popular 或 latest 排序，覆盖回溯到 2006 年的存档。Twitter 历史数据指南讲了按日期范围获取的方法。

POST /mentions 找出 @ 了某个账号的帖子，并加上筛选条件：min_likes、min_replies、min_retweets，以及格式为 YYYY-MM-DD 的 since_date 和 until_date。POST /search-users 按名称、用户名或简介里的某个词来查找账号。

列表可以一次监视大量账号：一次 GET /list-tweets 请求就返回其所有成员最新的帖子，一个列表最多容纳 5,000 个账号。GET /list-members 和 GET /list-followers（在新标签页打开） 以资料的形式返回它的账号。

社群有五个接口：POST /community-info（在新标签页打开）（名称、描述、成员数、横幅、创建者，以及以 Unix 时间戳表示的创建时间）、POST /community-members、POST /community-tweets 和 POST /community-search-tweets（在新标签页打开）（热门或最新），以及 POST /search-communities（在新标签页打开），每次请求最多 10 个。

GET /spaces 接收 Space 的 ID 或链接，返回它的标题、状态、预定开始时间和创建者，分为管理员、发言者和听众的参与者，回放和剪辑等设置，以及它的统计：实时听众、参与者和回放观看次数。它的时间以 Unix 数字给出，而 API 的其余部分使用 ISO 8601 日期。

GET /trends 接收一个 WOEID，也就是国家或城市的 Where On Earth ID，返回每个趋势的名称、搜索 query 和链接。POST /article 返回一篇 X 文章：完整文本、预览、封面图、发布日期、各项计数（浏览量在 views_count 里），以及作者的资料。

#没有任何 Twitter API 能返回的数据

没有任何 API 能返回 X 保持私密的数据，官方 X API 也不例外。2024 年 6 月 11 日，X 宣布（在新标签页打开），它的点赞接口只返回已认证账号自己帖子的点赞和点赞者，对其他所有帖子返回空结果。

下表每一行都有一个你可以改为读取的公开信号：

• 谁给帖子点了赞

  为什么没有 API 能返回

  自 2024 年 6 月起私密：只有帖子作者能看到

  你可以改为读取什么

  likes_count，以及公开的回复、引用和转发者

• 一个账号的点赞

  为什么没有 API 能返回

  自 2024 年 6 月起，只有该账号自己能看到

  你可以改为读取什么

  favourites_count，即它点赞过多少条帖子

• 书签

  为什么没有 API 能返回

  只有保存它们的账号能看到

  你可以改为读取什么

  每条帖子上的 bookmark_count

• 私信

  为什么没有 API 能返回

  只在参与者之间私密

  你可以改为读取什么

  can_dm，即该账号是否接收私信

• 受保护账号的帖子

  为什么没有 API 能返回

  只有获批的关注者能看到

  你可以改为读取什么

  资料，其中 protected: true

• 已删除的帖子

  为什么没有 API 能返回

  一旦删除就从 X 上消失

  你可以改为读取什么

  只有你之前存下的副本

• 谁看过帖子或资料

  为什么没有 API 能返回

  X 只以数字形式显示浏览量

  你可以改为读取什么

  view_count

• 过去的粉丝列表、关注日期

  为什么没有 API 能返回

  X 不保留谁在何时关注的公开历史

  你可以改为读取什么

  按计划导出列表，用 id 对比

• 邮箱、手机号

  为什么没有 API 能返回

  在 X 上从不公开

  你可以改为读取什么

  无

即使是官方 X API，也只读取通过 OAuth 授权了应用的那个账号自己的点赞、书签和私信，从不读取别人的。

Sorsa API 有意不做的事

Sorsa API 只读不写：不能发帖、点赞、关注或发私信。它从不要求你的 X 登录信息，所以你的账号不会有风险；如果还想发帖，请搭配官方 X API 使用。它按请求工作，没有数据流或 webhook：新帖子要靠轮询 POST /search-tweets 或 GET /list-tweets 获得，所有套餐统一每秒 20 次请求。

#每类数据每 1,000 项的成本

Sorsa API 不管返回多少内容都只计一次请求，所以页面越大，每 1,000 项的价格越低：每 1,000 个粉丝 $0.007 起（每页 200 个），每 1,000 条按 ID 查询的帖子或资料 $0.014 起（每次请求 100 个），每 1,000 条搜索结果 $0.07 起（每页约 20 条）。官方 X API 对每一项都计费：每 1,000 条帖子 $5.00，每 1,000 份资料或粉丝 $10.00，从 11 月 22 日起每条帖子的作者再加 $0.010。

失败的请求从不收费，而官方 X API 每月读取 300 万条帖子后封顶，超过之后 X 只出售 Enterprise 合同。每个新账号送的 100 次免费请求，最多可覆盖 1 万条推文或 2 万个粉丝。

#用一个密钥读取全部 15 类数据

API 能返回 15 类 X 公开数据，而不包括任何私密数据。要读取它们，用 Sorsa API：一个密钥，45 个接口，推文每 1,000 条 $0.014 起，粉丝每 1,000 个 $0.007 起，并有 100 次免费请求可以起步，无需绑卡。

#常见问题