每天都有成千上万的开发者向Twitter的API提出请求。为了帮助管理这些请求的庞大数量,对可以提出的请求的数量进行了限制。这些限制有助于我们提供可靠和可扩展的API,而这正是我们的开发者社区所依赖的。
允许的最大请求数是基于一个时间间隔,一些指定的时期或时间窗口。最常见的请求限制时间间隔是15分钟。如果一个端点的速率限制是900个请求/15分钟,那么在任何15分钟的间隔内最多允许900个请求。
速率限制是根据你所使用的认证方法而应用的。例如,如果你使用的是OAuth 1.0a User Context,你将对每组用户的访问令牌在每个时间段有一个限制,而如果你使用的是OAuth 2.0 Bearer Token,你将对你的应用程序的请求在每个时间段有一个单独的限制。当超过这些限制时,会返回一个错误。继续阅读以了解更多关于这些细节和如何避免被限制速率的提示。
下表列出了Twitter API v2的速率限制。这些速率限制也记录在每个端点的API参考页面上,也显示在开发者门户的产品部分。
| Resource | Endpoint | Requests per 15-minute window unless otherwise stated | |
| Per App | Per user | ||
| Tweets | Tweet lookup | 300 | 900 |
Manage Tweets – Post a Tweet |
200 50 |
||
| Timelines – User Tweet timeline – User mention timeline – Reverse chronological home timeline |
|
900 180 180 |
|
| Search Tweets – Recent search – Full-archive search |
450 300 Full-archive also has a 1 request / 1 second limit |
180 |
|
| Tweet counts – Recent Tweet counts – Full-archive Tweet counts |
300 300 |
||
| Filtered stream – Connecting – Adding/deleting filters – Listing filters |
50 Essential access – 25 Elevated access – 50 Academic Research access – 100 Enterprise access – 450 450 |
||
Volume streams – Sampled stream |
50 |
||
| Retweets lookup | 75 | 75 | |
| Quote Tweets lookup | 75 | 75 | |
| Manage Retweets ** – Retweet a Tweet – Undo a Retweet |
50 50 |
||
| Bookmarks lookup | 180 | ||
| Manage Bookmarks – Bookmark a Tweet – Undo a Bookmarks |
50 50 |
||
| Likes lookup – Tweets liked by a user – Users who have liked a Tweet |
75 75 |
75 75 |
|
| Manage Tweets ** – Create a Tweet – Delete a Tweet a Tweet |
200 50 |
||
| Manage Likes ** – Like a Tweet – Unlike a Tweet |
50 50 |
||
| Hide replies | 50 | ||
| Users | User lookup – Authenticated user lookup |
300 |
900 75 |
| Follows lookup | 15 | 15 | |
| Manage follows ** – Follow a user – Unfollow a user |
50 50 |
||
| Blocks lookup | 15 | ||
| Manage blocks – Block a user – Unblock a user |
50 50 |
||
| Mutes lookup | 15 | ||
| Manage mutes – Mute a user – Unmute a user |
50 50 |
||
| Lists | Manage Lists – Create a List – Delete a List – Update a List |
300 300 300 |
|
| List lookup – Get List by ID – Get user-owned Lists |
75 15 |
75 15 |
|
| List Tweets lookup | 900 | 900 | |
| List members – Add a member – Remove a member – Get List members – Get user’s List memberships |
900 75 |
300 300 900 75 |
|
| List follows – Follow a List – Unfollow a List – Get List followers – Get user’s followed Lists |
180 15 |
50 50 180 15 |
|
| Manage pinned Lists – Pin a List – Unpin a List – Get user’s pinned Lists |
50 50 15 |
||
| Spaces | Spaces lookup | 300 | |
| Search Spaces | 300 | ||
| Compliance | Batch compliance – Create a job – Get jobs – Get job by ID |
150 150 150 |
|
推文上限
推文上限取决于您的访问级别:
| Essential access | 500k Tweets per month, 50 Tweets/second |
| Elevated access | 2 million Tweets per month, 50 Tweets/second |
| Elevated+ access | More details coming soon. Sign up for our waitlist |
| Academic Research access | 10 million Tweets per month, 250 Tweets/second |
| Enterprise access | 10+ million Tweets per month, Tweets/second set at access level |
你可以通过查看开发者门户中的主仪表板页面来检查你对每月Tweet上限的使用。在你的项目名称下,你会看到一个状态栏,说明你当前月的使用量与推特上限的关系。你还会看到你这个月的推特数量,与上限有关的推特使用百分比,以及你的推特使用上限重置的日期。