限流
我们如何限流
限流按账号计算，单位为每秒请求数 (QPS)。上限只取决于你是否购买过积分，另外最高两个订阅层级会有小幅提升。
没有月度上限，也没有日上限 — 只要不超过每秒上限，一个月内可以消耗任意数量的积分。
推送 (账号监控 Stream) 订阅和 REST API 是分开的。 推送套餐不包含 API 积分，也不会提高 REST 接口的限流：REST 调用按积分计费，在购买积分之前，账户仍按免费用户限制，每 5 秒 1 次请求。
具体限额
| 账号状态 | 限流 |
|---|---|
新账号 (从未付费) 0.2 次/秒 — 足够试用 API，鼓励首次充值。 | 每 5 秒 1 次请求 |
任何至少购买过一次积分的账号 一次性充值一次积分即可，无需订阅。 | 20 次/秒 |
Starter · Builder · Pro 订阅 这些套餐的差异在于积分、赠送比例和积分返还，而不是吞吐量。需要更稳定的 QPS？见下方 Scale 和 Business。 | 20 次/秒 |
Scale 订阅 | 50 次/秒 |
Business 订阅 | 500 次/秒 |
更大需求 发送邮件至 contact@twitterapi.io，说明用途和预计持续 req/s。 | 可申请 |
选套餐？ 请参见 /subscribe — Starter、Builder、Pro 的差异在于赠送积分、充值赠送比例和滚动积分返还。如果需要持续高于 20 次/秒 的吞吐量，Scale (50 次/秒) 和 Business (500 次/秒) 才是上限提升的层级。
有突发流量？ 超过上限会返回 HTTP 429 (不发送 Retry-After 响应头)。等待约 1 秒后用指数退避重试即可 — 我们不会封账号。