如何用 TwexAPI 删除 X 帖子并准备停用账号
TwexAPI 可以帮助你删除已授权 X 账号下的帖子，但不能直接删除 X 账号本身。账号停用和最终删除必须在 X 官方设置里完成。
X 帮助文档说明：停用账号会开启一个 30 天窗口；如果这段时间内不再登录，账号会被永久删除。如果你需要保留帖子、私信或媒体副本，请先在 X 设置里请求数据归档。
TwexAPI 能做什么，不能做什么
| 目标 | 是否用 TwexAPI | 怎么处理 |
|---|---|---|
| 删除一条指定帖子 | 可以 | 调用 POST /twitter/tweets/delete-batch，并传入 target_id。 |
| 删除已授权账号下的帖子 | 可以 | 备份并确认后，调用 POST /twitter/tweets/delete-batch，不传 target_id。 |
| 永久删除 X 账号 | 不可以 | 在 X 设置里进入 Settings and privacy、Your account、Deactivate your account。 |
| 删除搜索引擎缓存 | 不可以 | 按搜索引擎自己的移除流程处理；X 不能控制外部索引。 |
请只对你拥有或明确获授权管理的账号使用这个流程。
删除帖子前的准备
调用删除端点前，先做这些检查：
- 如果需要留存副本，先从 X 设置下载数据归档。
- 检查并撤销不需要的第三方应用授权，避免其他工具意外重新登录或修改账号。
- 先用一条帖子 ID 测试删除流程。
- 不要把 API token 和 X cookie 写进源码仓库。
- 本地保存已删除帖子 ID 日志，方便之后复核。
删除一条帖子
POST /twitter/tweets/delete-batch 需要 cookie 和 username。如果只删除一条指定帖子，再传入 target_id。
curl --request POST \
--url https://api.twexapi.io/twitter/tweets/delete-batch \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"cookie": "auth_token=...",
"username": "your_username",
"target_id": "1234567890123456789"
}'响应里的 data 会返回已删除的帖子 ID。
{
"code": 200,
"msg": "success",
"data": ["1234567890123456789"]
}确认后删除账号帖子
根据端点参数说明，不传 target_id 时会删除该授权用户名下的帖子。这个操作应当按不可逆处理。下面脚本要求显式设置确认环境变量，避免误运行。
1const token = process.env.TWEXAPI_BEARER_TOKEN;
2const cookie = process.env.X_AUTH_COOKIE;
3const username = process.env.X_USERNAME;
4const confirmDelete = process.env.CONFIRM_DELETE === "I_UNDERSTAND";
5
6if (!token || !cookie || !username) {
7 throw new Error("Set TWEXAPI_BEARER_TOKEN, X_AUTH_COOKIE, and X_USERNAME.");
8}
9
10if (!confirmDelete) {
11 throw new Error('Set CONFIRM_DELETE="I_UNDERSTAND" before deleting account posts.');
12}
13
14async function deleteAccountPosts() {
15 const response = await fetch("https://api.twexapi.io/twitter/tweets/delete-batch", {
16 method: "POST",
17 headers: {
18 Authorization: `Bearer ${token}`,
19 "Content-Type": "application/json",
20 },
21 body: JSON.stringify({
22 cookie,
23 username,
24 }),
25 });
26
27 const result = await response.json();
28 if (!response.ok || result.code !== 200) {
29 throw new Error(result.msg || `Delete request failed with ${response.status}`);
30 }
31
32 console.log(JSON.stringify({ deleted_ids: result.data || [] }, null, 2));
33}
34
35deleteAccountPosts().catch((error) => {
36 console.error(error.message);
37 process.exit(1);
38});请先测试单条帖子删除，再运行批量清理：
CONFIRM_DELETE="I_UNDERSTAND" \
TWEXAPI_BEARER_TOKEN="<token>" \
X_AUTH_COOKIE="auth_token=..." \
X_USERNAME="your_username" \
node delete-account-posts.js停用 X 账号
帖子清理完成后，账号删除仍然要在 X 里操作：
- 打开 X，进入 Settings and privacy。
- 打开 Your account。
- 选择 Deactivate your account。
- 阅读停用说明，并用密码确认。
- 如果目标是永久删除账号，停用窗口期内不要再登录。
由于账号生命周期由 X 控制，如果界面文案或时间规则变化，请以 X 官方帮助文档为准。
小结
TwexAPI 负责它能真实完成的部分：删除已授权账号下的帖子。账号停用和永久删除，则通过 X 官方设置完成。
把这个边界讲清楚，文章才不会误导用户以为一个 API 请求就能删除整个 X 账号。