API pubblica · con l'IA dentro

La API che scrive anche i contenuti

Pubblica sui principali social, sincronizza le analitiche e ricevi eventi in tempo reale con la stessa API del nostro pannello. E quando i contenuti non li porti tu, li genera lei: testi e immagini, un'intera settimana per piano.

La tua app chiede la settimana con una chiamata all'API e PlanVortex prepara il testo, l'immagine e l'orario migliore di ogni post, social per social. Con la seconda chiamata la convalidi e ogni post esce al suo orario. Il video è in inglese.
npm i planvortexIl client ufficiale per Node: tipizzato, con retry e verifica dei webhook. Riferimento →pip install planvortexIl client ufficiale per Python: sincrono e asincrono, tipizzato, la stessa API. Riferimento →npx -y planvortex-mcpIl server MCP ufficiale: il tuo assistente IA pubblica, legge i commenti e risponde ai messaggi. Riferimento →n8n-nodes-planvortexIl nodo verificato per n8n: pubblica, programma e risponde ai commenti da qualsiasi flusso, senza scrivere richieste. Riferimento →

L'API è su tutti e quattro i piani, incluso quello gratuito: 1 app su Free, 2 su Basic, 5 su Pro e 10 su Custom, con un limite di richieste al minuto in base al piano. Nessuna revisione di app da parte tua: i tuoi utenti si collegano con le nostre app approvate di Meta, TikTok e LinkedIn.

Genera i contenuti

Mandi un tema,
ti restituisce la settimana scritta

Mandi un tema (o le tue foto, un articolo o il catalogo reale di un negozio o di un account collegato) e PlanVortex restituisce la settimana divisa per social: i testi scritti, le immagini generate e ogni pubblicazione nel suo slot, come bozze che il tuo prodotto modifica con gli endpoint di pubblicazione di sempre.

piani IA · node
import {
    isAiPlanChange,
    planvortexWebhooks,
} from "planvortex/webhooks";

// 1. Accoda il piano: ricevi il preventivo, non ancora i contenuti
const { ai_plan } = await pv.aiPlans.create(client, org, {
    prompt: "Pane a lievito madre, forno a legna, quartiere",
    accounts: [instagram, linkedin],
    template: "from_images",  // le tue foto: zero crediti immagine
    source: { images },
});

// 2. Un job lo genera e avvisa il tuo webhook_url alla fine
const onChanges = async (changes) => {
    for (const { id_ai_plan } of changes.filter(isAiPlanChange)) {
        const plan = await pv.aiPlans.get(client, org, id_ai_plan);
        // mostra le bozze al tuo utente
    }
};
const receive = planvortexWebhooks({ secret, onChanges });
app.post("/webhooks/planvortex", receive);

// 3. Quando il tuo utente le approva, validare le rende pronte
await pv.aiPlans.validate(client, org, ai_plan._id);
generated· pubblicazioni in bozza, pronte da modificare

Creare un piano non lo genera. Lo restituisce in pending con il suo preventivo e lo genera un job a parte, che può metterci qualche minuto. Quando finisce, il webhook_url della tua app riceve ai_plan_generated o ai_plan_failed, quindi non serve interrogarlo. Senza webhook, o se una consegna va persa (non vengono ritentate), get dice comunque com'è finito il piano. Validare è ciò che porta le bozze allo stato pronto.

Cinque punti di partenza per il piano

Il piano può nascere da un tema, dalle foto che carica il tuo utente, da un articolo incollato o dal suo URL, da un conto alla rovescia verso una data o dal catalogo reale di un negozio WooCommerce o di un account collegato. Le due che non inventano l'immagine costano il 91 % in meno: la stessa settimana sono 519 crediti con immagini generate e 48 con le foto dell'utente.

Il prezzo si sa prima di generare

Il costo lo calcola il server, mai il modello, e la creazione del piano lo restituisce nel preventivo. Se l'indispensabile non rientra nei crediti disponibili, il piano viene rifiutato per intero con l'errore 941 invece di essere generato a metà.

Oppure porta la tua chiave

Configura il tuo provider e il tuo modello per ambito (orchestratore, testo, immagine) e quell'ambito smette di consumare crediti. La chiave viaggia cifrata ed è in sola scrittura: la API restituisce il provider e il modello, mai la chiave.

I crediti IA partono dal piano Basic. Quello gratuito ne ha zero, quindi queste rotte rispondono 941 finché non vengono acquistati.

Autenticazione

Credenziali client, senza sessione utente

