2026 年 Twitter（X）API 速率限制

#2026 年 X API 各接口的速率限制

X API v2 的每个接口都有自己的限制，按应用和按用户分别计数，大多数每 15 分钟重置一次。下面的数字是 X 在 2026 年 11 月 2 日公布的；除了限制之外，每次调用还要花多少钱，见我们的 X API 价格详解。

读取类接口每个窗口允许几百到几千次请求，写入类接口按用户限额，另有少数接口还叠加了 24 小时限制或每秒一次的限制。

• 近期搜索，最近 7 天（100）

  每个应用

  450 / 15 分钟

  每个用户

  300 / 15 分钟

• 全量归档搜索，可回溯到 2006 年（500）

  每个应用

  300 / 15 分钟，且 1 / 秒

  每个用户

  1 / 秒

• 按 ID 查帖子（100）

  每个应用

  3,500 / 15 分钟

  每个用户

  5,000 / 15 分钟

• 单个账号的帖子（100）

  每个应用

  1 万 / 15 分钟

  每个用户

  900 / 15 分钟

• 单个账号的提及（100）

  每个应用

  450 / 15 分钟

  每个用户

  300 / 15 分钟

• 按 ID 或用户名查用户资料（100）

  每个应用

  300 / 15 分钟

  每个用户

  900 / 15 分钟

• 粉丝或关注列表（1,000）

  每个应用

  300 / 15 分钟

  每个用户

  300 / 15 分钟

• 谁点赞、转发或引用了某条帖子

  每个应用

  75 / 15 分钟

  每个用户

  75 / 15 分钟

• 发布帖子或回复

  每个应用

  1 万 / 24 小时

  每个用户

  100 / 15 分钟

• 删除帖子

  每个应用

  无

  每个用户

  50 / 15 分钟

• 发送私信

  每个应用

  1,440 / 24 小时

  每个用户

  15 / 15 分钟，且 1,440 / 24 小时

“每个应用”指所有用你应用的 Bearer 令牌签名的请求，共用一个计数器。“每个用户”指每个通过 OAuth 授权了你应用的用户都有自己的计数器，所以同一个接口可以出现两个数字，比如近期搜索的 450 和 300。“X API 速率限制”和“Twitter API 速率限制”是同一回事：X 只是给产品改了名，这里的限制针对 X API v2，也就是它的速率限制参考文档所涵盖的版本。

这张表是带日期的节选。X 在它的速率限制参考文档（在新标签页打开）中保存着完整清单，涵盖 100 多个接口，从列表、Space 到媒体上传，开发者控制台则会显示你自己应用的限制。

须知

X 的参考文档仍列着关注、点赞和引用发帖的限制，但 X 已于 2026 年 4 月 20 日把这些写操作从所有自助套餐中移除（在新标签页打开）。在按量付费下，不管窗口怎么写，这些调用都会失败。

#在这些限制下，一个读取任务要多久

在一个应用上全速运行时，X 的窗口允许你每小时通过全量归档搜索读取约 60 万条帖子，按 ID 读取 140 万条，或读取 120 万个粉丝。不过按量付费会在每月读取 300 万条帖子时停止，而且每一条都要计费。

每个小时的数字，都是每个应用的窗口数乘以一次请求最多返回的结果数，一小时四个窗口：300 次全量归档搜索，每次 500 条帖子；3,500 次查询，每次 100 条帖子；300 页粉丝，每页 1,000 个。近期搜索是 450 次请求、每次 100 条帖子，每小时可达 18 万条帖子，但只覆盖最近 7 天。

每月上限把这些每小时的数字变成了一次短暂的突发。全速运行时，按 ID 查询约 2 小时就能读到 300 万条帖子，全量归档搜索约 5 小时，而 300 万条帖子按 X 每条 $0.005 的价格要花 $15,000。从 2026 年 11 月 22 日起，X 还会按每个用户 $0.010 的费率（在新标签页打开），对你连同帖子一起请求的每个作者资料计费。

Sorsa API 是一款 Twitter（X）API 与爬虫，只有一个限制：所有套餐每个 API 密钥每秒 20 次请求。在这个限制下，同样的任务比一个官方 X API 应用快 2.4 到 60 倍：

• 搜索帖子

  Sorsa API，每小时

  约 144 万条，可回溯到 2006 年

  官方 X API，每小时（一个应用）

  全量归档 60 万条，近期搜索 18 万条

• 按 ID 查帖子

  Sorsa API，每小时

  720 万条

  官方 X API，每小时（一个应用）

  140 万条

• 用户资料

  Sorsa API，每小时

  720 万份

  官方 X API，每小时（一个应用）

  12 万份

• 粉丝

  Sorsa API，每小时

  1440 万个

  官方 X API，每小时（一个应用）

  120 万个

