用途:一次性把同一份视频、轮播或帖子发布到多个社交平台,也可定时发布或加入发布队列;查询每条帖子或每个平台的分析数据;检查上传是否完成,或只重试失败的平台;还支持 Instagram 评论转私信自动化(关键词触发私信)。
主要能力:认证方式为 Authorization: Apikey $UPLOAD_POST_API_KEY(注意不是 Bearer,用错会返回误导性的 401 Invalid or expired token)。基础地址 https://api.upload-post.com/api。核心端点包括 /upload(视频)、/upload_photos(图片与轮播)、/upload_text(纯文本)、/upload_document(文档,LinkedIn)、/uploadposts/status(异步状态)、/uploadposts/history(上传历史)、/uploadposts/schedule(列出定时帖子,可用 PATCH/DELETE 修改或取消)、/uploadposts/me(校验密钥)、/analytics/<profile>(分析)、以及列出 Facebook 页面、LinkedIn 页面、Pinterest 看板的端点。platform[] 每个目标重复一次;title 对 YouTube 和 Reddit 必填,其他平台可选;可用 <platform>_title 覆盖单平台文案。定时发布需加 scheduled_date(ISO-8601),可选 timezone(IANA)。
使用方式:先在 upload-post.com 注册账号(免费层每月 10 次上传),在仪表板连接社交账号,并设置一个 profile 名称(如 mybrand,用于分组账号,并非社交账号名)。例如发布视频到多个平台:
curl -X POST "https://api.upload-post.com/api/upload"
-H "Authorization: Apikey $UPLOAD_POST_API_KEY"
-F "user=mybrand"
-F "platform[]=tiktok"
-F "platform[]=instagram"
-F "platform[]=youtube"
-F "video=@clip.mp4"
-F "title=How to build better habits"
-F "async_upload=true"
适用场景:跨平台同步发布短视频或轮播、排期内容、统一查看分析、按平台重试失败上传、Instagram 关键词评论转私信。
限制与注意:上传超过 59 秒会自动转为异步,应轮询状态而非当作失败;需提供 UPLOAD_POST_API_KEY 环境变量;YouTube/Reddit 缺 title 会被拒;TikTok 触发 reached_active_user_cap 时会回退为草稿而非直接发布;可发送 Idempotency-Key 避免重复发布;TikTok 可用 post_mode=MEDIA_UPLOAD 存入草稿,first_comment 可自动添加首条评论。完整参数见 docs.upload-post.com。