API REST

A API REST do Fuxux: chaves de API, os principais endpoints de posts, contas e mídia, webhooks assinados e limites de requisições.

A API REST cobre o que o app web faz com posts: criar, agendar, listar, editar e excluir, enviar mídia, ler contas conectadas e análises, e gerar legendas. A referência interativa está em /reference e o documento OpenAPI em /openapi.json.

Usa Cursor, Claude Code ou outro assistente de programação com o servidor MCP do Context7? Esta documentação está indexada lá: adicione use context7 ao seu prompt ou peça a biblioteca /llmstxt/fuxux_llms_txt (Fuxux no Context7). A referência da API também está indexada, como Fuxux API.

Comparando APIs de publicação? Veja o Fuxux como alternativa ao Ayrshare para preços e para que cada uma foi feita.

URL base e autenticação

https://www.fuxux.com/api

Envie uma chave de API como token bearer. As chaves vêm com todos os planos pagos (Creator, Growth ou Pro), sem custo extra. Crie as chaves na página API keys: elas começam com fx_live_, aparecem uma única vez e valem até você revogar ou trocar. Use uma chave por integração.

curl https://www.fuxux.com/api/accounts \
  -H "Authorization: Bearer fx_live_your_key_here"

Principais endpoints

Método e caminho	O que faz
`GET /api/accounts`	Lista as contas sociais conectadas.
`GET /api/posts`	Lista posts (filtre por status e mês).
`POST /api/posts`	Cria um post: publica agora, agenda ou salva um rascunho.
`GET /api/posts/{id}`	Um post com os resultados por plataforma.
`PATCH /api/posts/{id}`	Edita ou reagenda um rascunho ou post agendado.
`DELETE /api/posts/{id}`	Exclui um post.
`POST /api/media/upload`	Envia uma imagem ou um vídeo para anexar a posts.
`POST /api/ai/generate`	Gera uma legenda para cada plataforma a partir de um prompt.
`GET /api/usage`	Os limites do seu plano e o que você usou neste mês.
`GET /api/analytics`	Análises de publicação.
`GET /api/dashboard`	Resumo: contagens, próximos posts, contas que precisam de atenção.

Criar um post

curl -X POST https://www.fuxux.com/api/posts \
  -H "Authorization: Bearer fx_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "captions": {
      "linkedin": "We just shipped RSS auto-posting: every new blog post now shares itself.",
      "bluesky": "RSS auto-posting is live."
    },
    "scheduled_at": "2026-11-02T09:00:00Z"
  }'

captions associa cada id de plataforma à sua legenda; o post vai para a primeira conta conectada de cada plataforma, ou para as contas que você listar em targets. Deixe scheduled_at de fora para publicar agora, ou envie draft: true para salvar um rascunho. Anexe mídia com media_urls de POST /api/media/upload. Todos os campos estão na referência da API.

Webhooks

Defina um URL de webhook na página API keys para receber um POST quando um post é publicado ou falha. Cada requisição é assinada: o cabeçalho X-Fuxux-Signature é sha256= seguido do HMAC-SHA256 do corpo bruto com o seu segredo de webhook. Confira antes de confiar no conteúdo.

Limites de requisições e erros

120 requisições por minuto por chave, 300 por minuto por conta somando todas as chaves. Uma resposta 429 diz quando tentar de novo.
Os erros retornam JSON com uma mensagem error que explica o que mudar (por exemplo, uma legenda acima do limite de uma rede ou um limite do plano atingido).

Ver em Markdown (em inglês)