RequestBeam

文档目录

RequestBeam 文档

Twitter API

使用统一的 Twitter API 查询用户资料与时间线，返回官方 X API v2 风格的数据结构。

本服务提供统一的 Twitter REST API，并返回一致的 X API v2 风格响应结构。

text
/v1/twitter

验证

所有 Twitter API 接口都需要使用 Bearer Token 进行认证。

http
Authorization: Bearer YOUR_API_KEY

如果请求直接返回认证错误，请优先检查：

  • API Key 是否正确
  • Key 是否适用于当前 API Base URL
  • 请求头是否拼写正确
  • 代理层是否改写了请求头

请求地址

Twitter API 的基础路径是 /v1/twitter。客户端只需要在 API Base URL 后使用下列相对路径。

text
GET https://api.requestbeam.com/v1/twitter/users
GET https://api.requestbeam.com/v1/twitter/users/{id}
GET https://api.requestbeam.com/v1/twitter/users/{id}/tweets

返回格式

Twitter API 成功响应不包 success/data 外层包装，直接返回统一后的 data、includes、meta。

当前支持的能力

User Info通过 username 查询 Twitter 用户资料，也支持通过 id 直接查询用户资源。User Timeline通过用户 id 查询时间线，并返回统一后的 tweet 列表、作者展开信息和分页元数据。
  1. 如果你只有 username，先调用“根据用户名获取用户”接口拿到统一后的 data.id。
  2. 用返回的 data.id 调用“获取用户时间线”接口。
  3. 如果需要作者资料，给时间线接口传 expansions=author_id。

统一抽象规则

  • 用户接口始终返回单个 user 对象：{ "data": { ... } }
  • 时间线接口始终返回 tweet 数组：{ "data": [ ... ], "meta": { ... } }
  • 当请求 expansions=author_id 时，时间线接口会附带 includes.users
  • user.fields 和 tweet.fields 只控制可选字段投影，基础标识字段始终保留
  • 用户对象始终保留：id、name、username
  • Tweet 对象始终保留：id、text

可选字段范围

user.fields

当前统一层支持输出这些用户字段：

  • created_at
  • description
  • entities
  • location
  • pinned_tweet_id
  • profile_banner_url
  • profile_image_url
  • protected
  • public_metrics
  • url
  • verified
  • verified_type

tweet.fields

当前统一层支持输出这些 tweet 字段：

  • attachments
  • author_id
  • conversation_id
  • created_at
  • edit_history_tweet_ids
  • entities
  • in_reply_to_user_id
  • lang
  • possibly_sensitive
  • public_metrics
  • referenced_tweets
  • source

调试建议

  • 每次响应都会带 X-Request-Id
  • 建议在调用失败、结果异常或服务限流时记录这个值
  • 如果你需要排查具体扣费，也可以把 X-Request-Id 和调用时间一起保留

端点列表

根据用户名获取用户GET /v1/twitter/users?username=elonmusk根据 ID 获取用户GET /v1/twitter/users/44196397获取用户时间线GET /v1/twitter/users/44196397/tweets