Instagram BulkPublish

Instagram API

Q: 可以通过 API 读取 Instagram 数据分析吗？

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

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

Instagram API 涵盖的内容

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

功能	接口
创建、排期、更新和发布帖子	`POST /api/posts`
上传图片和视频	`POST /api/media`
查找队列中的下一个空闲时段	`GET /api/posts/queue-slot`
创建重复排期	`POST /api/schedules`
发布 RSS 源中的新内容	`POST /api/rss-feeds`
自动发布首条评论	`platformSpecific._firstComment`
将帖子发布为快拍	`POST /api/posts/{id}/story`
读取每条帖子的数据	`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`

可发布到 Instagram 的帖子类型

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

内容类型	媒体
`feed_photo` Feed Photo	必需：1 张图片
`feed_video` Feed Video	必需：1 个视频
`reel` Reel	必需：1 个视频
`story` Story	必需：1 个图片或视频
`carousel` Carousel	必需：2 至 10 个图片或视频

用 curl 排期一条 Instagram 帖子

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

1. 列出你的频道，记下 Instagram 账号的 id。

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

2. 上传文件。响应会给出媒体 id，下面作为 mediaFiles 使用。

curl -X POST https://app.bulkpublish.com/api/media \
  -H "Authorization: Bearer bp_your_key_here" \
  -F "file=@clip.mp4"

3. 创建帖子。

curl -X POST https://app.bulkpublish.com/api/posts \
  -H "Authorization: Bearer bp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Behind the scenes of launch day",
  "channels": [{ "channelId": 12 }],
  "status": "scheduled",
  "scheduledAt": "2026-12-01T09:00:00Z",
  "mediaFiles": [101],
  "postTypeOverrides": {
    "instagram": "reel"
  },
  "platformSpecific": {
    "instagram": {
      "collaborators": "bulkpublish",
      "thumbnailTimestamp": 2
    }
  }
}'

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

Instagram 选项

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

选项	作用	接受的值
`collaborators`	要标记为共同作者的用户名	文本
`shareToStory`	同时分享到快拍	true 或 false
`trialReel`	作为试播 Reel 发布	true 或 false
`graduationStrategy`	试播 Reel 如何转为正式 Reel	`manualauto`
`thumbnailTimestamp`	封面帧，从开头起的秒数	数字
`coverUrl`	封面图，使用公开网址	文本