Python – Tweepy 中的 API.friends()

API.friends() 是 Tweepy 模块中的一个方法，用来获取指定 Twitter 用户关注的其他用户列表。

使用方式

API.friends() 方法需要指定一个 user_id 或者 screen_name 参数。其中，user_id 是 Twitter 用户的唯一数字 ID，而 screen_name 是用户的显示名称。

例如，我们要获取 @Twitter 用户的关注列表，可以这样写：

import tweepy

auth = tweepy.OAuthHandler('consumer_key', 'consumer_secret')
auth.set_access_token('access_token', 'access_token_secret')

api = tweepy.API(auth)
twitter_user = 'Twitter'

# 通过 screen_name 获取用户对象
user = api.get_user(twitter_user)

# 获取用户的关注列表
user_friends = api.friends(user.id_str)

以上代码中，我们首先创建了 tweepy 的认证对象 auth，然后通过 auth 来创建 API 对象 api，以便后续调用 Twitter API。然后我们指定一个 twitter_user，也就是我们要获取他的关注列表的用户。通过 api.get_user() 方法获取用户对象，然后将用户的 id_str 作为参数调用 API.friends() 方法来获取关注列表。

返回值

API.friends() 方法会返回一个包含 User 对象的列表。每个 User 对象包含了 Twitter 用户的各种信息，例如用户 ID、用户名、用户昵称、用户个人资料、关注数、粉丝数等等。

下面是一个简单的例子，遍历并输出 User 对象中的一些信息：

for friend in user_friends:
    print(friend.screen_name)
    print(friend.description)
    print(friend.followers_count)
    print(friend.friends_count)
    print(friend.statuses_count)
    print('-------------------------')

上面的代码会遍历我们获取到的用户列表，对于每个用户输出其用户名、个人描述、粉丝数、关注数以及发推数等信息。

注意事项

调用 API.friends() 方法时需要注意以下几点：

• 每次调用此方法最多返回 200 个用户对象；
• 通过 User 对象可以获取用户的更多信息，例如用户的推文、喜欢的推文、列表、收藏夹等等；
• 当然，在使用此方法时，也需要注意 Twitter API 的调用频率限制，具体限制请参考 Twitter 开发者文档。