通过帖子 ID 读取内容

读取一个已知公开帖子的正文，作为站内展示或后续处理的最小请求。

官方资料核对 2026-10-15示例代码，未进行真实接口实测

接入准备

注册 X 开发者并创建 App，确认目标读取端点对自己的 App 可用。
在控制台取得应用级 Bearer Token，核对 credits 余额并设置支出上限；本页不需要用户发帖权限。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行；密钥不应放进公开网页。

X_BEARER_TOKEN: Developer Console 的 App 中生成的应用级 Bearer Token；只用于服务端。
X_POST_ID: 自己可访问的帖子 URL 中 /status/ 后的纯数字 ID。

export X_BEARER_TOKEN='replace_with_app_bearer_token'
export X_POST_ID='1234567890123456789'

以上 export 适用于 macOS / Linux 的终端，在同一终端内运行后续代码。Python 示例保存为 request.py 后执行 python3 request.py。

调用步骤

01
打开 Developer Console，选择自己的 App，在凭证设置中生成或查看应用级 Bearer Token。
02
将 Token 设置为 X_BEARER_TOKEN 环境变量；不要把 API Secret 当成 Bearer Token。
03
修改示例里的用户名、帖子 ID 或查询词，然后在自己的服务端运行代码，检查 HTTP 状态与 JSON 内的 errors。
04
从帖子网页地址的 /status/ 后取得纯数字 ID，放入 X_POST_ID。示例环境值是虚构占位，必须替换。

调用 01

读取单条帖子

文档称 Post，实际 REST 路径仍使用 /2/tweets；不要自行改成 /2/posts。

GEThttps://api.x.com/2/tweets/${X_POST_ID}

请求头

Authorization: Bearer ${X_BEARER_TOKEN}
Accept: application/json

参数说明

参数表可左右滑动，查看完整说明。

字段 / 位置	类型 / 必填	说明
`id`Path	string必填	目标帖子的数字 ID；保持字符串，避免 JavaScript 大整数精度丢失。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误，业务状态还需按下方返回示例核对。

# 执行后核对返回 JSON 的业务状态；HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request GET \
  --url "https://api.x.com/2/tweets/${X_POST_ID}" \
  --header "Authorization: Bearer ${X_BEARER_TOKEN}" \
  --header "Accept: application/json"

import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.x.com/2/tweets/${X_POST_ID}")
headers = {
    "Authorization": expand("Bearer ${X_BEARER_TOKEN}"),
    "Accept": expand("application/json"),
}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))

// Node.js 22+，保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.x.com/2/tweets/${X_POST_ID}");
const headers = Object.fromEntries(
  Object.entries({
  "Authorization": "Bearer ${X_BEARER_TOKEN}",
  "Accept": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
  method: "GET",
  headers,
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));

返回示例

按官方结构整理的节选示意，非实测结果。data.id 与 data.text 分别是帖子标识和正文。HTTP 200 也应检查 errors，不能只看状态码。以下为结构示意，非本站实测结果。

{
  "data": {
    "id": "1234567890123456789",
    "text": "这是用于说明响应字段的示意文本。"
  }
}

常见错误与排查

HTTP 401凭证缺失或无效: 核对 Authorization: Bearer 格式与 App Token 是否已被重新生成。
HTTP 403已认证，但无权访问目标端点或数据: 核对 App 接入资格与公开可见性；应用级 Token 无法绕过受保护账号。
HTTP 429频控或用量上限: 读取 x-rate-limit-reset，检查 credits 与支出上限后再重试。

调用注意

已删除、受保护或地区不可见内容可能无法读取；本例不请求非公开互动指标。

通过 ID 读取帖子 X HTTP 错误与部分成功响应

注意事项

读取按返回资源消耗 credits，调试也可能计费；准确单价、折扣及预算以当前控制台为准。
这是公开数据只读场景，不包含发帖、私信或用户 OAuth 授权；数据保存和展示仍须遵守 X 政策。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码，覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

01
应用级 Bearer Token 获取与使用核验日期 2026-10-15
02
X 按用量计费、credits 与支出上限核验日期 2026-10-15
03
通过 ID 读取帖子核验日期 2026-10-15
04
X HTTP 错误与部分成功响应核验日期 2026-10-15

X 开发者平台的其他调用手册

按用户名取得用户资料和 ID 检索最近 7 天的公开帖子

← 返回X 开发者平台的全部功能