SocialSchedule API — 编程式社交媒体调度

SocialSchedule API 是一个用于多平台发布的社交媒体调度 API：验证工作区、上传媒体、创建定时帖子、管理队列、接收 Webhook，并提取分析——无需等待企业附加组件。

代码示例

示例保持英文 - 复制到您的终端、MCP客户端或技能文件中。

认证头

Authorization: Bearer ssk_live_xxx
X-Workspace-Id: ws_abc123

创建帖子

curl -X POST https://api.socialschedule.ai/v1/posts \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram", "tiktok"],
    "caption": "New drop is live",
    "mediaIds": ["media_01"],
    "scheduledFor": "2026-04-02T18:00:00Z",
    "utm": {
      "source": "instagram",
      "medium": "social",
      "campaign": "spring-drop"
    }
  }'

上传媒体

curl -X POST https://api.socialschedule.ai/v1/media \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -F "file=@./product.mp4"

创建 webhook

curl -X POST https://api.socialschedule.ai/v1/webhooks \
  -H "Authorization: Bearer $SOCIALSCHEDULE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/hooks/socialschedule",
    "events": ["post.published", "post.failed"]
  }'

CLI MCP Skills

身份验证和工作区

使用作用于工作区的Bearer令牌。传递多租户代理应用程序的工作区标识符。对于开发者和AI代理而言，“身份验证和工作区”不是一个流行语部分——它是一个操作系统：规划支柱，与AI一起草拟，安排在最佳时间窗口，衡量重要的结果。

轮换密钥并优先考虑最小权限。SocialSchedule在一个AI原生日历和队列中连接Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky和Google Business Profile之间的工作流程——而不是2012年风格出版者上的一个附加标题框。保持平台原生格式、审批和分析在同一个循环中。

镜像与Web应用程序相同的权限模型。下面的Curl示例设计上保持英语/技术性。当您准备好时，打开https://app.socialschedule.ai/login以安排直播——或者在与人类保持品牌语音防护的同时，通过CLI、MCP、API和技能自动化相同的步骤。

创建、更新和取消计划的帖子

CRUD 端点涵盖了计划帖子的整个生命周期。幂等性键有助于安全重试。对于开发者和 AI 代理而言，“创建、更新和取消计划的帖子”不是一个流行词汇部分——而是一个操作系统：规划支柱，使用 AI 草拟，安排到最佳窗口，并衡量重要的结果。

当活动延迟时，取消或重新计划。SocialSchedule 通过一个以 AI 为原生的日历和队列（而不是一个2012年风格发布者上的附加标题框），连接 Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky 和 Google 商业资料之间的工作流程。保持平台本地格式、批准和分析在同一个环节中。

明确支持草稿与计划状态。当你准备好时，打开 https://app.socialschedule.ai/login 进行直播安排——或者使用 CLI、MCP、API 和 Skills 自动化相同的步骤，同时让人类保持品牌声音的界限。

概念性 API 模式

使用工作区范围的承载令牌进行身份验证。创建具有平台目标、标题变体、媒体 ID 和调度时间戳的帖子。对重试使用幂等性密钥。

示例格式（说明性）：`POST /v1/posts`，内容为 `{ "platforms": ["instagram","x"], "body": "...", "mediaIds": [...], "scheduledAt": "..." }`。订阅 `post.published` / `post.failed` Webhook 以获取操作警报。

优先选择草稿 → 审批 → 调度以确保品牌安全。在 429 时使用回退限制速率。完整的 OpenAPI 详细信息随您的开发者工作区一起提供。

媒体上传和平台特定负载

上传媒体，然后在发布创建调用中引用媒体 ID。在网络要求的地方附加平台特定字段。对于开发者和 AI 代理，“媒体上传和平台特定负载”不是流行词汇部分——它是一个操作系统：规划支柱，使用 AI 草拟，安排到最佳时段，并衡量重要的结果。

在启动日之前验证长宽比。SocialSchedule 将此工作流程连接跨 Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky 和 Google 商业资料，通过一个 AI 原生日历和队列——而不是一个 2012 风格发布者上的附加标题框。保持平台原生格式、批准和分析在同一循环中。

在适当时在不同平台变种中重复使用媒体。当您准备好时，打开 https://app.socialschedule.ai/login 以安排直播——或者使用 CLI、MCP、API 和技能自动化相同的步骤，同时人类保持品牌声音的守护框架。

日历、队列和最佳时间助手

列出日历窗口并将帖子排入队列以获得最佳发布时间。构建内部工具，显示营销人员所见的相同一周。对于开发人员和AI代理，“日历、队列和最佳时间助手”并不是一个流行词汇的部分——它是一个操作系统：规划支柱，使用AI起草，调度到最佳窗口，并测量重要的结果。

在分析回顾后以编程方式填补空白。SocialSchedule 从一个原生AI日历和队列连接 Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky 和 Google 商业资料之间的工作流程——而不是2012年风格发布者上的追加标题框。保持平台原生格式、审批和分析在同一循环中。

与技能结合进行更高级的规划。当你准备好时，打开 https://app.socialschedule.ai/login 进行实时调度——或使用CLI、MCP、API和技能自动化相同步骤，同时让人类保持品牌声音的守护。

重要的分析端点

