AI Agent API

A API de Redes Sociais
Feita para Agentes de IA

Deixe OpenClaw, Hermes, n8n, Zapier, Dify e outros frameworks de agentes chamarem diretamente os recursos de publicação, análise e monitoramento do SocialEcho — fechando a última milha entre a IA e as redes sociais.

7
endpoints
3
domínios de capacidade
5
frameworks
REST
protocolo da API

Três Domínios de Capacidade

Os agentes acessam os recursos de negócio centrais do SocialEcho por uma única API REST unificada

Publicação

Publicações individuais, em lote e agendadas no Facebook, Instagram, TikTok e mais

  • POST /v1/publish/article
  • GET /v1/pinterest/boards
  • GET /v1/reddit/communities

Análise

Consultas multidimensionais de desempenho das publicações e de tendências de seguidores das contas

  • GET /v1/article
  • GET /v1/report

Monitoramento

Crie monitores de palavras-chave / KOL e consuma os resultados como um fluxo de eventos

  • Em breve

Referência da API

Catálogo completo de endpoints de exemplo — copie e chame direto do seu agente

🎁 A AI Agent API está gratuita durante o preview de lançamento — todos os endpoints listados abaixo estão ativos e podem ser chamados.
POST/v1/publishAuth: Bearer

Publique conteúdo em uma ou mais contas sociais

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":"Olá do meu agente","media":[]}'
Response
{
  "jobId": "pub_abc",
  "status": "queued"
}
POST/v1/publish/scheduleAuth: Bearer

Agende um job de publicação para um horário futuro

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":"Agendado","publishAt":"2026-05-01T10:00:00Z"}'
Response
{
  "jobId": "pub_xyz",
  "status": "scheduled"
}
GET/v1/publish/:idAuth: Bearer

Consulte o status de um job de publicação

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

Consulte as métricas de desempenho das publicações (impressões, engajamento, cliques)

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

Consulte tendências de seguidores / engajamento no nível da conta

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

Crie uma tarefa de monitoramento de palavra-chave ou 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

Receba em stream os eventos correspondentes a um 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 Passos para Integrar a Agent API do SocialEcho

Conecte a qualquer framework de agentes ou automação em minutos

1

Obtenha uma API Key

Assine um plano pago na página de Preços e, no painel, vá em Configurações do Sistema → Informações do Time → API Key para gerar sua chave.

2

Autentique as Requisições

Adicione Authorization: Bearer sk_live_... aos cabeçalhos HTTP

3

Chame os Endpoints

Invoque as APIs de Publicação / Análise / Monitoramento conforme a documentação

4

Incorpore ao Seu Agente

Empacote como uma tool no OpenClaw / Hermes / n8n / Zapier / Dify

Integrações com Frameworks de Agentes e Automação

De SDKs nativos de agentes a plataformas no-code — cobertura completa

OpenClaw

OpenClaw

O OpenClaw é o nosso principal framework de agentes open-source e multiplataforma. Ele já vem com um toolkit do SocialEcho integrado, para que os agentes chamem publicação, análise e monitoramento direto no ciclo de raciocínio. Disponível agora no ClawHub e no GitHub.

Hermes

O Hermes é um sistema de orquestração de agentes de nível empresarial, com fluxos de longa duração, agendamento concorrente e trilhas de auditoria. O SocialEcho Connector já está no ar como um node nativo do Hermes para orquestrar matrizes de conteúdo completas.

n8n

n8n

Use o node HTTP Request do n8n para chamar o SocialEcho diretamente: eventos de monitoramento como gatilhos, análise como fonte de dados e publicação como ação. Monte um fluxo completo de automação social em minutos.

Zapier

Zapier

Leve o SocialEcho para o ecossistema de mais de 5.000 apps do Zapier via Webhook / Custom Action — agora qualquer ferramenta pode disparar publicações sociais ou consumir eventos de monitoramento.

Dify

Dify

O módulo Tool do Dify suporta importação de OpenAPI, e mantemos o agents.md além de uma especificação OpenAPI a caminho. Dê a qualquer app de LLM criado no Dify poder de execução imediato nas redes sociais.

Perguntas Frequentes

Dúvidas comuns sobre a AI Agent API do SocialEcho

O que é a Agent API do SocialEcho?

Uma API oficial feita para agentes de IA e ferramentas de automação, cobrindo publicação, análise e monitoramento — pode ser chamada diretamente do OpenClaw, Hermes, n8n, Zapier e Dify.

Como consigo uma API key?

É totalmente self-service: 1) assine qualquer plano pago na página de Preços; 2) entre no painel e vá em Configurações do Sistema → Informações do Time → API Key para gerar sua chave; 3) chame a API com Authorization: Bearer <key>.

Quais frameworks de agentes são suportados?

Suporte nativo a OpenClaw e Hermes; suporte indireto a n8n, Zapier, Dify, LangChain, LlamaIndex e qualquer framework compatível com HTTP/OpenAPI.

A API já está disponível hoje?

Sim — todos os endpoints estão no ar e são gratuitos para chamada durante o preview de lançamento. A experiência do console e as faixas de preço vão se consolidar com o tempo; começar agora garante o fluxo desde já.

Vocês suportam self-hosting?

O SocialEcho é apenas SaaS — no momento não oferecemos implantação self-hosted ou on-premise. Se a sua organização precisa de um isolamento maior, fale com a gente para discutirmos opções corporativas.

AI Agent API

Conecte Seu Agente de IA às Redes Sociais

Todos os endpoints são gratuitos para chamada durante o preview de lançamento. Escolha um plano, gere sua API key no painel e comece a construir.

Bearer Token self-service
Documentação completa em Markdown
7 endpoints ativos