价格上的差距比速度上的差距更大。推文在 Sorsa API 上每 1,000 条 $0.014 起，而官方 X API 是 $5.00；粉丝每 1,000 个 $0.007 起，而官方是 $10.00；失败的请求不计费。

#以每秒 20 次请求读取 X 数据

要读取 X 数据又不受 15 分钟窗口限制，可以用 Sorsa API：ApiKey 请求头里放一个 API 密钥，不需要 X 开发者账号或 OAuth，所有接口共用每秒 20 次请求的同一个限制。

1. 获取密钥。 注册后，在控制台复制你的 API 密钥。前 100 次请求免费，最多可读取 1 万条推文。

2. 一次请求读取 100 条推文。 向 POST /tweet-info-bulk（在新标签页打开） 发送最多 100 个推文链接或 ID。每条推文都带着作者的完整资料，整批只算一次请求。

   curl -X POST \
     "https://api.sorsa.io/v3/tweet-info-bulk" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"tweet_links": ["1854021938471002113"]}'
   

   {
     "tweets": [
       {
         "id": "1854021938471002113",
         "full_text": "Weekly digest is out: 48 links, 3 charts.",
         "created_at": "2026-10-30T09:12:44Z",
         "lang": "en",
         "likes_count": 96,
         "retweet_count": 14,
         "reply_count": 9,
         "view_count": 8840,
         "user": {
           "id": "1590087714360229888",
           "username": "ratelimit_lab_demo",
           "display_name": "Rate Limit Lab",
           "followers_count": 2310
         }
       }
     ]
   }
   

   显示完整响应

3. 让大任务按每秒 20 次的节奏运行。 这个函数每轮发送 20 批，每秒一轮，所以一百万个 ID 的列表能以满额的限制跑完，不必等待任何窗口。

   import time
   from concurrent.futures import ThreadPoolExecutor
   
   import requests
   
   URL = "https://api.sorsa.io/v3/tweet-info-bulk"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   RATE = 20  # requests per second, per API key
   
   
   def fetch(batch):
       for _ in range(5):
           r = requests.post(URL, headers=HEADERS,
                             json={"tweet_links": batch}, timeout=30)
           if r.status_code == 429:  # over 20 in this second
               time.sleep(1)
               continue
           r.raise_for_status()
           return r.json()["tweets"]
       raise RuntimeError("still 429 after 5 tries")
   
   
   def read_tweets(ids):
       batches = [ids[i:i + 100] for i in range(0, len(ids), 100)]
       tweets = []
       with ThreadPoolExecutor(max_workers=RATE) as pool:
           for i in range(0, len(batches), RATE):
               started = time.monotonic()
               for page in pool.map(fetch, batches[i:i + RATE]):
                   tweets += page
               time.sleep(max(0, 1 - (time.monotonic() - started)))
       return tweets
   

4. 为任务选合适的接口。 同一个限制覆盖所有接口，所以变化的只是每次请求返回的结果数。

• POST /search-tweets（在新标签页打开） 支持 X 的搜索运算符，可回溯到 2006 年，每页约 20 条推文，并带 next_cursor 用于获取下一页。
• GET /followers（在新标签页打开） 每页最多返回 200 个粉丝。
• GET /info-batch（在新标签页打开） 按用户名或用户 ID 最多返回 100 份用户资料。

这个限制每秒重置一次，而不是每 15 分钟，而且 Sorsa API 不发送速率限制响应头，因为没有需要跟踪的窗口。429 表示一秒内超过了 20 次请求：等一秒再重发即可，详见速率限制文档（在新标签页打开）。401 或 403 表示密钥有误、缺失或额度已用完。Sorsa API 与读取 X 数据的所有其他方式相比如何，见我们的 Twitter API 替代方案指南。

#X API 的窗口、响应头和 429 是怎么运作的

X API 的窗口是按接口计数的计数器，从你的第一次请求开始计时：每次调用消耗一次额度，降到零后，X 会返回 429 Too Many Requests，直到窗口重新填满。

每个响应都用三个响应头告诉你计数器的当前状态：

x-rate-limit-limit: 450
x-rate-limit-remaining: 0
x-rate-limit-reset: 1793606400

x-rate-limit-limit 是窗口的大小，x-rate-limit-remaining 是剩余次数。x-rate-limit-reset 是窗口重新填满的时刻，用 Unix 秒数表示，而不是倒计时。每个响应都要读一下：剩余次数为 0 的响应，已经告诉你下一次调用会失败。

超出限制时，X 返回 429 和错误码 88，信息是 "Rate limit exceeded"（速率限制已超出）。等到重置时间才是解决办法；更早重试只会收到更多 429。具体的修复步骤、重试代码，以及 X 应用里的“rate limit exceeded”提示，见我们的 Twitter 速率限制已超出指南。

即使一个任务始终没超过任何窗口，也仍可能中途停下，因为官方 X API 有三层限制，每一层都以自己的方式终止任务。

