WEIR
获取 API Key
语言English
主题

推特 API 申请教程 2026：在 X 控制台拿到 API Key

2026 年推特（X）API 申请步骤：在 console.x.com 创建应用，拿到 API Key 和 Bearer Token，看懂四种凭证，算清第一次调用的费用。只读数据还有免费方案。


发布于 · 更新于 · 阅读约 7 分钟 · Read in English

封面图：四种凭证，只显示一次

申请推特 API Key 的方法：登录 console.x.com，创建一个应用，然后复制 X 只显示一次的密钥。

这篇写给 2026 年第一次调用 X（推特）API 的开发者。你会看到 X 官方的申请步骤、每种凭证的用途，以及第一次调用要花多少钱。最后一节是我们做的 Weir，一个免费的只读方案。

拿到 Bearer Token 之后，X 快速入门里的第一个请求是这样的：

curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
  1. 登录 console.x.com用你的 X 账号登录，接受开发者协议。
  2. 创建应用填写名称、描述和用途。
  3. 保存凭证X 只显示一次，存进密码管理器。
  4. 购买积分按量计费：没有积分，就拿不到数据。
  5. 第一次调用用 Bearer Token 请求用户查询接口。

第 1 步：登录 X 开发者控制台，创建应用

X 的申请说明页会把你带到 console.x.com，也就是 X 开发者控制台。用将来拥有这个应用的 X 账号登录。

X 的页面接着列出三件事：

  1. 接受开发者协议和政策。 这是 X 使用 API 的合同。
  2. 说明你的用途。 X 要你填写“使用 API 的基本信息”。
  3. 点击 New App。 填写应用名称、描述和用途。

X 说，控制台随后就会生成你的密钥和令牌。

推特 API 申请还要审核吗？

按 X 现在的说明页，不用等审核。很多中文教程还在讲去 developer.x.com 或 apps.twitter.com 提交申请、等 X 批准，那是旧流程。

我们在 2026 年 10 月 22 日核对过 X 的申请说明页，上面没有提到任何审核等待期。这些旧教程里写的免费套餐，X 的价格页面现在也已经不再列出。

第 2 步：保存 API Key、Secret 和 Bearer Token

每个凭证只显示一次。X 的说明页写明“凭证只显示一次”，丢了就只能重新生成，而重新生成“会让旧的凭证失效”。

下面是 X 生成的凭证，以及什么时候需要哪一个：

凭证 X 对它的说明 你用它来
API Key 和 Secret 识别你的应用，用于 1.0a 签名 生成其他令牌
Bearer Token 应用身份，只读公开数据 读取推文和用户
Access Token 和 Secret 以你自己的账号身份操作 让自己的机器人发推
Client ID 和 Secret OAuth 2.0 用户授权请求 代表其他用户操作

大多数第一个项目只需要 Bearer Token。

X 的旧页面把 API Key 和 Secret 叫作 consumer API keys，很多教程现在还这样叫。X 的应用页面还提到，手机应用这类 OAuth 2.0 公开客户端没有 Client Secret，改用 PKCE。

第 3 步：先买积分，每次调用都要付钱

X 的 API 按量计费。价格页面要你“先在开发者控制台购买积分”，账单常见问题也说，没有积分的话，请求“会一直失败，直到你购买更多积分”。

截至 2026 年 10 月 22 日，X 的价格页面和申请说明页都没有列出免费套餐。

$0.005读取一条推文
$0.010读取一个用户资料
300 万每月读取推文上限，超过要签企业合同
$70一次性赠送积分，最多

赠送积分有条件。X 的赠送积分页面写着：首次绑定符合条件的银行卡并首次购买积分后，送 $20。

它还会按你第一次自动充值的金额再送一份，最多 $50。2026 年 10 月 13 日起，只绑卡已经不算数。两种赠送都在发放三个月后过期。

X 说这些优惠“正在逐步推出”，所以你的账号可能暂时还拿不到。

写任何循环之前，先在控制台里设好消费上限。各项价格见我们的推特 API 价格指南。

第 4 步：用 Bearer Token 发出第一次调用

在控制台里打开你的应用，复制它的 Bearer Token。导出成环境变量后，运行 X 官方示例里的用户查询：

export BEARER_TOKEN="把你的令牌粘贴到这里"
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

