Twitter Standard API rate limits 推特标准接口API的请求频率限制说明

快来打我* 2021-09-23 01:16 701阅读 0赞

# 一、官方文档对速率限制概述 #

官方文档地址：[https://developer.twitter.com/en/docs/basics/rate-limits][https_developer.twitter.com_en_docs_basics_rate-limits]

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70][]

根据官方文档说明可见：

此限制仅针对于standard API（标准接口）有效。对于Standard API，无论是post还是get对应的方法接口，均分为user auth和app auth两种频率限制。根据我对[官方文档OAuth的部分说明][OAuth]的理解，使用“ OAuth 1”认证获取到的token对应的为“user auth”，使用“OAuth2”认证的token对应的为“app auth”。另外，使用user auth需要指明consumer\_key、consumer\_secret、access\_token\_key、access\_token\_secret四个参数，而app auth只需要指明consumer\_key、consumer\_secret两个参数。

以python使用的TwitterAPI包为例说明（pip install TwitterAPI）：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 1][]

由上图源码可见两种请求方法分别对应需要的参数，另外，使用OAuth2（app auth）需要在调用时指明auth\_type参数为“OAUth2”。

# 二、不同的“接口”速率之间的关系 #

在[Rate Limiting][] HTTP Headers and Response Codes部分，我们可见有三个参数可以查看我们当前请求过程所在的“一轮请求计数”**总共的次数、剩余的次数、下次重新计数的时间戳**。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 2][]

以“GET followers/ids”接口为例，文档显示15分钟为一个计数循环，15分钟内单个用户（不同用户请求没有测试）使用“user auth”最多请求15次该接口。计数从每一轮循环的第一次发出请求开始计算本轮循环的15分钟，对应x-rate-limint-reset参数，即为本轮首次发出请求时的时间戳+15\*60对应的数字。x-rate-limit-limit对于此接口来说为15（不变的固定值），一轮循环中加入已经请求了N次，则对应的x-rate-limit-remaining为15-N次。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 3][]

我们使用debug模式请求某个端口，在返回结果的headers中可以对应找到这三个参数。我们用run 的方式使用同一个token请求其他端口，在此过程中继续debug之前的端口，可见，运行不同端口之间的请求不会互相干扰“x-rate-limit-remaining”的值。即，我们可以使用同一个token同时对不同的端口发出请求，程序设计中分别计算请求间隔应该设置的时间等待，防止出现请求频率过高导致的频率限制（对应status\_code为420、429）。或者，我们可以在请求中通过剩余可用请求判断，若可用请求为1（或者0），进行时间等待至“当前时间时间戳==x-rate-limit-reset”。

部分代码示例：

# 若本次循环（15分钟的API请求循环），没有剩余可用的次数，则等待到下次循环  ***************
                elif results.status_code == 200:
                    if int(results.headers['x-rate-limit-remaining']) == 0:
                        sleep_time = int(results.headers['x-rate-limit-reset']) - time.time()
                        time.sleep(sleep_time)
                    else:
                        pass

# 三、同一个用户授权多个APP对访问速率的影响 #

还是刚才的链接地址：[GET and POST Request Limits][Rate Limiting]，具体可参见下图。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 4][]根据红框中的内容可见：

此限制仅针对user auth，如果一个用户——用户X，授权了APPa及APPb，分别生成了TokenA、TokenB，如果使用TokenA请求了某个端口（例如GET followers/ids）n次，那么在本轮循环计数结束前使用TokenA与TokenB请求该端口的剩余次数之和为“15-n”。

[https_developer.twitter.com_en_docs_basics_rate-limits]: https://developer.twitter.com/en/docs/basics/rate-limits
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70]: /images/20210920/23143c90395642e9adc692e016b94dd4.png
[OAuth]: https://developer.twitter.com/en/docs/basics/authentication/overview/oauth
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 1]: /images/20210920/f66c60f2aa4b407285781a668c3f69f7.png
[Rate Limiting]: https://developer.twitter.com/en/docs/basics/rate-limiting
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 2]: /images/20210920/066558a2a8b64b098c588cfb00d18b86.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 3]: /images/20210920/6838eddd95b246a3a5f724d3024b3461.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3FxXzI3Mzc4NjIx_size_16_color_FFFFFF_t_70 4]: /images/20210920/1a47d9451d9e425591e7503547bfb933.png