• 接口窗口会自动重置，周期为 15 分钟或 24 小时，全量归档搜索还会拒绝同一秒内的第二次请求。
• 每月上限和你的额度不会随时间重置：按量付费在每个计费周期读取 300 万条帖子时停止，而一旦你的额度余额或你设置的消费上限（在新标签页打开）用完，请求就会被拦下。
• 账号上限属于 X 账号，而不是应用：它们把 X 应用、网页和 API 发出的帖子、回复、关注和私信合并计数。

#X 的发帖限制：每 15 分钟和每天

通过官方 X API 发帖要受两重限制：接口限制是每个用户每 15 分钟 100 条帖子，每个应用每天 1 万条；还有 X 账号的限制。未认证账号无论用什么方式发帖，每天最多只能发布 50 条原创帖子和 200 条回复。

账号上限先起作用。按每 15 分钟 100 条，接口允许一个用户每天发 9,600 条帖子，但未认证账号在 50 条就停了。

• 原创帖子

  官方 X API 限制

  每个用户 100 / 15 分钟，每个应用 1 万 / 24 小时

  X 账号限制（所有应用合计）

  未认证账号每天 50 条

• 回复

  官方 X API 限制

  与发帖是同一个接口

  X 账号限制（所有应用合计）

  未认证账号每天 200 条

• 删除帖子

  官方 X API 限制

  每个用户 50 / 15 分钟

  X 账号限制（所有应用合计）

  未公布

• 转发

  官方 X API 限制

  每个用户 50 / 15 分钟

  X 账号限制（所有应用合计）

  未公布

• 私信

  官方 X API 限制

  每个用户 15 / 15 分钟，且 1,440 / 24 小时

  X 账号限制（所有应用合计）

  每天 500 条

• 关注

  官方 X API 限制

  2026 年 4 月 20 日起从自助套餐中移除

  X 账号限制（所有应用合计）

  每天 400 个

• 点赞或引用发帖

  官方 X API 限制

  2026 年 4 月 20 日起从自助套餐中移除

  X 账号限制（所有应用合计）

  未公布

X 的限制页面（在新标签页打开）写明，账号上限统计的是“from all devices, including web, mobile, phone, API”（来自所有设备，包括网页、移动端、手机和 API）的操作，所以脚本和人在应用里手动发帖，用的是同一个 50 条的额度。X 还把每日发帖上限拆成未公布的半小时限制，而且账号关注了 5,000 人之后，继续关注还要看账号的粉丝比例。

50 条的上限是最近才出现的。X 在 2026 年 5 月把它从每天 2,400 条更新削减下来，正如 PCMag 所报道的（在新标签页打开），而同一个帮助页面的另一段至今仍写着 2,400。X 没有公布已认证账号的每日数字。在按量付费下，每条帖子还要花钱：每条 $0.015，带链接的帖子 $0.20。

Sorsa API 从产品设计上就是只读：它从不发帖、点赞、关注或发送消息，也从不要求你的 X 登录信息或 cookie，所以你的 X 账号不会因它有任何风险。要发布内容，可以把它与官方 X API 搭配使用，而读取工作，比如确认某条帖子已发出，或收集它的回复和提及，仍交给 Sorsa API。

#免费版与 Enterprise 的速率限制

2026 年官方 X API 没有免费额度，所以也没有免费的速率限制。它仅限发帖的 Free 套餐，最后的上限是每 24 小时 17 条帖子（在新标签页打开），在 2026 年 2 月 6 日按量付费成为默认方式时对新开发者关闭。它历年允许的内容，见我们对 Twitter API 免费吗的解答。

付费的 Basic 和 Pro 套餐也走了同样的路：X 在 2026 年 6 月 1 日之后把 Basic 订阅用户转为按量付费，9 月 1 日之后转换 Pro 订阅用户。论坛里引用 Basic 每天 100 条帖子的回答，描述的是如今没人能买到的套餐。现在所有按量付费用户共用第一张表里的窗口。

要改变这些窗口，只有 Enterprise 一条路。Enterprise 合同通过协议设定定制的速率限制，并取消 300 万条帖子的读取上限；X 通过意向表单出售它们，不公布价格，而 2023 年 X 推出 Enterprise 接入时，有报道称合同每月 $42,000 起（在新标签页打开）。

#围绕一个限制来规划 X 数据任务

X API 的速率限制按接口分别设定，多数以 15 分钟为窗口，再叠加每月 300 万条帖子的读取上限和账号的每日上限，所以大任务必须同时满足三层限制。要大规模读取 X 数据，可以用 Sorsa API：每个密钥只有一个每秒 20 次请求的限制，每次请求最多 100 条推文或 200 个粉丝，推文每 1,000 条 $0.014 起。先用 100 次免费请求开始，足够读取你的前 1 万条推文。

#常见问题