AI Agent API

The Social Media API
Built for AI Agents

Let OpenClaw, Hermes, n8n, Zapier, Dify and other agent frameworks call SocialEcho's publishing, analytics and monitoring capabilities directly — closing the last mile between AI and social media.

7
endpoints
3
capability domains
5
frameworks
REST
API protocol

Compatible with Leading Agent & Automation Frameworks

From native agent SDKs to no-code workflows — plug straight in

Three Capability Domains

Agents access SocialEcho's core business capabilities via one unified REST API

Publishing

Single, batch, and scheduled posts across Facebook, Instagram, TikTok and more

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

Analytics

Multi-dimensional queries for post performance and account follower trends

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

Monitoring

Create keyword / KOL monitors and consume hits as an event stream

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

API Reference

Full placeholder endpoint catalogue — copy & call directly from your agent

🎁 The AI Agent API is currently free during the launch preview — all endpoints listed below are live and callable.
POST/v1/publishAuth: Bearer

Publish content to one or more social accounts

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

Schedule a publish job for a future time

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

Get status of a publish job

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

Query post performance metrics (impressions, engagement, clicks)

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

Query follower / engagement trends at the account level

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

Create a keyword or KOL monitoring task

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

Stream matched events for a given monitor

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 Steps to Integrate the SocialEcho Agent API

Wire it into any agent or automation framework in minutes

1

Get an API Key

Purchase a paid plan on the Pricing page, then go to System Settings → Team Info → API Key in the dashboard to generate your key.

2

Authenticate Requests

Add Authorization: Bearer sk_live_... to your HTTP headers

3

Call the Endpoints

Invoke Publish / Analytics / Monitoring APIs per the docs

4

Embed in Your Agent

Wrap as a tool in OpenClaw / Hermes / n8n / Zapier / Dify

Agent & Automation Framework Integrations

From native agent SDKs to no-code platforms — full coverage

View on GitHub
OpenClaw

OpenClaw

OpenClaw is our flagship open-source multi-platform agent framework. It ships a built-in SocialEcho toolkit so agents can call publishing, analytics and monitoring directly inside their reasoning loop. Available now on ClawHub and GitHub.

ClawHub

Hermes

Hermes is an enterprise-grade agent orchestration system with long-running flows, concurrent scheduling and audit trails. The SocialEcho Connector is live as a first-class Hermes node for orchestrating full content matrices.

n8n

n8n

Use n8n's HTTP Request node to call SocialEcho directly: monitoring events as triggers, analytics as a data source, publishing as an action. Build a full social automation workflow in minutes.

Zapier

Zapier

Bridge SocialEcho into Zapier's 5000+ app ecosystem via Webhook / Custom Action — any tool can now trigger social posts or consume monitoring events.

Dify

Dify

Dify's Tool module supports OpenAPI import, and we maintain agents.md plus a forthcoming OpenAPI spec. Give any Dify-built LLM app instant social-media execution power.

Frequently Asked Questions

Common questions about the SocialEcho AI Agent API

What is the SocialEcho Agent API?

An official API built for AI agents and automation tools, covering publishing, analytics and monitoring — callable directly from OpenClaw, Hermes, n8n, Zapier and Dify.

How do I get an API key?

Fully self-serve: 1) purchase any paid plan on the Pricing page; 2) sign in to the dashboard and go to System Settings → Team Info → API Key to generate your key; 3) call the API with Authorization: Bearer <key>.

Which agent frameworks are supported?

Native support for OpenClaw and Hermes; indirect support for n8n, Zapier, Dify, LangChain, LlamaIndex and any HTTP/OpenAPI-compatible framework.

Is the API available today?

Yes — all endpoints are live and free to call during the launch preview. Console UX and pricing tiers will firm up over time; starting now locks in the flow.

Do you support self-hosting?

SocialEcho is SaaS only — we do not offer self-hosted or on-prem deployments at this time. If your organisation needs stronger isolation, reach out and we can discuss enterprise options.

AI Agent API

Connect Your AI Agent to Social Media

All endpoints are free to call during the launch preview. Pick a plan, generate your API key from the dashboard, and start shipping.

Self-serve Bearer Token
Full Markdown Docs
7 Live Endpoints