Python - Tweepy 中的 API.search_users()

Tweepy 是一个用于与 Twitter API 进行交互的 Python 库，可以方便地获取 Twitter 上的数据。Tweepy 提供了许多方便有效的方法，其中之一是 API.search_users() 方法。

概述

API.search_users() 方法可用于根据给定的搜索条件在 Twitter 上搜索用户。可以指定要搜索的关键字、语言、位置、帐户类型等。

语法

API.search_users(q, per_page=20, page=1, sort_method='popular', include_entities=True, **kwargs)

• q：必需，搜索关键字。
• per_page：可选，每个页面返回的用户数，默认为 20。
• page： 可选，搜索结果的页数，默认为 1。
• sort_method：可选，搜索结果的排序方法，默认为 popular。
• include_entities：可选，是否包含 entities，默认为 True。

返回值

返回一个包含与搜索条件匹配的用户的列表。

示例

以下示例可用于搜索带有关键字 "Python" 的、在美国的推特用户：

import tweepy

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

api = tweepy.API(auth)

users = api.search_users('Python', count=10, page=1, location='United States')
for user in users:
    print(user.screen_name)

该示例代码返回了包含最多 10 个美国用户的列表，这些用户与关键字 "Python" 相关。

注意事项

• API.search_users() 方法需要进行身份验证，因此需要使用有效的 API 密钥。
• 可以使用以下位置参数之一指定用户位置：纬度和经度坐标、城市名、街道地址、邮政编码和 IP 地址。
• 可以使用以下帐户类型之一限制搜索结果：默认（包括普通用户和受验证的用户）、用户、受验证的用户、推特官方帐户和推特广告帐户。

结论

使用 Tweepy 的 API.search_users() 方法，可以轻松、高效地在 Twitter 上搜索相关用户。为了获得更好的结果，请确保指定关键字、位置等的正确性。