Ogni app che crei ha il proprio identificativo e il proprio segreto. Richiedi un token con il flusso client credentials sul nostro endpoint (lo stesso dominio del resto dell'API) e inizi a chiamare: niente cookie, nessun utente di mezzo e nessun rinnovo OAuth rete per rete.

ottenere token
curl -X POST "https://api.planvortex.com/v1.0.0/oauth/token" \
  -d grant_type=client_credentials \
  -d client_id=$APP_CLIENT_ID \
  -d client_secret=$APP_SECRET
200 OK· access_token · expires_in

Il token scade, e la scadenza non arriva come 401 ma come 400 con il codice 501 o 522 nel corpo. Richiedine un altro con la stessa chiamata.

Con la libreria Node questa chiamata non la scrivi: la fa lei, mette il token in cache e lo rinnova prima che scada.

Prima chiamata

Pubblicare in poche righe

Scegli l'account e la rete di destinazione, invii il testo e i file caricati in precedenza, e PlanVortex si occupa del resto. Se aggiungi una data di pubblicazione, il post viene programmato invece di uscire subito. Da Node, la libreria ufficiale porta i tipi e gestisce il token, i tentativi e il multipart.

node
import { PlanVortex } from "planvortex";

const pv = new PlanVortex({ clientId, clientSecret });

const upload = await pv.uploads.create(org, { file: "./pagnotta.jpg" });
const post = await pv.publications.create(org, account, {
    social_network: "instagram",
    text: "Nuovo forno, nuove pagnotte",
    files: [upload._id],
    publish_date: new Date("2026-09-01T10:00:00Z"),
});
Server MCP

Il tuo assistente IA, collegato ai tuoi account

Il server MCP ufficiale mette l'intera API a portata di Claude Desktop, Claude Code, Cursor o VS Code: trentuno strumenti per programmare pubblicazioni, leggere la casella dei commenti, rispondere ai messaggi diretti delle reti che li hanno e chiedere alla nostra IA di scrivere la settimana. Si avvia con le tue credenziali, sulla tua macchina, e chi lo usa non scrive una riga di codice.

Claude Code
claude mcp add planvortex \
  --env PLANVORTEX_CLIENT_ID=... \
  --env PLANVORTEX_CLIENT_SECRET=... \
  -- npx -y planvortex-mcp

Claude Desktop, Cursor e VS Code vogliono lo stesso blocco nel loro file dei server MCP. E se non hai Node, ogni versione pubblica un pacchetto .mcpb che si installa con un doppio clic.

Per ChatGPT e Claude non serve niente di tutto questo: lo stesso server gira ospitato, è nelle loro directory e si collega con il tuo account PlanVortex, senza Node né app.

PlanVortex nella directory di Claude →PlanVortex in ChatGPT →Guida: pubblicare dal tuo assistente IA con MCP →

Trentuno strumenti

Ventidue che leggono e nove che scrivono, più tre prompt e quattro risorse con i limiti e le capacità di ogni rete. Le differenze tra le reti viaggiano come dati, così il modello non deve indovinare che cosa permette ciascuna.

E l'IA, con l'interruttore in mano tua

C'è anche il pianificatore: il tuo assistente legge i modelli con quanto costa ciascuno e ti propone la settimana. Generarla consuma crediti, quindi quello strumento (e solo quello) lo accendi tu con una riga nella configurazione; spento non compare nemmeno nell'elenco. Quello che esce sono bozze: programmarle resta a te.

Non cancella nulla

Nessuno strumento cancella una pubblicazione, un account o un commento, e non è un'impostazione che si possa attivare: il codice non esiste. Il server legge testo scritto da sconosciuti mentre il modello può pubblicare a tuo nome, quindi il caso peggiore possibile deve essere qualcosa che vedi e annulli.

Gira sulla tua macchina

Il client_secret vive nel processo che avvia il tuo client IA, mai su un nostro server. E se preferisci ospitarlo tu, la modalità --http porta il suo Dockerfile, ascolta solo in locale ed esige un token per legarsi a qualsiasi altra cosa.

Per chi è

Per chi è pensata

Pensata per chi sta già costruendo un proprio prodotto e vuole che i social ne facciano parte.

Agenzie

Centralizza la gestione dei clienti nel tuo pannello interno, senza che debbano accedere a PlanVortex.

Piattaforme e SaaS

Aggiungi pubblicazione e analitiche social al tuo prodotto senza costruirle da zero.

Team di prodotto

Collega PlanVortex al tuo stack interno: BI, CRM, automazioni.

Casi d'uso

Casi d'uso

Quello che puoi già automatizzare oggi con la API. Il primo non lo fa nessun'altra API di pubblicazione tra quelle che abbiamo profilato.

Generare i contenuti

Chiedi una settimana di pubblicazioni a partire da un tema, da alcune foto o da un catalogo, e ricevila in bozze che il tuo prodotto modifica prima di pubblicare.

Pubblicare e programmare

Crea, programma e pubblica contenuti sugli account collegati, via codice.

Sincronizzare le analitiche

Porta le metriche di ogni account e pubblicazione nel tuo pannello.

Commenti e messaggi

Leggi la casella dei commenti e le conversazioni degli account collegati, e rispondi dal tuo stesso prodotto.

Webhook in tempo reale

Ricevi eventi immediati quando cambiano account, messaggi o pubblicazioni, senza polling.

Connessione integrata

Lascia che i tuoi utenti colleghino i social senza uscire dal tuo prodotto, con la schermata per scegliere gli account disegnata da te o da noi, come preferisci. Si collegano con le nostre app approvate, così eviti la revisione delle app di Meta, TikTok e LinkedIn.

Come iniziare

Come iniziare

Da zero alla tua prima chiamata autenticata.

  1. Crea un'app

    Dal tuo pannello cliente, dai un nome alla tua app e attivala. Su tutti i piani, anche quello gratuito.

  2. Ottieni le credenziali

    Un identificativo client e un segreto, che puoi ruotare quando vuoi dal pannello.

  3. Autenticati

    Richiedi il tuo token di accesso con il flusso client-credentials. Con la libreria Node non devi nemmeno farlo.

  4. Esplora la API

    Consulta la documentazione interattiva e verifica ogni endpoint disponibile.

Riferimento

Gli endpoint che userai il primo giorno

Partono tutti dalla stessa base e si autenticano con l'header Authorization: Bearer. Il riferimento completo, con ogni parametro e le risposte di esempio, è nella documentazione.

URL basehttps://api.planvortex.com/v1.0.0

L'OpenAPI completo, per generare il tuo client →
MetodoEndpointA cosa serve
POST/clients/{id_client}/appsCreare un'app all'interno del tuo account cliente.
GET/clients/{id_client}/apps/{id_app}/secretConsultare il segreto dell'app per poterti autenticare.
GET/organizations/{id_organization}/accountsElencare gli account collegati di un'organizzazione e il loro stato.
GET/organizations/{id_organization}/connect_linksGenerare i link con cui il tuo utente collega le sue reti senza uscire dal tuo prodotto.
POST/organizations/{id_organization}/uploadsCaricare l'immagine o il video prima di pubblicarlo.
POST/organizations/{id_organization}/accounts/{id_account}/publishPubblicare o programmare su un account specifico.
GET/organizations/{id_organization}/publishConsultare le pubblicazioni dell'organizzazione e in che stato si trovano.
GET/organizations/{id_organization}/publish/{id_publication}/metricsMetriche di una pubblicazione specifica.
GET/organizations/{id_organization}/accounts/{id_account}/metricsMetriche dell'account.
GET/organizations/{id_organization}/limitsConsumo e limiti del piano in quel momento.
Webhook

Eventi che ti inviamo

Imposti un URL nella tua app e PlanVortex ci fa una POST quando succede qualcosa sugli account collegati. Ogni invio è firmato con il segreto dell'app, così puoi verificare che arrivi davvero da noi.

new_account

Un utente ha appena collegato un nuovo account.

change_state_account

Lo stato di un account è cambiato: è stato ricollegato, il token è scaduto o non è più disponibile.

messages

È arrivato un messaggio diretto su un account collegato.

comments

Qualcuno ha commentato un tuo post o ha lasciato una recensione sulla tua scheda Google.

Versionamento

La versione fa parte del percorso. Finché resta lì, quello che oggi ti funziona continuerà a funzionare allo stesso modo.

Firma dei webhook

Ogni POST porta gli header x-hub-signature e x-hub-signature-256, calcolati con il segreto della tua app. Verificali prima di elaborare il corpo.

Documentazione interattiva

Riferimento OpenAPI per aree (account, pubblicazioni, caricamenti, organizzazioni, ruoli e piani di IA) con ogni parametro e la sua risposta di esempio.

Fattura in euro, società spagnola

I prezzi sono in euro e la fattura è emessa da una società spagnola. Le imposte si calcolano al pagamento in base al tuo paese; se sei un'azienda dell'UE con partita IVA valida si applica l'inversione contabile. Il servizio gira su server propri nell'UE e il contratto di responsabile del trattamento si scarica senza moduli.

Vedi affidabilità e protezione dei dati
Documentazione

Tutta la API, documentata

Ogni endpoint con i suoi parametri, le risposte di esempio e la richiesta pronta da copiare in cURL, JavaScript e Python. Si consulta per intero senza creare un account.