使用 Twitter API v2 进行教学的指南

2025-06-07

使用 Twitter API v2 进行教学的指南

您是一位希望在课程中使用 Twitter API 的教育工作者吗?在本指南中,您将学习:

  • 什么是 Twitter API
  • 为什么教育工作者在课程中使用 Twitter API
  • Twitter API 中有哪些类型的数据
  • 使用 Twitter API 教授哪些类型的课程
  • 可用的访问级别以及您的学生应该选择哪些级别
  • 学生如何在代码中获取密钥和令牌来连接 Twitter API
  • 如何不编写代码下载 CSV 或 JSON 格式的关于某个主题的 Twitter 数据
  • 学生可以使用哪些工具和资源来了解 Twitter API

注意:本指南中,凡是提到Twitter API的,均指Twitter API v2,它是主要的 API。我们不会使用旧的 Twitter API v1.1。

介绍

Twitter 是一个供世界各地的人们通过推文交流想法、观点和信息的平台。每条推文最多包含 280 个字符,可以包含链接、图片和视频等媒体内容。Twitter API 提供了一种以编程方式检索 Twitter 数据的方法。

世界各地各个学校的教授在课堂上使用 Twitter API 来教学生:

  • 数据科学、文本挖掘、机器学习等。
  • 如何编写代码
  • 如何使用 API
  • 如何处理现实世界的社交媒体数据

Twitter API 提供的数据以JSON 格式提供。以下是 Twitter 上推文以 JSON 格式表示的示例:

Twitter 上的一条推文

推文的 JSON 表示形式

使用 Twitter API 的课程示例

申请访问 Twitter API

为了使用 Twitter API,学生需要获取密钥和令牌。为此,他们需要首先申请相应的 Twitter API 访问权限。目前,Twitter API v2 有 3 个访问级别:

基本访问

这是课堂上学生开始使用 Twitter API 的最快且推荐的方式。学生只需在此注册一个开发者账户,即可立即访问 Twitter API v2,无需等待用例审核。此访问级别允许学生每月从 Twitter API v2 检索最多50 万条推文。使用 Twitter API 中的搜索功能时,他们可以在此访问级别获取过去 7 天的推文。

提升通道

如果您班上的学生每月需要超过 50 万条推文,他们可以在此申请提升访问权限。这需要用例审核,因此获取此访问权限需要更长时间。此访问权限级别允许学生每月从 Twitter API v2 检索最多200 万条推文。使用 Twitter API 中的搜索功能时,他们可以在此访问权限级别获取过去 7 天的推文。

学术访问

如果您的学生正在攻读硕士或博士课程,并且拥有有效的研究用例,他们可以在此处申请学术访问权限。这需要用例审查,因此获取此访问权限需要更长时间,并且学生必须提供额外文档。此访问级别允许他们每月从 Twitter API v2 检索最多1000 万条推文。使用 Twitter API v2 中的搜索功能时,他们可以从自 2006 年以来的完整公开推文档案中获取任何公开推文。他们还可以获得高级搜索运算符(例如 geo),以便更精确地过滤他们想要返回的数据。

如何获取 API 密钥和令牌

获取 API 密钥和令牌的步骤因访问级别而异。以下是每个访问级别的说明:

获取必要访问权限的密钥和令牌

首先,您需要申请基本访问权限。在此过程中,您需要验证您的电子邮件。此外,您需要在帐户中注册一个电话号码才能使用 API。

创建帐户后,系统会询问您一些基本问题:

问题

查看并同意开发者协议和政策

开发者政策

接下来,您将被要求验证您的电子邮件

验证电子邮件

您应该会收到一封如下所示的电子邮件:

确认电子邮件

点击确认后,您将被引导至开发者门户。您可以创建一个应用,只需为其命名即可

创建应用程序

点击“获取密钥”后,您将能够看到您的密钥和持有者令牌。请妥善保管它们,因为您将使用它们连接到 Twitter API v2。

密钥和令牌

获取提升访问权限的密钥和令牌

获取学术访问密钥和令牌的完整步骤可在此处找到

获取学术访问权限的密钥和令牌

获取学术访问密钥和令牌的完整步骤可在此处找到

如果我的学生只想要 Twitter 数据而不想编写任何代码怎么办?

有时教授们不希望学生花费太多时间编写代码来使用 API 获取 Twitter 数据。Twitter 最近推出了下载器工具,允许研究人员指定他们想要的数据的搜索查询、时间段以及他们想要的数据格式(例如 JSON 或 CSV)。指定后,他们可以下载数据并用于他们的作业和项目。点击此处了解更多关于如何编写搜索查询的信息

第一步:输入您的学术不记名令牌

输入不记名令牌

第二步:创建新的下载

创建下载

第三步:指定查询、时间范围和下载格式

询问

注意:下载工具目前仅适用于学术访问。

供学生开始使用 Twitter API v2 的工具和资源

对于想要开始使用 Twitter API v2 的学生来说,有很多资源可供参考。其中一些列出如下:

库和包

如果您希望在 Python 中使用 Twitter API v2,则可以使用两个流行的库:

如果您希望在 R 中使用 Twitter API v2,则可以使用AcademictwitteR包。

Twitter 也有自己的JavaTypescript第一方库

使用 Twitter API v2 开始学术研究(课程)

Twitter 有一个专门的课程,教你如何使用 Twitter API v2 进行学术研究。该课程包含即插即用的代码示例以及编写搜索查询的速查表等。

视频

博客和文章

Twitter 社区论坛

如果学生对 Twitter API 有任何疑问,他们可以在Twitter 社区论坛上提问。

社区数据集

许多研究人员在 Github 等平台上分享他们的研究数据集(推文 ID)。例如,Emily ChenCOVID-19 数据集就是一个这样的数据集。一些教授让学生使用DocNow 的 Hydrator等工具来补充这些数据集,并在课堂上使用。

最后的想法

希望本指南能帮助您了解如何在课堂上使用 Twitter API 进行教学。如果您教授的课程使用了 Twitter API,并且有任何疑问,欢迎随时通过 Twitter @suhemparack与我联系,并分享您正在教授的课程!

文章来源:https://dev.to/suhemparack/a-guide-to-teaching-with-the-twitter-api-v2-3n08
PREV
如何使用 React.js?
NEXT
Web 3.0 终极指南 - 学习 Web 3.0 之前你需要知道的一切