API REST

L'API REST di Fuxux: chiavi API, gli endpoint principali per post, account e media, webhook firmati e limiti di richieste.

L'API REST copre quello che l'app web fa con i post: crearli, programmarli, elencarli, modificarli ed eliminarli, caricare media, leggere gli account collegati e le analisi, e generare testi. Il riferimento interattivo è su /reference e il documento OpenAPI su /openapi.json.

Usi Cursor, Claude Code o un altro assistente di programmazione con il server MCP di Context7? Questa documentazione è indicizzata lì: aggiungi use context7 al tuo prompt o chiedi la libreria /llmstxt/fuxux_llms_txt (Fuxux su Context7). Anche il riferimento dell'API è indicizzato, come Fuxux API.

Stai confrontando API di pubblicazione? Vedi Fuxux come alternativa ad Ayrshare per i prezzi e per cosa è pensata ciascuna.

URL di base e autenticazione

https://www.fuxux.com/api

Invia una chiave API come token bearer. Le chiavi sono incluse in tutti i piani a pagamento (Creator, Growth o Pro), senza costi aggiuntivi. Creale nella pagina API keys: iniziano con fx_live_, vengono mostrate una sola volta e restano valide finché non le revochi o le ruoti. Usa una chiave per ogni integrazione.

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

Endpoint principali

Metodo e percorso	Cosa fa
`GET /api/accounts`	Elenca gli account social collegati.
`GET /api/posts`	Elenca i post (filtra per stato e mese).
`POST /api/posts`	Crea un post: pubblica subito, programma o salva una bozza.
`GET /api/posts/{id}`	Un post con i risultati per piattaforma.
`PATCH /api/posts/{id}`	Modifica o riprogramma una bozza o un post programmato.
`DELETE /api/posts/{id}`	Elimina un post.
`POST /api/media/upload`	Carica un'immagine o un video da allegare ai post.
`POST /api/ai/generate`	Genera un testo per ogni piattaforma a partire da un prompt.
`GET /api/usage`	I limiti del tuo piano e quanto hai usato questo mese.
`GET /api/analytics`	Analisi delle pubblicazioni.
`GET /api/dashboard`	Riepilogo: conteggi, prossimi post, account che richiedono attenzione.

Creare un 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 a ogni id di piattaforma il suo testo; il post va al primo account collegato di ogni piattaforma, oppure agli account che indichi in targets. Ometti scheduled_at per pubblicare subito, oppure invia draft: true per salvare una bozza. Allega i media con media_urls ottenuti da POST /api/media/upload. Tutti i campi sono nel riferimento dell'API.

Webhook

Imposta un URL di webhook nella pagina API keys per ricevere un POST quando un post viene pubblicato o non riesce. Ogni richiesta è firmata: l'header X-Fuxux-Signature è sha256= seguito dall'HMAC-SHA256 del body grezzo con il tuo secret del webhook. Verificalo prima di fidarti del contenuto.

Limiti di richieste ed errori

120 richieste al minuto per chiave, 300 al minuto per account sommando tutte le chiavi. Una risposta 429 indica quando riprovare.
Gli errori restituiscono JSON con un messaggio error che spiega cosa cambiare (ad esempio un testo oltre il limite di una rete o un limite del piano raggiunto).

Visualizza in Markdown (in inglese)