作者：Sorsa 编辑部
更新于：2026 年 7 月 8 日。加入了每 1,000 数据单位费率和 100 次免费请求的起步优惠。对照 2026 年 4 月 20 日变更后 X 的按量付费定价做了刷新，并确认了 2024 年 6 月点赞隐私限制对可取回数据的影响。
要点： Twitter/X API 暴露公开资料数据、带点赞、转推、回复和浏览等互动指标的完整推文内容、关键词和提及搜索、粉丝和关注列表、音频 Space 细节，以及列表和社区成员身份。它还核验一个账号是否关注、转推或回复过。发帖需要单独的写访问。
你能取回什么、以及每次调用花多少，取决于你用哪个 API。官方 X API 按资源计费，所以响应里每个资料、推文或粉丝都是一个单独收费，自 2026 年 2 月起没有免费额度。Sorsa API 是一个面向公开数据、工作方式不同的替代性 Twitter/X API。计费按请求，所以一次调用算作一次请求、不管返回多少项，跨 40 个只读接口。一次 /followers 调用为一次请求返回最多 200 份资料，/tweet-info-bulk 也为一次请求返回最多 100 条含作者数据的完整推文。认证是请求头里一个单个 API 密钥，没有 OAuth 流程也没有应用审查。在批量接口上，数据折合每 1,000 条推文从 $0.02 起、每 1,000 份资料从 $0.01 起，一个一次性的 100 次免费请求额度、无需绑卡且永不过期，在任何套餐开始之前打开全部 40 个接口。下面各节编目每一类可用的公开数据以及每一类返回的确切字段。
本页内容
- 你能从 Twitter/X API 获取什么数据？
- 资料和账号数据
- 推文内容和互动指标
- 搜索和历史数据
- 音频 Spaces 数据
- 列表和社区
- 核验用户动作
- 账号标识符实用工具
- 你无法从 Twitter/X API 获取什么
- 你能通过 API 发帖或写入吗？
- 访问这些数据要花多少钱
- 开始上手
- 常见问题
你能从 Twitter/X API 获取什么数据？ {#what-data-can-you-get-from-the-twitterx-api}
Twitter/X API 覆盖七种核心数据类型：用户资料及其粉丝图、单条推文及其互动指标、关键词和提及搜索、音频 Spaces。还有列表和社区、像关注和转推这样的用户动作核验，以及标识符转换实用工具。这多数是公开读取数据；发帖和私信是单独的写能力。
实际上，那拆分成七个可取回类别：
- 资料和粉丝图： 显示名、简介、位置、公开计数和认证状态，加粉丝、关注和已认证粉丝列表。
- 推文和互动： 完整文本、语言、时间戳，和点赞、转推、回复、引用、浏览、收藏计数，媒体和链接作为结构化实体返回。
- 搜索： 带高级操作符的关键词、短语、作者和日期搜索、提及追踪，并回溯到 2006 年存档的账号搜索。
- 音频 Spaces： 标题、状态、创建者、管理员/发言者/听众的拆分，和实时听众与回放统计。
- 列表和社区： 列表的成员、订阅者和帖子信息流，和社区的成员、信息流与限定范围搜索。
- 动作核验： 一个账号是否关注、回复、引用、转发或加入一个社区的布尔检查。
- 标识符实用工具： 用户名、数字 ID 和资料链接之间的转换。
我们运行的 API 上每个接口都用 ApiKey 请求头里一个密钥认证。一次资料查找和一次批量推文拉取看起来像这样：
curl -H "ApiKey: YOUR_API_KEY" \
"https://api.sorsa.io/v3/info?username=elonmusk"
curl -X POST "https://api.sorsa.io/v3/tweet-info-bulk" \
-H "ApiKey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tweet_links": ["1782368585664626774", "https://x.com/user/status/123"]}'
资料和账号数据 {#profile-and-account-data}
来自 Twitter/X API 的资料数据包括一个账号的显示名、用户名、简介、位置、资料图和横幅图、账号创建日期和认证状态，连同账号是否受保护。资料还包括公开计数：粉丝、关注、总帖子、给出的点赞和媒体。粉丝和关注列表作为完整资料的分页集可用。
这些是受众和竞品研究最常请求的字段。一次 /info 调用返回完整资料，包括 followers_count、followings_count、tweets_count、favourites_count、media_count、verified、protected、ISO 8601 格式的 created_at、location、简介里找到的任何 URL，和置顶推文的 ID。对粉丝图，/followers 和 /follows 每次请求返回最多 200 份资料，而 /verified-followers 把列表收窄到仅已认证账号。如何拉取粉丝和关注列表覆盖分页和按请求的经济性。
有一个字段容易被忽略：账号的国家。/about 接口恰好返回三个值：与账号关联的国家、用户名更改的总次数，和最近一次更改的日期。那个国家字段就是驱动一次账号所在地检查的东西。
推文内容和互动指标 {#tweet-content-and-engagement-metrics}
对任何公开帖子，Twitter/X API 返回完整文本、语言、时间戳，和所属的对话，连同互动指标：点赞、转推、回复、引用、浏览和收藏。附带的媒体和链接作为结构化实体回来。对回复、引用和转发，原帖及其作者嵌在响应里。
浏览计数自 2022 年 12 月起在帖子上可用，作为 view_count 在 likes_count、retweet_count、reply_count、quote_count 和 bookmark_count 旁返回。一次 /tweet-info 调用返回一条帖子；/tweet-info-bulk 接受最多 100 个帖子 ID、并在单次请求里把它们全部返回，那是一次可计费调用和一百次之别。要拉一条时间线，/user-tweets 逐页返回一个用户的帖子，而 /comments、/quotes 和 /retweeters 返回一条给定帖子之下的回复、引用帖和转发账号。通过 API 处理回复、引用和转推者更深入这些接口每一个。
有一个你无法取回的互动信号：点赞一条帖子的账号列表。X 于 2024 年 6 月 12 日把点赞设为私密，所以只有点赞计数被暴露、而非背后的身份。你仍能拿到转推、引用或回复的账号。
长文帖子也可用。拉取 X Articles 的完整文本返回文章正文、封面图和指标，而按地点的热门话题返回一个给定区域的当前趋势。
搜索和历史数据 {#search-and-historical-data}
Twitter/X API 能用高级搜索操作符按关键词、短语、话题标签、作者和日期搜索公开帖子、返回提及一个特定用户名的帖子，并按关键词搜索账号。搜索回溯到 2006 年的完整公开存档、而不只是近期帖子，所以历史研究可能。
搜索是操作符语法要紧之处。/search-tweets 接受与 Twitter 搜索相同的高级操作符，包括 from:、to:、since:、until:、引号里的精确短语和话题标签，并按 popular 或 latest 排序每页返回约 20 条帖子。推文搜索 API 的高级搜索操作符参考走一遍查询构造。
对品牌和声誉工作，/mentions 返回提及一个用户名的帖子、并提供任何搜索接口里最丰富的过滤集：最低点赞、回复和转推，加 since_date 和 until_date 界限。大规模追踪提及覆盖那些过滤。当你需要多年前、而非本周的帖子时，搜索较旧的推文存档解释按日期界定的查询如何检索到平台最早的帖子。
音频 Spaces 数据 {#audio-spaces-data}
Twitter/X API 返回关于音频 Spaces 的数据：标题、当前状态、排定的开始时间、创建者的完整资料，和按角色作为管理员、发言者和听众的参与者拆分。还暴露访问设置和实时统计，包括总听众和峰值听众及回放浏览。
一次 /spaces 调用接受一个 Space ID 或链接、并返回完整对象。不像多数接口，Space 时间戳是 Unix 整数、而非 ISO 8601 字符串，一个当你解析 created_at、scheduled_start 和参与者加入时间时值得显式处理的细节。参与者拆分对发现哪些账号主持或发言、对比只是收听有用。
列表和社区 {#lists-and-communities}
Twitter/X API 暴露 Twitter/X 列表和社区。对一个列表，你能取回它的成员资料、订阅者，和一条来自其成员的帖子信息流。对一个社区，你能取回它的成员、帖子信息流，并跑一次仅限定到那个社区的关键词搜索。
列表是追踪一组固定账号的一个干净方式。/list-members 返回一个列表里的资料，/list-followers 返回订阅它的账号，/list-tweets 返回来自其成员的一条合并帖子信息流。社区通过 /community-members、/community-tweets 和 /community-search-tweets 以同样的方式工作，最后一个把一次关键词搜索限于单个社区。从列表和社区提取成员、帖子和粉丝在一处覆盖两者。
核验用户动作 {#verifying-user-actions}
在原始数据之外，Twitter/X API 能核验特定的用户动作：一个账号是否关注另一个、一个用户是否回复了一条给定帖子。它还能确认他们是否引用或转发了那条帖子，以及是否属于一个特定社区。每个检查返回一个布尔结果，这是抽奖和活动核验所依赖的。
这些检查是抽奖和活动审计的支柱。/check-follow 确认一个账号是否关注另一个，/check-comment 确认一条特定帖子之下的一条回复，/check-quoted 和 /check-retweet 确认引用和转发，/check-community-member 则确认成员身份。双向关注检查需要两次调用、每个方向一次，因为单个检查是单向的。为活动核验关注、回复、引用和转发覆盖完整工作流。
账号标识符实用工具 {#account-identifier-utilities}
Twitter/X API 还处理标识符转换。你能把一个用户名转成永久数字用户 ID、把一个数字 ID 转回当前用户名，并从一个资料 URL 提取一个用户 ID。因为用户名能变、但数字 ID 从不变，存 ID 是随时间追踪一个账号的可靠方式。
用户名会变；注册时分配的数字 ID 不会。/username-to-id 和 /id-to-username 在两者之间转换，/link-to-id 则直接从一个资料 URL 拉 ID。在用户名、用户 ID 和资料链接之间转换解释为什么基于 ID 的存储熬过用户名变更。一个单独的 /key-usage-info 调用报告你密钥上剩多少请求。
你无法从 Twitter/X API 获取什么 {#what-you-cannot-get-from-the-twitterx-api}
有些数据不论哪个 API 都不可及。你无法读其他用户的私信、取回你不关注的受保护账号的内容，或恢复删除的帖子。你无法拿到点赞一条帖子的账号列表，因为 X 在 2024 年 6 月把点赞设为私密。只读 API 还额外无法发帖、回复、关注或发消息。
知道边界省下浪费的调用。私密和受保护账号只返回一个登出查看者会看到的，删除的帖子从索引里消失，其他用户之间的私信也从不被暴露。点赞限制最常绊倒互动审计：你拿到一条帖子上的点赞计数、但拿不到背后的账号，所以受众分析改倚重粉丝、回复者、引用者和转发者。只读局限是一个深思熟虑的设计选择，在下一节讨论。
你能通过 API 发帖或写入吗？ {#can-you-post-or-write-through-the-api}
官方 X API 支持写动作：发帖、回复和发私信，全都按请求计费。截至 2026 年 4 月 20 日，关注、点赞和引用帖写入移到仅 Enterprise 访问。只读第三方 API 根本不写；这类 API 取回公开数据、别无其他，移除了对已连接账号的任何写权限风险。
你是否需要写入是选一个 API 的第一个分岔。如果目标是发布或自动化，官方 X API 是那条路：发一条朴素消息每次请求花 $0.015、一条含 URL 的帖子花 $0.20。如果目标是大规模读取公开数据，写能力是死重，一个像我们运行的只读 API 有意把它换掉：不发帖意味着没有 OAuth 写作用域、没有应用权限审查，也没有一个令牌对一个账号做一件意外之事的风险。对权衡搬移的团队，迁离官方 X API把读取接口映射过去。
访问这些数据要花多少钱 {#what-it-costs-to-access-this-data}
Twitter/X 数据的成本取决于计费模型、而不只是量。官方 X API 按资源收费：每帖读取 $0.005、每份资料读取 $0.010，所以一次返回 20 帖加作者的搜索花约 $0.30。按请求计费的 API 每次调用收一次、不管返回多少项，这对读取密集的工作有利。
对读取密集的访问，一旦量过了大约每月 1 万帖读取，一个按请求计费模型比按资源计费便宜得多。
| 维度 | 官方 X API（按量付费） | Sorsa API |
|---|---|---|
| 计费模型 | 每抓取资源 | 每请求、按请求计费 |
| 1,000 条推文（批量） | $5.00 | Pro 上约 $0.02 |
| 1,000 份资料（批量） | $10.00 | Pro 上约 $0.01 |
| 一条推文响应里的作者资料 | 作为一次单独资料读取计费 | 免费包含 |
| 对公开数据的读访问 | 有 | 有 |
| 写访问（发帖、私信） | 有，关注、点赞和引用帖自 2026 年 4 月起仅 Enterprise | 无，只读 |
| 速率限制 | 每 15 分钟 300 次请求、随接口而变 | 每个套餐每秒 20 次请求 |
| 认证 | 带一个 Bearer 令牌的 OAuth 2.0 | 请求头里单个 API 密钥 |
| 批量请求 | 有限 | 每次调用最多 100 条推文或 100 份资料 |
| 每月上限 | 200 万帖读取 | 基于套餐、10,000 到 500,000 次请求 |
如果你需要发帖、跑过滤流式，或持有一份企业合规协议，官方 X API 是对的工具。对以固定、可预测价格的公开数据读取密集访问，一个按请求计费的提供方胜出，每数据单位的差距是原因。Sorsa 的定价列出套餐；2026 年 X API 定价的完整拆解详细展示按资源算术。
一个关掉按资源计费的团队
一个大约 10 人的社交分析团队在直接在官方 X API 上构建一个月后找到我们。他们的产品跨几千个被追踪账号拉资料、近期帖子和互动指标。按资源账单（其中每帖读取加每份作者资料单独计算）正攀升过他们的定价能吸收的。把同样的读取工作负载搬到按请求计费的调用后，他们的数据成本削减至多 50 倍。作者数据已经含在每条推文响应里，批量接口还把百项拉取塌缩成单次请求。他们一直在付费的写功能，从没用过。
开始上手 {#getting-started}
把你需要的东西映射到对的接口是给一个项目定范围最快的方式。上面的只读数据通过一个单个 API 密钥上的 40 个接口可用，每个套餐固定的每秒 20 次请求、几分钟搭建、无应用审查。一个一次性的 100 次免费请求额度、无需绑卡且永不过期，在你付费之前打开每个接口供测试。在基于浏览器的 API playground 里测试任意接口、无需写代码，然后在你准备好集成时读接口参考。数据在批量接口上从每 1,000 条推文 $0.02 起、每 1,000 份资料 $0.01 起，套餐从每月 $49 换 1 万次请求到 $899 换 50 万。
常见问题 {#frequently-asked-questions}
你能从 Twitter/X API 拿到浏览和收藏计数吗？
能。Twitter/X API 返回帖子上自 2022 年 12 月起可用的浏览计数、以及收藏计数，在标准的点赞、转推、回复和引用旁。这些作为每个帖子对象上的数字字段回来。唯一不可用的互动信号是点赞一条帖子的账号列表，它在 2024 年 6 月变私密。
你能通过 Twitter/X API 发推文吗？
官方 X API 支持发帖、回复和私信、按请求计费，尽管关注、点赞和引用帖写入在 2026 年 4 月移到仅 Enterprise 访问。只读第三方 API 根本不发帖。如果你的项目只读公开数据，写访问不必要、且添加你能避免的权限风险。
通过一个 API 获取 Twitter/X 数据最便宜的方式是什么？
对读取密集的工作，一旦你过了大约每月 1 万帖读取，一个按请求计费的 API 是最便宜的路。Sorsa 每次调用收一次请求、不管返回多少项，并在推文响应里包含作者资料。这在批量接口上折合每 1,000 条推文从 $0.02 起、每 1,000 份资料从 $0.01 起，对比官方 API 的每帖读取 $0.005、每份资料读取 $0.010。一个一次性的 100 次免费请求额度、无需绑卡，让你在付费前测试每个接口。
Twitter/X API 数据回溯多远？
搜索可检索回溯到 2006 年（Twitter 上线之年）的完整公开存档、而不只是近期帖子。用像 since 和 until 这样操作符的按日期界定查询能针对一个特定历史窗口。实时和历史数据用同样的搜索接口，所以一个查询能横跨近期或较旧帖子。
你需要一个开发者账号来访问 Twitter/X API 数据吗？
官方 X API 在任何数据调用之前要求一个开发者账号、一个已批准应用和一个 OAuth 流程。一个像 Sorsa 的按请求计费提供方移除那个：一个请求头里的单个 API 密钥认证每个接口，无应用审查、几分钟搭建。这样读公开 X 数据不需要平台的开发者计划。
你无法从 Twitter/X API 获取什么数据？
你无法读其他用户的私信、看你不关注的受保护账号的内容、恢复删除的帖子，或取回点赞一条帖子的账号列表。点赞在 2024 年 6 月变私密。互动审计改倚重粉丝、回复者、引用者和转发者、而非点赞者。
审校：Keksich（Sorsa 创始人，X API 研究者）
本指南取材于我们运营 Sorsa 只读 X API 的日常工作及其公开文档，对照 X 发布的 2026 年按量付费定价和 2024 年 6 月点赞隐私变更交叉核对。接口名、响应字段和限制对照实时 API 核验，而定价反映 X 2026 年 4 月 20 日更新后生效的费率。关于这些指南背后团队的更多信息在 Sorsa 关于页上。核验于 2026 年 7 月 8 日。