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密钥在API调用中，使用配置文件名称作为
5. 用户参数认证

基础URL：

Authorization: Apikey YOUR_API_KEY

https://api.upload-post.com/api该

The用户所有端点中的参数均指您的档案名称（非用户名），它决定了哪些已关联的社交媒体账户会接收到内容。

端点参考

端点	方法	描述
/upload_videos	POST	上传视频
/upload_photos	POST	上传照片/轮播图
/upload_text	POST	纯文本帖子
/upload_document	POST	上传文档（仅限LinkedIn）
/uploadposts/status?request_id=X	GET	检查异步上传状态
/uploadposts/history	获取	上传历史
/uploadposts/schedule	获取	列出已排期的帖子
/uploadposts/schedule/<job_id>	删除	取消已排期的帖子
/uploadposts/schedule/<job_id>	修补	编辑已排期的帖子
/uploadposts/me	获取	验证API密钥
/analytics/<profile>	获取	获取分析数据
/uploadposts/facebook/pages	获取	列出Facebook页面
/uploadposts/linkedin/pages	获取	列出LinkedIn页面
/uploadposts/pinterest/boards	获取	列出Pinterest画板
/uploadposts/reddit/detailed-posts	GET	获取带媒体的Reddit帖子
/ffmpeg	POST	使用FFmpeg处理媒体

上传视频

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：发布到公司主页

支持的平台

平台	视频	照片	文本	文档
TikTok	✓	✓	-	-
Instagram	✓	✓	-	-
YouTube	✓	-	-	-
LinkedIn	✓	✓	✓	✓
Facebook	✓	✓	✓	-
X（推特）	✓	✓	✓	-
Threads	✓	✓	✓	-
Pinterest	✓	✓	-	-
Reddit	-	✓	✓	-
Bluesky	✓	✓	✓	-

上传历史

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

参数：

• 页码: 页码（默认值：1）
• 每页条数限制: 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 "file=@input.mp4" \
  -F "full_command=ffmpeg -y -i {input} -c:v libx264 -crf 23 {output}" \
  -F "output_extension=mp4"

• 使用{input}和{output}占位符
• 轮询作业状态直至完成
• 从/ffmpeg/job/<job_id>/download
• 下载结果支持多个输入：{input0}、{input1}

额度：免费版 30分钟/月，基础版 300分钟，专业版 1000分钟，高级版 3000分钟，企业版 10000分钟。

平台特定参数

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

媒体要求

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

错误代码

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

备注

• 视频处理时间若超过59秒，将自动转为异步处理
• X长文本会创建主题帖，除非x_long_text_as_post=true
• Facebook需要页面ID（Meta不支持个人资料）
• Instagram/Threads支持混合轮播（照片+视频）

部分文章来自各大搜索引擎，如有侵权，请与我联系删除。