获取已安排内容的互动和交付指标。为客户端门户和内部仪表板提供支持。对于开发人员和AI代理，“重要的分析端点”不是一个流行词汇部分——而是一个操作系统：规划支柱、与AI一起草拟、安排到最佳时间段，并衡量重要的结果。

避免在自动邮件中仅进行华丽的数据报告。SocialSchedule通过一个AI原生日历和队列连接这一工作流程，覆盖Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky和Google Business Profile——而不是2012年风格发布者上附加的标题框。保持平台原生格式、审批和分析在同一循环中。

将循环封闭到下周的生成工作。当你准备好时，打开 https://app.socialschedule.ai/login 进行直播安排——或者在人工保持品牌声音管控的同时，通过CLI、MCP、API和技能自动化相同的步骤。

发布/失败事件的 Webhooks

订阅 post.published 和 post.failed 事件。当发布失败时，触发 Slack 警报或工单。对于开发人员和 AI 代理来说，“发布/失败事件的 Webhooks”不是一个流行词汇部分——它是一个操作系统：规划支柱、与 AI 一起草拟、安排在最佳时间段，并衡量重要的结果。

在信任有效负载之前验证签名。SocialSchedule 将这个工作流程连接到 Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky 和 Google 商业资料，从一个 AI 原生的日历和队列中实现——而不是一个 2012 年风格出版者上的附加标题框。保持平台原生的格式、审核和分析在同一个循环中。

保持 webhook 处理程序的幂等性。当你准备好时，打开 https://app.socialschedule.ai/login 安排直播——或者在人类保持品牌语音护栏的同时，通过 CLI、MCP、API 和 Skills 自动化相同步骤。

速率限制、幂等性和最佳实践

遵守速率限制；退回；使用幂等性密钥重试。记录相关ID以便支持。对于开发人员和AI代理，“速率限制、幂等性和最佳实践”不是一个流行词汇部分——它是一种操作系统：规划支柱，使用AI草拟，安排在最佳时间窗口，并衡量重要的结果。

优先选择草拟→批准→安排以确保品牌安全。SocialSchedule通过一个AI原生的日历和队列连接Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky和Google商业资料之间的工作流程，而不是2012年风格发布者上附加的标题框。保持平台原生格式、批准和分析在同一循环中。

记录您内部自动化的操作手册。当您准备好时，打开 https://app.socialschedule.ai/login 进行实时安排—或者使用CLI、MCP、API和Skills自动化相同的步骤，同时让人类保持品牌声音的守护框架。

常见平台的API快速入门

常见的路径包括通过API安排Instagram帖子、LinkedIn公司更新以及多平台发布。从一个平台的集成测试开始，然后扩展。对于开发人员和AI代理来说，“常见平台的API快速入门”不是一个流行用语部分——它是一个操作系统：规划支柱、用AI草拟、在最佳时间段安排，并衡量重要的结果。

代理机构可以在API上构建客户门户。SocialSchedule通过一个AI原生的日历和队列连接Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky和Google Business Profile之间的工作流程——而不是2012样式发布者上的附加标题框。保持平台原生格式、审批和分析在同一个循环中。

对于代理UI，MCP可能会更快；而API在你的后端更胜一筹。在应用程序中创建API密钥，并发布你的第一个安排的帖子。当你准备好时，打开 https://app.socialschedule.ai/login 进行直播安排——或者通过CLI、MCP、API和技能自动化相同的步骤，同时人类保持品牌声音的护栏。

常见问题

SocialSchedule 提供公共 API 吗？+

是的。SocialSchedule API 支持程序化调度、媒体、队列、Webhook 和分析。

我可以通过 API 调度 Instagram 帖子吗？+

可以，对连接到您工作区的 Instagram 帐户有效（需遵循平台政策和权限）。

API 支持哪些平台？+

在连接时，SocialSchedule 支持的平台包括 Instagram、TikTok、X、LinkedIn、Facebook、YouTube、Threads、Pinterest、Bluesky 和 Google Business Profile。

认证是如何工作的？+

使用作用域为工作区的 Bearer API 密钥。将密钥保存在秘密管理器中。

有发布事件的 Webhook 吗？+

有的。订阅已发布和失败事件以进行操作警报。

我可以通过 API 获取分析数据吗？+

可以。提取指标以支持仪表板和自动化循环。

速率限制是怎样的？+

速率限制适用于每个工作区/令牌。对于 429 错误，减慢请求速率，并使用幂等性密钥进行安全重试。

有没有官方 SDK？+

从 REST API 和 curl 示例开始；随着接口的稳定，可能会添加 SDK/社区客户端。

API 和 MCP 服务器有什么区别？+

API 适合您的服务器和产品；MCP 适合需要动态交互的 AI 代理。

代理机构可以在 API 上构建客户门户吗？+

可以。许多代理机构为面向客户的日历和批准包装 API。

我如何上传媒体？+

使用媒体上传端点，然后在创建帖子时引用返回的媒体 ID。

OpenAPI / 参考文档在哪里？+

使用此指南进行快速入门；完整的 OpenAPI 详细信息将与您的开发者工作区文档一起提供。

创建 API 密钥并程序化地安排

通过网络钩子、队列和分析实现多平台发布。

开始免费