X / Twitter BulkPublish

X / Twitter API

用你自己的代码发布、排期和管理 X / Twitter。一个 REST API 和一个密钥就能覆盖 X / Twitter 和你连接的其他所有网络，集成只需写一次。

获取免费 API 密钥阅读 API 参考

BulkPublish 的 X / Twitter 集成

X / Twitter API 涵盖的内容

下面的一切都属于已公开的 API，今天就能用于 X / Twitter。

功能	接口
创建、排期、更新和发布帖子	`POST /api/posts`
上传图片和视频	`POST /api/media`
查找队列中的下一个空闲时段	`GET /api/posts/queue-slot`
创建重复排期	`POST /api/schedules`
发布 RSS 源中的新内容	`POST /api/rss-feeds`
自动发布首条评论	`platformSpecific._firstComment`
发布多段话题串	`postFormat: "thread"`
读取每条帖子的数据	`GET /api/posts/{id}/metrics`
读取并回复已发布帖子下的评论	`GET /api/posts/{id}/engagement, POST /api/posts/{id}/comments/reply`
读取并回复私信	`GET /api/inbox/conversations, POST /api/inbox/conversations/{id}/messages`
检查连接是否正常	`GET /api/channels/{id}/health`
查看套餐用量	`GET /api/quotas/usage`

可发布到 X / Twitter 的帖子类型

用 postTypeOverrides 选择类型。X / Twitter 不提供的类型会在排队之前就被拒绝。

内容类型	媒体
`tweet` Tweet	可选，最多 4 个图片或视频

用 curl 排期一条 X / Twitter 帖子

三个请求：找到你的频道，帖子有文件的话先上传，然后创建帖子。把密钥换成你在设置，再到 API 密钥里生成的那个，把 12 换成你自己的频道 id。

1. 列出你的频道，记下 X / Twitter 账号的 id。

curl https://app.bulkpublish.com/api/channels \
  -H "Authorization: Bearer bp_your_key_here"

2. 创建帖子。

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Shipping a new release today",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "platformSpecific": {
    "x": {
      "replySettings": "following"
    }
  }
}'

响应是创建好的帖子，带有 id 和状态。之后用 GET /api/posts/{id} 获取，查看发布结果。

X / Twitter 选项

把这些放在 platformSpecific 里，使用 X / Twitter 对应的键。

选项	作用	接受的值
`replySettings`	谁可以回复	`everyonefollowingverifiedsubscribersmentionedUsers`

通过 API 获取 X / Twitter 数据分析

每条 X / Twitter 帖子的这些数据会通过 GET /api/posts/{id}/metrics 返回，并带有随时间变化的快照。

展示量
点赞
评论
转发
收藏
互动率

评论和消息

通过 API，你可以读取并回复已发布帖子下的评论和读取并回复私信。

读取评论所有套餐都支持。回复评论需要付费套餐，收件箱属于 Pro 和 Business。在你的账号开通某项功能之前，API 会返回 403 和一个可供检查的代码。

所有套餐都能使用 API

每个套餐都包含 API 密钥，Free 套餐也不例外。各套餐的额度如下。

套餐	API 密钥	每日请求数
Free	1	30
Pro	5	5,000
Business	10	50,000

直接对接 X / Twitter，还是使用 BulkPublish

直接对接是个合理的选择，尤其是你需要 BulkPublish 没有开放的功能时。以下是 X API 对你的要求，已于 2026年10月对照其文档核实。

发布之前，你需要先在 X / Twitter 注册一个开发者应用。
按请求次数计费。
访问令牌有效期很短，刷新步骤需要你自己实现。
大视频需要分块上传，由你自己实现。

BulkPublish 替你维护连接：刷新令牌，在排队之前按 X / Twitter 的规则检查每条帖子，并在帖子上报告失败的目标，所以你的代码只需发一个请求。

阅读官方文档

想直接问助手？

Claude、ChatGPT 和 Cursor 可以通过 X / Twitter MCP 服务器完成同样的事，用提示词代替代码。

查看 X / Twitter MCP 服务器

更喜欢日历而不是代码？

同一个 X / Twitter 账号也可以在应用里排期，配有内容日历和批量上传。

查看 X / Twitter 定时发布工具

常见问题

关于 X / Twitter API 的常见问题。

有没有不用自己开发集成就能用的 X / Twitter API？

有。BulkPublish 通过它的 REST API 开放 X / Twitter。只需连接一次 X / Twitter 账号，之后就可以用密钥发布、排期和管理。同一个密钥也适用于你连接的其他所有网络。

通过 API 可以向 X / Twitter 发布什么？

帖子类型有 Tweet。排队之前，每条内容都会按 X / Twitter 的素材规则检查，所以 X / Twitter 会拒绝的请求会立刻失败，并给出清楚的错误。

可以通过 API 排期 X / Twitter 帖子吗？

可以。发送状态 "scheduled"，并带上 scheduledAt 时间和 timezone，或者先请求队列中的下一个空闲时段。重复排期和 RSS 源同样可用。

可以通过 API 读取 X / Twitter 数据分析吗？

可以。每条帖子的数据包括展示量、点赞、评论、转发、收藏和互动率，并带有随时间变化的快照。

可以通过 API 读取并回复 X / Twitter 的评论或消息吗？

可以。你可以读取并回复已发布帖子下的评论和读取并回复私信。回复评论需要付费套餐，收件箱属于 Pro 和 Business。

X / Twitter API 要额外付费吗？

不用。所有套餐都能使用 API。Free 包含 1 个密钥和每天 30 次请求，Pro 为 5 个密钥和每天 5,000 次，Business 为 10 个密钥和每天 50,000 次。

需要 X / Twitter 开发者账号或应用审核吗？

使用 BulkPublish 不需要。你在频道页面连接 X / Twitter 账号，用 BulkPublish 密钥发布即可。如果你改为直接对接 X / Twitter 自己的 API，上面的部分列出了它对你的要求。

AI 助手也能做这些吗？

能。X / Twitter MCP 服务器页面介绍了如何连接 Claude、ChatGPT 或 Cursor，以及该怎么提问。

同一个密钥和同样的请求格式适用于 15 个网络。

查看所有网络的 API

开始用代码发布到 X / Twitter

创建免费账号，连接 X / Twitter，生成密钥。无需绑定银行卡。

获取免费 API 密钥查看价格