Python - Tweepy 中的 API.list_members()

在使用 Twitter API 进行开发时，Tweepy 是一个常用的 Python 包。通过 Tweepy 提供的 API，我们可以方便地调用 Twitter API 中的各种功能，实现自己的开发需求。API.list_members() 则是 Tweepy 提供的其中一个功能，它能够帮助我们获取某个 Twitter 列表中的所有用户。

使用方法

首先，我们需要通过 Tweepy 获取到一个 API 对象：

import tweepy

auth = tweepy.OAuthHandler("consumer_key", "consumer_secret")
auth.set_access_token("access_token", "access_token_secret")
api = tweepy.API(auth)

然后，我们可以使用 API.list_members() 来获取列表中的用户。这个函数接受三个参数：

• slug：列表的 slug，即列表的短名称（例如一个列表的链接为 https://twitter.com/user/lists/list_name，则 slug 为 list_name）。
• owner_screen_name：列表所有者的 Twitter 用户名。
• cursor：可选参数，指定结果分页时的游标值。

例如，我们要获取 someone 用户的 mylist 中的所有成员：

members = api.list_members(slug="mylist", owner_screen_name="someone")
for member in members:
    print(member.screen_name)

上面的代码会输出 mylist 中的每个用户的 screen_name。

返回值

API.list_members() 返回一个 Cursor 对象，通过这个对象可以遍历所有的列表成员。每个成员都是一个 User 对象，包含了有关该用户的大量信息，例如：

• id：用户 ID。
• name：用户全名。
• screen_name：用户的屏幕名称。
• location：用户地理位置。
• description：用户的个人简介。
• followers_count：用户的关注者数量。
• friends_count：用户的关注数量。
• created_at：用户的账户创建时间。
• profile_image_url_https：用户的头像 URL。

class User(_User):
    """
    Represents a Twitter user.

    Reference: https://dev.twitter.com/overview/api/users
    """

    def __init__(self, *args, **kwargs):
        super(User, self).__init__(*args, **kwargs)

    def __repr__(self):
        return "<User: {}>".format(self.screen_name)

    @property
    def id_str(self):
        """
        A string representation of the unique identifier for this User.
        """
        return str(self.id)

    def timeline(self, **kwargs):
        """
        Returns the 20 most recent statuses posted by the authenticating user.

        Reference: https://dev.twitter.com/rest/reference/get/statuses/user_timeline
        """
        return self.twitter.request(
            'statuses/user_timeline',
            params=kwargs

注意，API.list_members() 的返回值不包括列表的所有者。

总结

上面介绍了 Tweepy 中的 API.list_members() 功能的用法和返回值。通过这个功能，我们可以方便地获取某个 Twitter 列表中的所有成员，并且可以根据需要获取每个成员的详细信息。