通过 API 发布 Instagram 限时动态
Instagram API 通过公开 URL 上的一张图片或一段视频发布限时动态:使用 media_type 设为 STORIES 创建媒体容器,然后发布。图片为 JPEG 格式,最大 8 MB;视频时长 3 到 60 秒,最大 100 MB。Meta 建议使用 9:16 画面,限时动态在 24 小时后消失,与应用内一致。
easyCoexistence 可通过 Claude、ChatGPT 或您自己的代码,使用 publish_instagram_post 发布图片和视频限时动态,并可通过其内置队列进行排期。
API 可发布的最长限时动态视频;最短为 3 秒,文件最大可达 100 MB。
最大的限时动态图片,必须为 JPEG 格式。
已发布的限时动态在过期前保持显示的时长。
指标值低于 5 时,返回错误代码 10(观看人数不足),而非数字。
限时动态如何发布?
与发布任何帖子使用相同的两个调用。发送 POST /<IG_ID>/media 请求,将 media_type 设为 STORIES,并指定 image_url 或 video_url,然后发送 POST /<IG_ID>/media_publish 请求,并附上容器 ID。视频限时动态需先完成处理,其容器的 status_code 必须显示 FINISHED,才能发布。
Meta 的参考文档描述了图片、视频和轮播的文案,但未描述限时动态的文案,因此需要传达给观众的文字应放在图片或视频本身之中。
限时动态的媒体要求是什么?
Meta 建议限时动态的图片和视频均使用 9:16 画面,以避免裁剪或出现空白。
- 图片:JPEG 格式,最大 8 MB,使用 sRGB 色彩空间;其他色彩空间将被转换。
- 视频:MOV 或 MP4 格式,视频编码为 H.264 或 HEVC,音频为 AAC,每秒 23 至 60 帧,宽度最大 1920 像素,码率最高 25 Mbps。
- 视频时长:3 至 60 秒,文件最大 100 MB。
- 视频宽高比:0.1:1 至 10:1 之间的任何比例均可接受。
限时动态可以包含什么?
图片或视频本身,以及对其他账户的提及:自 2025 年 7 月起,user_tags 参数可在图片和视频限时动态中标记公开账户,x 和 y 坐标可选。Meta 不支持通过 API 发布贴纸,链接、投票和位置等贴纸只能在应用内添加。
发布后会发生什么?
限时动态将保留 24 小时,然后与应用内一样过期。Meta 将正在显示的限时动态列在单独的 stories 边缘上;账户的媒体列表 GET /<IG_ID>/media 不包含它们。读取时,限时动态的 media_type 为 IMAGE 或 VIDEO,与其他任何媒体相同,因此应通过查找来源而非类型来区分限时动态。
回复和提及如何返回?
以私信的形式返回。对限时动态的回复会通过 messages Webhook 作为私信送达账户,并附带该限时动态的 ID 和 URL,同时开启常规的 24 小时回复时间窗口。当有人在自己的限时动态中提及该账户时,也会以消息形式送达,附件类型为 story_mention。Meta 的 Mentions API 不涵盖限时动态。
限时动态会报告哪些指标?
触达人数、观看次数、分享次数、回复数、关注数、主页访问次数、主页活动、导航、链接点击次数、转发次数及总互动数,均通过媒体洞察端点读取。这些指标仅保留 24 小时,若某项数值低于 5,将返回错误代码 10(观看人数不足),而非具体数字。来自欧洲和日本的回复不计入统计,在这两个地区的账户所创建的限时动态会报告 0 条回复。
常见错误
- 计划添加链接贴纸。API 不发布贴纸,因此链接必须通过其他方式送达用户,例如通过私信回复。
- 次日才读取限时动态指标。这些指标仅保留 24 小时,因此应在限时动态显示期间收集。
- 在账户的媒体列表中查找已发布的限时动态。正在显示的限时动态列在单独的 stories 边缘上。
- 将横屏视频发布为限时动态。Meta 建议使用 9:16,其他比例可能出现空白或被裁剪。
限时动态的回复以私信形式送达,可转发至您的端点,或由自动化功能回复。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费试用。
常见问题
可以通过 API 为限时动态添加链接贴纸吗?
不可以。Meta 不支持通过 API 发布贴纸,包括链接、投票和位置贴纸。提及其他账户(不使用贴纸)则受支持。
API 中在哪里可以找到已发布的限时动态?
在账户单独的 stories 边缘上,前提是限时动态仍在显示。GET /<IG_ID>/media 不包含限时动态,读取时限时动态显示为 IMAGE 或 VIDEO。
限时动态能否通过 API 添加文案?
不。Meta 的参考文档未描述限时动态的文案,publish_instagram_post 发送限时动态时同样不带文案,因此需要传达给观众的文字应放在图片或视频本身之中。
限时动态洞察数据保留多久?
24 小时。Meta 仅在这段时间内提供限时动态指标,因此应在限时动态显示期间读取。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间