AI Agent API

为 AI 智能体
打造的社媒 API

让 OpenClaw、Hermes、n8n、Zapier、Dify 等智能体和自动化工具直接调用 SocialEcho 的发布、分析与监控能力，打通 AI × 社媒的最后一公里。

7
占位接口
3
核心能力域
5
兼容框架
REST
API 协议

兼容主流 Agent 与自动化框架

无论是原生 Agent 框架还是 no-code 工作流，都能直接接入

三大能力域

Agent 可通过统一的 REST API 访问 SocialEcho 的核心业务能力

内容发布 Publishing

单条 / 批量 / 定时发布到 Facebook、Instagram、TikTok 等多平台

  • POST /v1/publish
  • POST /v1/publish/schedule
  • GET /v1/publish/:id

数据分析 Analytics

贴文表现、账号粉丝趋势等多维度数据查询

  • GET /v1/analytics/posts
  • GET /v1/analytics/accounts

舆情监控 Monitoring

创建关键词 / KOL 监控任务并以事件流形式实时消费

  • POST /v1/monitors
  • GET /v1/monitors/:id/events

API 参考

完整的占位端点清单，Agent 开发者可直接拷贝调用

🎁 AI Agent API 目前限时免费开放，下方所有端点均已上线可调用。
POST/v1/publishAuth: Bearer

发布内容到一个或多个社交平台

curl -X POST "https://api.socialecho.net/v1/publish" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"accounts":["fb_123","ig_456"],"text":"Hello from my agent","media":[]}'
Response
{
  "jobId": "pub_abc",
  "status": "queued"
}
POST/v1/publish/scheduleAuth: Bearer

定时发布内容

curl -X POST "https://api.socialecho.net/v1/publish/schedule" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"accounts":["fb_123"],"text":"Scheduled","publishAt":"2026-05-01T10:00:00Z"}'
Response
{
  "jobId": "pub_xyz",
  "status": "scheduled"
}
GET/v1/publish/:idAuth: Bearer

查询某次发布任务的执行状态

curl -X GET "https://api.socialecho.net/v1/publish/:id" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"
Response
{
  "jobId": "pub_abc",
  "status": "completed",
  "results": [
    {
      "account": "fb_123",
      "postId": "fb_9876",
      "url": "https://..."
    }
  ]
}
GET/v1/analytics/postsAuth: Bearer

查询贴文表现指标（曝光、互动、点击等）

curl -X GET "https://api.socialecho.net/v1/analytics/posts?from=2026-04-01&to=2026-04-18&account=fb_123" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"
Response
{
  "items": [
    {
      "postId": "fb_9876",
      "impressions": 12400,
      "engagements": 532
    }
  ]
}
GET/v1/analytics/accountsAuth: Bearer

查询账号维度的粉丝 / 互动趋势

curl -X GET "https://api.socialecho.net/v1/analytics/accounts?account=fb_123&granularity=day" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"
Response
{
  "account": "fb_123",
  "series": [
    {
      "date": "2026-04-17",
      "followers": 48210
    }
  ]
}
POST/v1/monitorsAuth: Bearer

创建关键词 / KOL 监控任务

curl -X POST "https://api.socialecho.net/v1/monitors" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"keyword","value":"socialecho","platforms":["x","reddit"]}'
Response
{
  "monitorId": "mon_123",
  "status": "active"
}
GET/v1/monitors/:id/eventsAuth: Bearer

以事件流形式拉取监控命中结果

curl -X GET "https://api.socialecho.net/v1/monitors/:id/events?since=2026-04-18T00:00:00Z" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"
Response
{
  "events": [
    {
      "id": "evt_1",
      "platform": "x",
      "text": "Love socialecho",
      "author": "@user"
    }
  ]
}

4 步接入 SocialEcho Agent API

和任意 Agent / 自动化框架无缝对接

1

获取 API Key

在定价页购买付费套餐后，进入「系统设置 → 团队信息 → API Key」自助生成专属密钥。

2

认证请求

在 HTTP Header 加入 Authorization: Bearer sk_live_...

3

调用端点

按文档调用 Publish / Analytics / Monitoring 接口

4

接入 Agent 框架

在 OpenClaw / Hermes / n8n / Zapier / Dify 中封装为工具

Agent 与自动化框架集成

从原生 Agent SDK 到 no-code 平台，全链路覆盖

View on GitHub
OpenClaw

OpenClaw

OpenClaw 是我们主推的开源多平台 Agent 框架，内置 SocialEcho 工具包，可直接在 Agent 思考循环中调用发布、查询、监控能力。现已发布于 ClawHub 与 GitHub，欢迎体验。

ClawHub

Hermes

Hermes 是面向企业级 Agent 编排的系统，支持长流程、并发调度、审计留痕。SocialEcho Connector 已作为 Hermes 的一等节点上线，可在多步任务中编排完整内容矩阵。

n8n

n8n

在 n8n 中通过 HTTP Request Node 直接调用 SocialEcho API：把监控事件作为 Trigger、分析结果作为数据源、发布接口作为 Action，即可搭建完整的社媒自动化工作流。

Zapier

Zapier

通过 Zapier 的 Webhook / Custom Action 调用 SocialEcho，让 5000+ Zapier 应用都能触发社媒发布或消费监控事件，真正实现跨系统自动化。

Dify

Dify

Dify 的 Tool 模块支持 OpenAPI 导入，我们同步维护 agents.md 与未来的 OpenAPI Spec。让 LLM 应用在 Dify 中一键拥有 SocialEcho 的社媒执行力。

常见问题

关于 SocialEcho AI Agent API 的常见疑问

什么是 SocialEcho Agent API？

Agent API 是面向 AI 智能体和自动化工具的官方接口，覆盖内容发布、数据分析、舆情监控三大能力域，可被 OpenClaw / Hermes / n8n / Zapier / Dify 等框架直接调用。

如何获取 API Key？

流程完全自助：1) 在定价页购买任意付费套餐；2) 登录后台，进入「系统设置 → 团队信息 → API Key」生成专属密钥；3) 以 Authorization: Bearer <key> 的方式调用接口即可。

兼容哪些 Agent 框架？

原生支持 OpenClaw、Hermes；通过 HTTP / OpenAPI 间接支持 n8n、Zapier、Dify、LangChain、LlamaIndex 等主流框架。

什么时候正式开放？

Agent API 现已开放，目前所有端点在发布预览期间免费调用。后续将陆续补齐控制台体验与定价档位，申请试用可提前锁定功能。

是否支持私有化部署？

当前仅提供 SaaS 服务，暂不支持自托管或私有化部署。如果企业对数据隔离或独立环境有更高要求，欢迎联系我们讨论大客户方案。

AI Agent API

让你的 AI 智能体连上社媒

发布预览期所有端点免费开放，立即开通即可获得完整文档、示例代码与自助 API Key。

自助生成 Bearer Token
完整 Markdown 文档
7 个可调用端点