Ir para o conteúdo

Publique a partir do seu próprio código ou do seu agente de IA.

Crie e agende publicações, envie mídia, veja análises e use a IA a partir do seu próprio código, ou dê a um agente de IA as ferramentas para fazer isso por você. Comece com uma chave para um espaço de trabalho e só as permissões de que ela precisa.

Tudo o que você publica, seu código pode publicar.

A API segue as mesmas regras e a mesma validação do app: uma publicação que passa em um passa no outro.

  • Chaves com escopos

    Uma chave é criada para um espaço de trabalho e um conjunto de permissões. Uma chave só de leitura não publica, e cada chamada tem limite de requisições e fica registrada.

  • Um documento OpenAPI

    Publicações, envio de arquivos, filas, contas sociais, análises e IA: escrever uma legenda, gerar uma imagem, sugerir e definir o texto alternativo. Toda a superfície está descrita em uma especificação a partir da qual você pode gerar um cliente.

  • Webhooks assinados

    Treze eventos, de post.published a connection.revoked. Cada entrega é assinada, repetida quando falha e pode ser reenviada pelo app.

  • MCP para agentes

    Conecte o seu agente de IA com um URL. Os agentes encontram publicações e mídia pelo nome, escrevem rascunhos, agendam e consultam resultados, e o SPREVA pergunta antes de qualquer coisa pública ou com custo. Os agentes nunca veem um token da rede.

120 / minuto
Por pessoa em um espaço de trabalho, com a espera indicada no erro.
10 segundos
Para responder a um webhook antes de ele ser repetido.
Criar uma publicação para duas contas
curl -X POST https://app.spreva.ai/api/v1/posts \
  -H "Authorization: Bearer spreva_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "caption": "Ship day. New build is live.",
      "mediaIds": ["c47e2a90-0000-4000-8000-000000000004"]
    },
    "targets": [
      { "connectionId": "e81b3f52-...-005", "placement": "feed" },
      { "connectionId": "a31d9f07-...-006", "placement": "reel",
        "override": { "caption": "Ship day. Full notes in bio." } }
    ]
  }'
Dar uma data para ela
curl -X POST https://app.spreva.ai/api/v1/posts/$POST_ID/schedule \
  -H "Authorization: Bearer spreva_sk_..." \
  -d '{ "scheduledAt": "2026-10-01T09:00:00.000Z",
        "timezone": "Europe/Lisbon" }'
Ser avisado quando ela chega
POST /hooks/spreva HTTP/1.1
x-spreva-event: target.published
x-spreva-event-id: 7f3c2d10-0000-4000-8000-000000000000
x-spreva-timestamp: 1790845202
x-spreva-signature: v1=6f1c…             # HMAC-SHA256 of "timestamp.body"

{
  "id": "7f3c2d10-0000-4000-8000-000000000000",
  "type": "target.published",
  "createdAt": "2026-10-01T09:00:02.412Z",
  "workspaceId": "0b9f6c1e-0000-4000-8000-000000000001",
  "data": {
    "type": "TargetPublished",
    "workspaceId": "0b9f6c1e-0000-4000-8000-000000000001",
    "postId": "5d2a7c3e-0000-4000-8000-000000000002",
    "targetId": "9a1f4b7d-0000-4000-8000-000000000003",
    "provider": "instagram",
    "remoteId": "17900000000000000",
    "remoteUrl": "https://www.instagram.com/p/EXAMPLE/"
  }
}

Da sua próxima ideia a um vídeo publicado.