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 應用一鍵擁有 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 個可調用端點