Twitter API

Twitter API：用户查询、时间线与分页

通过 Bearer 认证接入 RequestBeam Twitter / X 端点，配置用户与帖子字段、游标分页和参数校验错误处理。

将用户名解析为用户 ID，获取该用户的时间线，再用返回的 next token 请求下一页。成功调用直接返回 JSON，无需轮询 Jobs。

获取 API 密钥浏览 API 目录

面向具体任务

实现三个受支持的 GET 操作并处理返回结果。

通过用户名查询账户并选择返回的资料字段。

通过用户 ID 刷新已知账户，无需再次查询用户名。

通过页大小限制和分页 token 获取时间线。

计费单位

了解用量计量方式

按请求以美元计费。

运行限制

返回字段取决于文档定义的查询参数与上游响应。
max_results 必须为 1 至 100 的整数；实际每页结果可能更少。
将用户 ID 和帖子 ID 保存为字符串，避免数字精度损失。

接入指南

选择下一步

规划刷新与存储 在应用中限制请求数量、对帖子去重并记录获取时间。 数据接口目录 查看当前数据产品、操作和按请求计费的价格。

当前目录覆盖范围

可用接口与计费单位

比较 API ID、操作、提供商、协议和价格。估算用量费用前，先检查目录日期与每项操作的计费单位。

数据接口

Twitter User Data

twitter-user-data

可用

获取公开的 Twitter / X 用户资料与用户时间线。

提供商: Twitter / X Data
接口协议: REST
计费单位: 次请求

公开操作

GET /v1/twitter/users 按用户名获取用户
GET /v1/twitter/users/{id} 按用户 ID 获取用户
GET /v1/twitter/users/{id}/tweets 获取用户推文

我们的价格

请求: $0.0020 /次

按用户名获取用户

GET /v1/twitter/users

我们的价格

请求: $0.0020 /次

按用户 ID 获取用户

GET /v1/twitter/users/{id}

我们的价格

请求: $0.0020 /次

获取用户推文

GET /v1/twitter/users/{id}/tweets

我们的价格

请求: $0.0020 /次

打开完整 API 目录

请求示例

从文档定义的操作开始

curl "https://api.requestbeam.com/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.requestbeam.com/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.requestbeam.com/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

使用账户文档中的 API 基础 URL 并替换示例占位符。通过 Authorization 请求头发送 API 密钥，切勿将其放在 URL 或提交到版本库的文件中。

端点

账户与时间线的三个操作

按用户名查询 GET /v1/twitter/users?username=<USERNAME>

将返回的 data.id 作为字符串保存，供后续请求使用。

按用户 ID 查询 GET /v1/twitter/users/<USER_ID>

获取已知账户，并按需选择资料字段。

用户时间线 GET /v1/twitter/users/<USER_ID>/tweets

设置 max_results ，并传入 pagination_token 以请求后续页面。

查询参数

选择字段并对时间线分页

账户查询: username 为必填参数，适用于 /v1/twitter/users。两个查询端点均接受逗号分隔的 user.fields 列表，例如 description,public_metrics.
每页数量: max_results 接受 1 至 100 的整数。这是每页数量上限，不保证返回相同数量的帖子。
时间线字段: 使用 tweet.fields=created_at,public_metrics 获取时间戳和指标。请求 expansions=author_id 时配合 user.fields 以获取可用的作者详情。使用 exclude=replies,retweets 排除对应类型的帖子。
下一页: 将 meta.next_token 从响应中取出，在下一次请求中作为 pagination_token 传入。将 token 视为不透明值并进行 URL 编码。当没有返回下一页 token、达到页数预算或 token 重复时停止。

响应处理

直接读取 JSON 结果

用户查询在以下字段中返回账户： data。时间线响应包含 data 数组和 meta.result_count，以及 meta.next_token （存在下一页游标时）。作者扩展信息可能位于 includes.users.

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

空时间线响应示例，并非实时账户结果。可选字段和游标可能不存在。空页不能证明账户从未发布过内容。

参数校验错误

重试前修正无效参数

缺少 username 或超出范围的 max_results 会返回 HTTP 400，并包含 success: false, error.code: 10001、 error.message和 requestId。请检查错误消息并修正请求，不要原样重试。

请求追踪

保留请求 ID，不保留凭据

保留 X-Request-Id 响应头，以便获取支持和追踪请求。读取成功结果前先检查 HTTP 状态；不要在应用日志中记录 API 密钥和不必要的账户资料。