教程

用 Python 和 X API 获取 Twitter 公开帖子

通过 X API 查询授权范围内的公开帖子,从一页数据开始,处理分页、用量限制和重复记录。

如果你的应用要统计自己产品在 X 上的公开讨论,可以先用官方帖子搜索接口验证查询。把示例限定到品牌词、公开产品名或你负责的账号,确认 API 产品权限和用量,再决定要保存的字段与时长。

操作步骤

  1. 1

    确认权限和需要的时间范围

    在开发者控制台查看应用的搜索权限及用量。近期搜索适合回看最近一周的讨论。超过这段时间的需求要先确认你是否能使用对应的历史搜索能力和费用。把凭据放到环境变量或密钥管理服务,日志只记录状态和请求标识。

  2. 2

    用 Python 请求第一批结果

    下面用 Requests 读取一页帖子。将示例查询替换为有权处理的主题,运行前在本地配置 X_BEARER_TOKEN。代码打印帖子 ID 和发布时间,足以先确认结果是否符合需求。

    python
    import os
    import requests
    
    response = requests.get(
        "https://api.x.com/2/tweets/search/recent",
        headers={"Authorization": "Bearer " + os.environ["X_BEARER_TOKEN"]},
        params={
            "query": '"example product name" lang:en',
            "max_results": 10,
            "tweet.fields": "created_at",
        },
        timeout=20,
    )
    response.raise_for_status()
    for post in response.json().get("data", []):
        print(post["id"], post.get("created_at"))
  3. 3

    用分页和去重做增量更新

    第一批验证通过后,再按照接口返回的分页标记请求后续结果。每轮读取结束后记录最终处理的时间范围,并用帖子 ID 去重。明确限定每轮的最大页数和可接受的请求数量,便于控制成本。

    遇到 401 或 403,先检查凭据、接口权限和应用状态。遇到 429,按响应说明等到可用窗口再重试。统计时优先保存聚合所需字段,并依据你的使用条款处理已删除的帖子和保留期限。

常见问题

为什么相同查询两次返回的条数不同?

近期搜索的窗口会随着时间移动,内容状态也可能变化。记录查询时间、起止时间、分页位置和去重前后的条数,便于解释差异。

有没有必要为这类请求切换代理 IP?

认证、搜索权限和配额由 X API 管理。日常集成优先用稳定网络和批准的应用凭据,通过查询范围、增量同步与预算控制用量。

参考资料

X API 帖子搜索文档

X API 授权文档

选题参考 Miya IP 原文

相关链接

REDROCK / CONTACT

与我们联系

选择一种方便的方式,聊聊产品与接入需求。

Telegram@RedrockIP
邮件支持support@redrock-ip.com