X 快速入门给出的返回是这样的：

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

这次调用返回一个用户，按 X 的“读取用户”价格收 $0.010。

搜索更贵。最近推文搜索默认返回最多 10 条，读满第一页要 $0.05。

同一天里再查一次同一个用户，X 不应该重复收费。它在同一个 UTC 日内对重复内容去重，X 自己称之为“软性保证”。

只读数据：免费拿到推特数据 API Key

如果你只读公开数据，可以跳过 X 的开发者应用和预付积分。Weir 是我们做的只读 API，所以看这一节时请记住这一点。

免费注册，无需绑卡，然后在控制台的 API keys 里创建一个 Key。和 X 一样，Weir 的 Key 也只显示一次，我们只保存它的哈希值。

在 Weir 上做同样的用户查询：

curl https://api.weirapp.io/v1/x/users/XDevelopers \
  -H "Authorization: Bearer $WEIR_API_KEY"

我们在 2026 年 10 月 22 日运行了这个请求。它扣了 3 积分：调用 1 积分，用户资料 2 积分。删减后的返回如下：

{
  "data": {
    "id": "2244994945",
    "username": "XDevelopers",
    "name": "Developers",
    "followersCount": 697848,
    "createdAt": "2013-12-14T04:35:55.000Z"
  }
}

账号 ID 一样，显示名称和粉丝数是实时数据，不是 X 的示例。

每月 5,000 免费积分够做大约 1,600 次这样的查询。用来搜索的话，能读大约 4,760 条推文。调用失败不扣积分。

读取 1,000 条推文的费用，2026 年 10 月
X API$5.00
TwitterAPI.io$0.15
Weir，$5 套餐约 $0.21

TwitterAPI.io 的价格页面写着每千条推文 $0.15，按单条推文算比 Weir 便宜。Weir 的数字按每页约 20 条推文的搜索计算：每条推文 1 积分，每次调用另加 1 积分。想算自己的用量，可以用 推特 API 费用计算器。

推特 API Key 用不了怎么办

第一天最可能遇到的错误：

  • 401 Unauthorized： 令牌错了、没带，或者已经重新生成过。检查 Authorization: Bearer 请求头。
  • 402 Payment Required： 余额用完了。X 会拦住所有调用，直到你买积分，可以先看我们的 X API 402 错误指南（英文）。
  • 403 Forbidden： 令牌有效但没有权限，比如拿 Bearer Token 调用需要用户授权的接口。
  • 429 Too Many Requests： 触发了速率限制。等到 x-rate-limit-reset 给出的时间再试。
  • Secret 丢了： X 无法再次显示。重新生成，然后更新你的代码。

什么时候不适合用 Weir

  • 你要发推、回复、点赞或私信。 Weir 只读，只有 X 的 API 能写。
  • 你需要 X 官方的条款和保障。 Weir 没有 X 的授权，访问方式可能会变。
  • 你读的是自己的账号。 X 对这类“自有读取”只收每条 $0.001。
  • 你只在乎单条推文的价格。 TwitterAPI.io 按推文算更便宜。

常见问题

推特 API 免费吗？

创建应用和拿到密钥不收费，但每次返回数据的调用都要扣积分。截至 2026 年 10 月，X 的价格页面没有列出免费套餐。新账号最多能拿到 $70 一次性赠送积分，两种优惠都要先付款。

申请推特 API 需要开通 X Premium 吗？

不需要。X 的申请说明页只要求你的 X 账号、接受开发者协议，以及一段用途说明，完全没提 Premium。X 的 Premium 页面也没有在任何一档里包含 API 权限。详见我们的 X Premium 与 API 权限说明（英文）。

推特 Bearer Token 在哪里看？

在 console.x.com 的 X 开发者控制台里。打开你的应用，从凭证里复制 Bearer Token。它只显示一次，丢了就重新生成。X 的文档也写了怎样用 API Key 和 Secret 换出一个。

一个推特 API Key 能同时读和发推吗？

Bearer Token 不行，它只能读公开数据。要以自己的账号发推，X 让你用 Access Token 和 Secret。要代表其他用户操作，就用 OAuth 2.0 和你的 Client ID。发一条普通推文要 $0.015。

参考来源

以下均于 2026 年 10 月 22 日核对，除特别说明外均为英文页面：

继续阅读