TWTR Data API

Read-only X (Twitter) API for profiles, relationships, posts, replies, media, tweet search, user search, and cursor pagination.

原始信息汇总

TWTR Data API 数据集详情

数据集概述

TWTR Data API 提供对公开 X（Twitter）数据的只读访问，通过稳定、标准化的 JSON 格式返回数据。

可用数据

• 用户个人资料、关注者和正在关注
• 用户帖子、媒体帖子以及推文与回复时间线
• 推文详情和高质量对话回复
• 按相关性或时间顺序进行推文搜索
• 按名称、用户名或关键词进行用户搜索

API 端点

端点	描述
GET /health	服务健康检查
GET /user/{username}	根据用户名获取用户个人资料
GET /user/{id}/tweets	用户帖子时间线
GET /user/{id}/media	包含照片、视频或 GIF 的媒体帖子
GET /user/{id}/tweets-and-replies	推文与回复个人资料时间线
GET /user/{id}/followers	关注者列表
GET /user/{id}/following	用户关注的账号
GET /tweet/{id}	推文详情和高质量回复
GET /search	使用 Top 或 Latest 进行推文搜索
GET /search/users	用户搜索

分页机制

• 分页响应包含以下字段：
  • next_cursor：用于下一页请求的不透明值
  • has_more：是否还有下一页
  • count：当前页面返回的记录数
• 将 next_cursor 作为 cursor 查询参数原样传递，不要解码或修改
• 请求的 count 范围为 1 到 100（最大值），X 可能强制使用更小的上游页面大小
• 媒体端点使用受保护的不透明游标，防止下一页出现重复的网格锚点帖子

响应模式

• raw=false（默认）：返回紧凑、标准化的 JSON
• raw=true：返回完整的上游 GraphQL data 对象，适用于高级消费者

搜索行为

• GET /search 使用 product=Top 进行相关性搜索，或使用 product=Latest 进行时间顺序搜索
• Top 结果会实时排序，在消费游标链时可能重新排序
• 需要稳定时间顺序遍历时请使用 Latest

数据格式说明

• ID 以字符串形式返回，以避免整数精度丢失
• 标准化的 null 表示上游字段或关系不存在
• 布尔字段如 is_reply、is_retweet、is_quote 从上游关系派生
• 个人资料默认值（如空 location 或 verified=false）在 X 省略对应值时使用

错误码

• 403：API 网关拒绝请求
• 404：用户或推文未找到
• 422：查询、ID、数量、游标、产品或布尔参数无效
• 502：上游身份验证或响应失败
• 503：X 暂时不可用或速率受限

上游说明

• 此 API 仅公开只读公共数据。结果、字段、页面大小和可用性最终取决于 X
• 不会绕过私人、已删除、被屏蔽或其他方式不可用的内容