Skip to main content
/search-tweets 端点使用关键词和运算符查询公开 X(Twitter)搜索索引,返回匹配推文及完整作者资料和互动指标。 端到端使用方式、查询模板和可运行代码,请参阅博客上的如何通过 API 搜索推文

端点

身份验证

ApiKey 请求头中传入 API 密钥。HTTP 请求头名称不区分大小写,密钥值必须与获得的密钥完全一致。
详情请参阅身份验证

请求体

请求示例

响应

每条推文都直接包含完整作者资料,无需额外查询用户数据。
完整字段参考请参阅响应格式

查询运算符

query 字段支持全部原生 X 搜索运算符,包括:
  • 关键词与精确短语:"climate change"
  • 用户筛选:from:to:@mention
  • 互动筛选:min_faves:min_retweets:min_replies:
  • 内容筛选:filter:mediafilter:imagesfilter:videosfilter:links(前加 - 表示排除)
  • 语言与日期:lang:ensince:2026-01-01until:2026-03-01
  • 布尔逻辑:OR、用于分组的括号、用于排除的 -
完整参考:搜索运算符

分页

响应包含 next_cursor 字段。获取下一页时,发送相同请求,并将 next_cursor 设为该值。当它为 null 或缺失时,表示结果已全部读取。
游标分页方式与边界情况请参阅分页

速率限制

每个 API 密钥每秒 20 次请求,所有套餐相同。超过限制会返回 429 Too Many Requests。参阅速率限制

错误码

完整列表请参阅错误码

相关端点