Upload-Post API

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

文档

• 完整 API 文档：https://docs.upload-post.com
• 适合大模型使用的格式：https://docs.upload-post.com/llm.txt

设置步骤

1. 在 [upload-post.com](https://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 名称（非用户名），决定内容将被发送至哪些已连接的社交账号。

端点参考

上传视频

curl -X POST "https://api.upload-post.com/api/upload_videos" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F "user=profile_name" \
  -F "platform[]=instagram" \
  -F "platform[]=tiktok" \
  -F "video=@video.mp4" \
  -F "title=我的标题"

关键参数：

• 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[]=@photo1.jpg" \
  -F "photos[]=@photo2.jpg" \
  -F "title=我的标题"

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": "我的文字帖子"
  }'

支持平台：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 "document=@presentation.pdf" \
  -F "title=文档标题" \
  -F "description=文档上方的帖子说明"

参数说明：

• document：支持 PDF、PPT、PPTX、DOC、DOCX（最大 100MB，最多 300 页）
• title：文档标题（必填）
• description：帖子正文说明
• visibility：公开范围（PUBLIC、CONNECTIONS、LOGGED_IN、CONTAINER）
• target_linkedin_page_id：指定发布到公司页面

支持的平台

上传历史记录

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）

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

发布计划

添加 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 页面
curl "https://api.upload-post.com/api/uploadposts/facebook/pages" \
  -H "Authorization: Apikey YOUR_KEY"

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

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

获取 Reddit 帖子详情

获取带有完整媒体信息的 Reddit 帖子（包括图片、图集、视频等）。

# 上传视频🎥、照片📸 和文字🖊️ 到 TikTok、Instagram、YouTube、X、LinkedIn、Facebook、Threads、Pinterest、Reddit 及 Bluesky

通过 Upload-Post API 实现多平台内容发布。

版本：1.0.0
分块：2/2

## 获取带媒体链接的详细帖子列表

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 "file=@input.mp4" \

-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}` 等

配额限制：
- 免费版：每月 30 分钟
- 基础版：每月 300 分钟
- 专业版：每月 1000 分钟
- 高级版：每月 3000 分钟
- 企业版：每月 10000 分钟

## 平台特定参数

详细参数请参阅 [references/platforms.md](references/platforms.md)。

## 媒体要求

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

## 错误代码

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

## 注意事项

- 视频处理时间超过 59 秒时，自动切换为异步模式
- X 平台长文本默认生成线程，如需作为单篇帖子发布，请设置 `x_long_text_as_post=true`
- Facebook 发布需提供 Page ID（Meta 不支持个人账号）
- Instagram 和 Threads 支持混合画廊（图片与视频混合）