名称： upload-post
描述： "通过 Upload-Post API 向社交媒体平台发布内容。适用于向 TikTok、Instagram、YouTube、LinkedIn、Facebook、X (Twitter)、Threads、Pinterest、Reddit 或 Bluesky 发布视频、照片、文本或文档。支持定时发布、数据分析、FFmpeg 处理和上传历史记录。"

Upload-Post API

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

文档

• 完整 API 文档：https://docs.upload-post.com
• 面向 LLM 的文档：https://docs.upload-post.com/llm.txt

设置步骤

1. 在 upload-post.com 创建账户
2. 关联您的社交媒体账户
3. 创建一个配置文件（例如 "mybrand"）—— 此文件将链接您已关联的账户
4. 从仪表板生成一个 API 密钥
5. 在 API 调用中，将配置文件名称用作 user 参数

身份验证

Authorization: Apikey YOUR_API_KEY

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

所有端点中的 user 参数指的是您的配置文件名称（而非用户名），它决定了哪些已关联的社交账户将接收内容。

端点参考

上传视频

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=My caption"

关键参数：
- user：配置文件名称（必需）
- 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=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 "document=@presentation.pdf" \
  -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：发布到公司页面

支持平台

上传历史记录

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 页面
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 详细帖子

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

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/requirements.md。

错误代码

注意事项

• 视频处理时间超过 59 秒时，会自动切换到异步模式
• X 长文本会创建串连帖子，除非设置 x_long_text_as_post=true
• Facebook 需要页面 ID（Meta 不支持个人资料）
• Instagram/Threads 支持混合轮播图（照片 + 视频）