upload-post

Upload-Post API

通过一次 API 调用将内容发布到多个社交媒体平台。

文档

• 完整 API 文档：https://docs.upload-post.com
• 适用于大模型：https://docs.upload-post.com/llm.txt

设置

1. 在 upload-post.com 创建账户
2. 连接你的社交媒体账户
3. 创建一个 Profile（例如 “mybrand”）——它关联你已连接的账户
4. 从控制面板生成一个 API Key
5. 在 API 调用中将 Profile 名称用作 user 参数

身份验证

Authorization: Apikey YOUR_API_KEY

基础 URL：https://api.upload-post.com/api

所有端点中的 user 参数指的是你的 Profile 名称（而非用户名），它决定哪些已连接的社交媒体账户会收到内容。

端点参考

端点	方法	描述
/upload	POST	上传视频
/upload_photos	POST	上传照片／轮播内容
/upload_text	POST	发布纯文本内容
/upload_document	POST	上传文档（仅限 LinkedIn）
/uploadposts/status?request_id=X	GET	查看异步上传状态
/uploadposts/history	GET	上传历史记录
/uploadposts/schedule	GET	列出已安排的帖子
/uploadposts/schedule/<job_id>	DELETE	取消已安排的帖子
/uploadposts/schedule/<job_id>	PATCH	编辑已安排的帖子
/uploadposts/me	GET	验证 API Key
/analytics/<profile>	GET	获取分析数据
/uploadposts/facebook/pages	GET	列出 Facebook 专页
/uploadposts/linkedin/pages	GET	列出 LinkedIn 专页
/uploadposts/pinterest/boards	GET	列出 Pinterest 画板
/uploadposts/reddit/detailed-posts	GET	获取包含媒体的 Reddit 帖子
/ffmpeg	POST	使用 FFmpeg 处理媒体

上传视频

curl -X POST "https://api.upload-post.com/api/upload" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F "user=profile_name" \
  -F "platform[]=instagram" \
  -F "platform[]=tiktok" \
  -F "[email protected]" \
  -F "title=My caption"

关键参数：

• user：Profile 用户名（必填）
• platform[]：目标平台（必填）
• video：视频文件或 URL（必填）
• title：说明文字／标题（必填）
• description：扩展说明
• scheduled_date：用于安排发布时间的 ISO-8601 日期
• timezone：IANA 时区（例如 “Europe/Madrid”）
• async_upload：设为 true 以在后台处理
• first_comment：自动发布第一条评论

上传照片

curl -X POST "https://api.upload-post.com/api/upload_photos" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F "user=profile_name" \
  -F "platform[]=instagram" \
  -F "photos[][email protected]" \
  -F "photos[][email protected]" \
  -F "title=My caption"

Instagram 和 Threads 支持混合轮播内容（在同一条帖子中包含照片和视频）。

发布文本

curl -X POST "https://api.upload-post.com/api/upload_text" \
  -H "Authorization: Apikey YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user": "profile_name",
    "platform": ["x", "threads", "bluesky"],
    "title": "My text post"
  }'

支持的平台：X、LinkedIn、Facebook、Threads、Reddit、Bluesky。

上传文档（仅限 LinkedIn）

将 PDF、PPT、DOC 上传为原生 LinkedIn 文档帖子（轮播查看器）。

curl -X POST "https://api.upload-post.com/api/upload_document" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F "user=profile_name" \
  -F 'platform[]=linkedin' \
  -F "[email protected]" \
  -F "title=Document Title" \
  -F "description=Post text above document"

参数：

• document：PDF、PPT、PPTX、DOC、DOCX（最大 100MB、300 页）
• title：文档标题（必填）
• description：帖子说明
• visibility：PUBLIC、CONNECTIONS、LOGGED_IN、CONTAINER
• target_linkedin_page_id：发布到公司专页

支持的平台

