Threads BulkPublish

Threads API

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

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

BulkPublish 的 Threads 集成

Threads API 涵盖的内容

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

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

可发布到 Threads 的帖子类型

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

内容类型	媒体
`text` Text	仅文字
`image` Image	必需：1 张图片
`video` Video	必需：1 个视频
`carousel` Carousel	必需：2 至 20 个图片或视频

用 curl 排期一条 Threads 帖子

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

1. 列出你的频道，记下 Threads 账号的 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": "What did you ship this week?",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "platformSpecific": {
    "threads": {
      "topicTag": "buildinpublic"
    }
  }
}'

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

Threads 选项

把这些放在 platformSpecific 里，使用 Threads 对应的键。

选项	作用	接受的值
`quotePostId`	要引用的帖子	文本
`topicTag`	话题标签	文本
`locationId`	要标记的地点	文本

要查找某个频道可用的地点，请调用 GET /api/channels/{id}/options。

通过 API 获取 Threads 数据分析

每条 Threads 帖子的这些数据会通过 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

直接对接 Threads，还是使用 BulkPublish

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

官方文档中的限制：24 小时内通过 API 发布 250 条帖子。
带素材的帖子需要多次调用：上传或创建，等待处理，然后发布。
素材会从公开网址获取，你需要自己托管。
访问令牌大约 60 天有效，因此你需要自己的办法在过期前刷新或重新连接。

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

阅读官方文档

想直接问助手？

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

查看 Threads MCP 服务器

更喜欢日历而不是代码？

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

查看 Threads 定时发布工具

常见问题

关于 Threads API 的常见问题。

有没有不用自己开发集成就能用的 Threads API？

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

通过 API 可以向 Threads 发布什么？

帖子类型有 Text、Image、Video和Carousel。排队之前，每条内容都会按 Threads 的素材规则检查，所以 Threads 会拒绝的请求会立刻失败，并给出清楚的错误。

可以通过 API 排期 Threads 帖子吗？

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

可以通过 API 读取 Threads 数据分析吗？

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

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

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

Threads API 要额外付费吗？

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

需要 Threads 开发者账号或应用审核吗？

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

AI 助手也能做这些吗？

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

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

查看所有网络的 API

开始用代码发布到 Threads

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

获取免费 API 密钥查看价格