平台	视频	照片	文本	文档
TikTok	✓	✓	-	-
Instagram	✓	✓	-	-
YouTube	✓	-	-	-
LinkedIn	✓	✓	✓	✓
Facebook	✓	✓	✓	-
X (Twitter)	✓	✓	✓	-
Threads	✓	✓	✓	-
Pinterest	✓	✓	-	-
Reddit	-	✓	✓	-
Bluesky	✓	✓	✓	-

上传历史记录

curl "https://api.upload-post.com/api/uploadposts/history?page=1&limit=20" \
  -H "Authorization: Apikey YOUR_KEY"

参数：

• page：页码（默认值：1）
• limit：10、20、50 或 100（默认值：10）

返回内容：上传时间戳、平台、成功状态、帖子 URL、错误信息。

安排发布时间

添加 scheduled_date 参数（ISO-8601）：

{
  "scheduled_date": "2026-02-01T10:00:00Z",
  "timezone": "Europe/Madrid"
}

响应中包含 job_id。可通过以下方式管理：

• GET /uploadposts/schedule - 列出所有已安排的帖子
• DELETE /uploadposts/schedule/<job_id> - 取消
• PATCH /uploadposts/schedule/<job_id> - 编辑（日期、标题、说明文字）

查看上传状态

适用于异步上传或已安排的帖子：

curl "https://api.upload-post.com/api/uploadposts/status?request_id=XXX" \
  -H "Authorization: Apikey YOUR_KEY"

也可以使用 job_id 查询已安排的帖子。

分析数据

curl "https://api.upload-post.com/api/analytics/profile_name?platforms=instagram,tiktok" \
  -H "Authorization: Apikey YOUR_KEY"

支持的平台：Instagram、TikTok、LinkedIn、Facebook、X、YouTube、Threads、Pinterest、Reddit、Bluesky。

返回内容：关注者、展示次数、触达人数、个人资料浏览量、时间序列数据。

获取专页／画板

# Facebook Pages
curl "https://api.upload-post.com/api/uploadposts/facebook/pages" \
  -H "Authorization: Apikey YOUR_KEY"

# LinkedIn Pages  
curl "https://api.upload-post.com/api/uploadposts/linkedin/pages" \
  -H "Authorization: Apikey YOUR_KEY"

# Pinterest Boards
curl "https://api.upload-post.com/api/uploadposts/pinterest/boards" \
  -H "Authorization: Apikey YOUR_KEY"

Reddit 详细帖子

获取包含完整媒体信息（图片、图集、视频）的帖子：

curl "https://api.upload-post.com/api/uploadposts/reddit/detailed-posts?profile_username=myprofile" \
  -H "Authorization: Apikey YOUR_KEY"

最多返回 2000 条帖子，包含媒体 URL、尺寸和缩略图。

FFmpeg 编辑器

使用自定义 FFmpeg 命令处理媒体：

curl -X POST "https://api.upload-post.com/api/ffmpeg" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F "[email protected]" \
  -F "full_command=ffmpeg -y -i {input} -c:v libx264 -crf 23 {output}" \
  -F "output_extension=mp4"

• 使用 {input} 和 {output} 占位符
• 轮询任务状态，直到变为 FINISHED
• 从 /ffmpeg/job/<job_id>/download 下载结果
• 支持多个输入：{input0}、{input1} 等

配额：Free 每月 30 分钟，Basic 300 分钟，Pro 1000 分钟，Advanced 3000 分钟，Business 10000 分钟。

平台专属参数

详细的平台参数请参阅 references/platforms.md。

媒体要求

各平台的格式规范请参阅 references/requirements.md。

错误代码

代码	含义
400	请求错误 / 缺少参数
401	API 密钥无效
404	未找到资源
429	超出速率限制 / 配额
500	服务器错误

备注

• 如果视频处理时间超过 59 秒，则会自动切换为异步处理
• 除非设置 x_long_text_as_post=true，否则 X 的长文本会创建为串帖
• Facebook 需要 Page ID（Meta 不支持个人主页）
• Instagram/Threads 支持混合轮播（照片 + 视频）